鸿蒙端云一体签到案例拆解:ArkTS 侧最容易返工的 3 个点
一、先看结构再动手
鸿蒙开发实践中心的「员工签到 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 的状态管理和网络层就顺了。
- 点赞
- 收藏
- 关注作者
评论(0)