用 ArkTS + Appwrite 做一个鸿蒙单词打卡应用:端云一体化实战

举报
ioiy 发表于 2026/11/10 16:19:05 2026/11/10
【摘要】 用 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 词种子数据

几个值得注意的实践点

  1. ESM 默认导出:Appwrite Functions 入口必须用 export default,写错会运行时报错。
  2. 依赖要手动打包:Appwrite v1.9.0 不会自动 npm install,每个函数的 node_modules 要一起打成 tar.gz 上传(注意不是 zip)。
  3. node-appwrite 版本:v14 要求 Node 18+,自托管环境如果只有 node-16.0,需要降级到 11.0.0 版本。
  4. execute 权限:演示阶段设为公开执行(any),方便联调;生产环境必须改为仅用户执行并加上鉴权和限流。
  5. 端侧配置:HttpUtil.ets 统一管理服务器地址和项目 ID,API Key 只放在云侧函数的环境变量里,端侧绝不持有。

快速跑起来的步骤

  1. 克隆案例仓库,进入项目目录
  2. 复制环境变量模板,填入 API Key、服务器地址、Project ID
  3. 运行部署脚本,自动安装依赖并打包上传 6 个云函数
  4. 调用 db-init 函数初始化数据库(3 个集合 + 58 词种子数据)
  5. 在端侧填入服务器地址和 Project ID,编译安装 HAP
  6. 用预置管理员账号登录,体验完整流程

验收标准

跑通后应该能看到这 6 件事正常工作:

  1. ✅ 登录后首页显示打卡状态和连续天数
  2. ✅ 新用户注册成功并可登录
  3. ✅ 首页展示 10 个未学单词
  4. ✅ 闪卡点击翻转,动画流畅
  5. ✅ 看词选义测试答对后进度条更新
  6. ✅ 学完一个单词后打卡状态变为「已完成」,连续天数正确累加

适合谁?

  • 有 HarmonyOS 或后端基础,想学 Appwrite 端云一体化开发的工程师
  • 想了解 NoSQL 文档数据库设计的开发者
  • 想体验自托管 Serverless 部署与排障的人

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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