鸿蒙端云一体签到案例拆解:ArkTS 侧最容易返工的 3 个点

举报
yd_236978410 发表于 2026/11/10 09:00:44 2026/11/10
【摘要】 一、先看结构再动手鸿蒙开发实践中心的「员工签到 App」案例,仓库在 harmony-practice-center/check-in,README 给了三层结构:entry 是 ArkTS 页面层(pages/Index.ets 是签到主界面)、common 用 @kit.NetworkKit 统一封装请求、server 是 Node.js + Express + MySQL 的后端。我...

一、先看结构再动手

鸿蒙开发实践中心的「员工签到 App」案例,仓库在 harmony-practice-center/check-in,README 给了三层结构:entry 是 ArkTS 页面层(pages/Index.ets 是签到主界面)、common 用 @kit.NetworkKit 统一封装请求、server 是 Node.js + Express + MySQL 的后端。

我的环境:DevEco Studio 5.0.3.900,SDK API 12,ohpm 1.5.0,模拟器 HarmonyOS NEXT 5.0.0。

二、三个最容易返工的点

1. http 请求的 destroy 时机

http.createHttp() 建立的会话必须在 complete 回调里销毁,提前 destroy 会让你在真机上看到 Cannot read property 'result' of undefined。另外模拟器没配代理时,第一次请求必定报 BusinessError 2300007: Couldn't resolve host name,先把 server 里 app.listen(3000) 换成本机局域网 IP 再测。

2. 签到状态该放 AppStorage,不是 @State

@State 只在当前组件内生效,从签到页返回列表页时状态会被重建。案例里用 AppStorage.setOrCreate('signedToday', true) 配合 @StorageLink 才跨页面同步。这一点在官方文档里分散在「状态管理」和「应用级变量」两页,不跑一遍根本想不到。

3. 服务端时间戳在 ArkTS 里会解析成 Invalid Date

MySQL 返回的 created_at 是 2026-11-10 08:40:00 这种空格分隔格式,new Date() 在 ArkTS 里直接给 Invalid Date。处理办法是先 replace(' ', 'T') 再解析,或者服务端统一返回毫秒时间戳。

三、结论

官方标的学习时长是 150 分钟,实际把三个坑都踩一遍花了差不多 4 小时。案例本身质量不错,端云联调那条链路完整跑通后,再回头看 ArkTS 的状态管理和网络层就顺了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。