鸿蒙案例学习笔记:云同步待办清单的端云一体实战

举报
yd_227296128 发表于 2026/11/13 10:31:30 2026/11/13
【摘要】 今天学习了鸿蒙开发实践中心的一个进阶案例——“云同步待办清单:鸿蒙端云一体实战”。它用 ArkTS 端侧加华为云 Serverless 云侧,搭出一条完整可复现的端云链路:注册登录、任务增删改、优先级与截止日期全部收口云端,多端每 30 秒轮询同步。端云一体并不神秘,难的是把账号、数据、部署、联调一次走通。

今天学习了鸿蒙开发实践中心的一个进阶案例——“云同步待办清单:鸿蒙端云一体实战”。它用 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,而是一种可复用的端云应用骨架。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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