鸿蒙端云一体实践:用 ArkTS + 自托管 Appwrite 跑通个人记账本

举报
yd_213559342 发表于 2026/11/08 00:55:05 2026/11/08
【摘要】 ArkTS 端侧 + 华为云 ECS 自托管 Appwrite 云函数的端云一体记账 App 实践:架构取舍、云函数收口校验与聚合的思路,以及脚本化部署验收的工程化要点。

前言

最近在华为云鸿蒙开发实践中心体验了「个人记账本」这个端云一体案例,完整跑通后把架构与实现要点记录下来,给同样想入门端云协同开发的同学一个参考。

案例是什么

这是一个用 ArkTS 开发端侧记账 App、华为云 ECS 自托管 Appwrite(1.9.0)提供数据库、认证与云函数的端云一体项目,完成「记账 → 明细分页 → 云端聚合分类占比统计」的完整闭环:

  • 端侧:三个 Tab(记账 / 明细 / 统计),Preferences 持久化登录态,注册登录后下次启动自动进入主页
  • 云侧:6 个 node-16 零依赖 CommonJS 云函数,业务校验与统计聚合统一收口云端
  • 数据:Appwrite 文档库 account_book_db,users / transactions 两个集合

架构上的三个关键取舍

  1. 端侧不碰敏感凭证:端侧只带公开的项目 ID 调云函数,密钥只存在云函数环境变量里
  2. 校验收口云端:金额、分类、归属校验都放在云函数做,不信任端侧输入
  3. 聚合在云端完成:分类占比(餐饮 / 交通 / 购物 / 娱乐 / 居住 / 医疗 / 其他 共 7 类)由云函数按 user_id + 月份聚合,端侧只负责渲染环形图,避免拉全量数据

端侧通过 POST /v1/functions/{fnId}/executions 加 X-Appwrite-Project 头调用函数,这是 Appwrite 标准的云函数执行接口。

工程化亮点

  • 幂等的初始化 / 部署脚本,重复执行不产生脏数据
  • 19 项端到端验收,快速体验与完整实践两条路线都能脚本化验证
  • 环境版本明确:compile API 24 / 兼容 6.1.0(23)、hvigor 6.24.4,踩坑成本可控

适合谁 & 实践建议

已入门 ArkTS / ArkUI、想了解「端侧 App + 服务端云函数」端云一体架构的开发者。已有 ECS 环境约 1-2 小时可以跑通,含环境准备约 3-4 小时。

建议先走「快速体验」路线看到结果,再回头走「完整实践」理解每一步;遇到问题时案例里还有专门的验收与排障章节。

小结

这个案例的价值在于把「账号体系 + 数据列表 + 聚合统计」这类最常见的端云组合完整搭了一遍,并且部署、验收全部脚本化。想练手的同学可以从鸿蒙开发实践中心进入案例详情页,选「云端实践」直接在 AI DevSpace 里跑,环境开箱即用。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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