鸿蒙案例学习笔记:云同步待办清单的端云一体实战
今天学习了鸿蒙开发实践中心的一个进阶案例——“云同步待办清单:鸿蒙端云一体实战”。它用 ArkTS 端侧加华为云 Serverless 云侧,搭出一条完整可复现的端云链路:注册登录、任务增删改、优先级与截止日期全部收口云端,多端每 30 秒轮询同步。端云一体并不神秘,难的是把账号、数据、部署、联调一次走通。
一、案例解决什么问题
自己写待办清单,最容易停在“单端单机”:数据在本地,换台设备就看不到;想上云,又要同时啃账号体系、接口、数据库和部署,任何一环断掉都跑不起来。这个案例把 HarmonyOS ArkTS 端侧、APIG 专享版网关、FunctionGraph 云函数、RDS for MySQL 串成一条最短链路,端侧只留两个公开配置——APIG 公网入口地址 BASE_URL 与调试域名 APIG_HOST,凭据与业务校验全部收口云端。
二、整体思路
请求链路是:HarmonyOS App(ArkTS)→ APIG 专享版 → 云函数 → RDS for MySQL(Todo_DB)。云侧一共 8 个函数:login、register、taskCreate、taskUpdate、taskDelete、pull、db-init、diag;库里三张表 users、sessions、tasks,分别管账号、会话与任务。关键设计有三点:8 个函数统一 parseBody() 解码 APIG 的 base64 body,响应统一成 {code, message, data};密码用 scrypt 加盐哈希,登录签发 64 位 hex token,由 sessions 表校验归属;写操作用客户端 UUID 主键加 ON DUPLICATE KEY UPDATE 做到幂等。
三、关键步骤
先在同一区域开通云资源:VPC 与子网、安全组放通 TCP 3306、RDS for MySQL、开通公网入口的 APIG 专享版、FunctionGraph;再填好 deploy/.env,用 deploy.sh --dry-run --yes 预演后正式部署——apply 会幂等创建或更新 8 个函数、建触发器、发布 API 到 RELEASE、调用 db-init 建表。接着验证云侧:登录接口返回 code:0 即就绪,再跑 verify_api.sh 做登录、建、幂等、改、读回、删、pull 的全链路验收。最后在端侧 Config.ets 填好 BASE_URL 与 APIG_HOST,编译 HAP 装到模拟器,用演示账号 demo@example.com / 123456 登录验收,再用第二台模拟器登录同一账号,验证 30 秒内同步一致。
四、学习收获:三个印象最深的坑
一是冷启动 504:VPC 函数冷启动挂 ENI 约 6 秒,超过 APIG 后端 5000 毫秒超时,首次 504 属于正常;办法是自动重试 3 次、函数超时调到 30 秒、APIG 后端超时调到 30000 毫秒。记住超时不等于失败,重试要靠幂等兜底。二是 base64 之坑:APIG 会把 POST body 做 base64 编码,不解码就 JSON.parse 会报“Unexpected token e in JSON”。三是列表点了没反应:ForEach 的 key 只写 t.id 时框架认为条目没变,要改成包含可变字段的组合 key。案例也提醒这是教学示范,生产化前要按 README 第 6 节的最小改造清单补齐。
五、后续可尝试的方向
案例的拓展实践给了四条路线:给 pull 加 since 参数、按 updated_at 游标拉增量的增量同步;把 token 迁到 Authorization 头并加过期与撤销;补齐 APIG APP 认证签名;加本地缓存实现离线优先。这套骨架也可以迁移:把 tasks 换成打卡记录就是签到考勤,换成账单就是记账,再加“负责人”维度与状态机就是团队任务看板。学会的不是一个待办 App,而是一种可复用的端云应用骨架。
- 点赞
- 收藏
- 关注作者
评论(0)