用 ArkTS + Appwrite 做一个鸿蒙单词打卡应用:端云一体化实战
【摘要】 用 HarmonyOS 的 ArkTS 写端侧、Appwrite 自托管 Functions 做云侧,搭一个卡片式背单词应用——支持闪卡翻转、看词选义测试、进度条与连续打卡。整个项目入门级,预计 1.5–2.5 小时跑通。这个案例解决什么问题?很多鸿蒙开发者学到端云协同时会卡在一个点:云侧怎么搭? 华为云 FunctionGraph + APIG 是一条路,但如果你想要更轻量的自托管方案,A...
用 HarmonyOS 的 ArkTS 写端侧、Appwrite 自托管 Functions 做云侧,搭一个卡片式背单词应用——支持闪卡翻转、看词选义测试、进度条与连续打卡。整个项目入门级,预计 1.5–2.5 小时跑通。
这个案例解决什么问题?
很多鸿蒙开发者学到端云协同时会卡在一个点:云侧怎么搭? 华为云 FunctionGraph + APIG 是一条路,但如果你想要更轻量的自托管方案,Appwrite 是一个值得了解的选择——它内置 HTTP 路由和文档型 NoSQL 数据库,省去了独立 API 网关层,部署一台服务器就能跑。
这个案例把「端侧 ArkTS + 云侧 Appwrite Serverless」的完整闭环走了一遍,沉淀的 Functions 编写规范和自托管排障经验可以复用到其他 Appwrite 后端场景。
技术架构
整体分三层,链路很清晰:
| 层级 | 技术 | 干什么 |
|---|---|---|
| 端侧 | ArkTS / ArkUI(DevEco Studio) | 4 个页面:登录、首页、闪卡、测试 |
| 云侧 | Appwrite Functions(Node.js 16,6 个函数) | 注册、登录、取每日单词、记录学习、查进度、初始化数据库 |
| 数据 | Appwrite Database(文档型 NoSQL) | word_db 库下 3 个集合:用户、词库(58 词)、学习记录 |
核心调用链路:App 通过 Function 执行端点发起 POST 请求 → Function 用 Server SDK 读写 Database → 结果包在 responseBody 里返回 App。端侧不直接持有数据库凭据,Function 是唯一入口。
6 个云函数分别做什么?
| 函数 | 职责 |
|---|---|
| register | 用户注册 |
| login | 用户登录 |
| getDailyWords | 返回今日 10 个未学单词 |
| learnWord | 记录一次学习,更新进度 |
| getProgress | 查询学习进度与连续打卡天数 |
| db-init | 初始化集合结构与 58 词种子数据 |
几个值得注意的实践点
- ESM 默认导出:Appwrite Functions 入口必须用 export default,写错会运行时报错。
- 依赖要手动打包:Appwrite v1.9.0 不会自动 npm install,每个函数的 node_modules 要一起打成 tar.gz 上传(注意不是 zip)。
- node-appwrite 版本:v14 要求 Node 18+,自托管环境如果只有 node-16.0,需要降级到 11.0.0 版本。
- execute 权限:演示阶段设为公开执行(any),方便联调;生产环境必须改为仅用户执行并加上鉴权和限流。
- 端侧配置:HttpUtil.ets 统一管理服务器地址和项目 ID,API Key 只放在云侧函数的环境变量里,端侧绝不持有。
快速跑起来的步骤
- 克隆案例仓库,进入项目目录
- 复制环境变量模板,填入 API Key、服务器地址、Project ID
- 运行部署脚本,自动安装依赖并打包上传 6 个云函数
- 调用 db-init 函数初始化数据库(3 个集合 + 58 词种子数据)
- 在端侧填入服务器地址和 Project ID,编译安装 HAP
- 用预置管理员账号登录,体验完整流程
验收标准
跑通后应该能看到这 6 件事正常工作:
- ✅ 登录后首页显示打卡状态和连续天数
- ✅ 新用户注册成功并可登录
- ✅ 首页展示 10 个未学单词
- ✅ 闪卡点击翻转,动画流畅
- ✅ 看词选义测试答对后进度条更新
- ✅ 学完一个单词后打卡状态变为「已完成」,连续天数正确累加
适合谁?
- 有 HarmonyOS 或后端基础,想学 Appwrite 端云一体化开发的工程师
- 想了解 NoSQL 文档数据库设计的开发者
- 想体验自托管 Serverless 部署与排障的人
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)