鸿蒙开发实践中心端云一体案例上手路线:从案例公仓到云端作业中心
一、先看清案例中心的四条学习路径
华为云鸿蒙开发实践中心把案例按能力递进分成四层:
- Lv.1 声明式 UI 基础:2048、计算器模板、数独小游戏,重点练 Grid 布局、滑动手势与状态管理;
- Lv.2 纯端侧应用:喝水记录、番茄钟、记忆翻牌、房贷计算器、语音助手、五子棋,覆盖 Canvas 动画、Preferences 持久化与 Minimax 剪枝;
- Lv.3 元服务:机场室内导航、智能家居控制台、影院选座等,强调免安装、卡片直达;
- Lv.4 端云一体:云同步待办清单、员工签到 App、端云协同记账等,把云函数、API 网关、数据库真正连起来跑通。
这种分层的好处是目标明确:想练 UI 就从 Lv.1 选,想补云端能力直接看 Lv.4,不必在几十个案例里盲选。
二、案例公仓怎么组织
所有案例统一放在 GitCode 的 harmony-practice-center 组织下,目前有 78 个项目。命名规则基本可以直接看出来源:
- HarmonyOS-APP-*:完整应用,如 drink-record、tomato-timer、gomoku;
- HarmonyOS-APPTMPL-*:应用模板,覆盖政务、外卖、酒店、招聘、商城等场景;
- HarmonyOS-AtomSer-*:元服务案例,如 airport-guide、smarthome、pixel-paint;
- 其余短名仓库(todo_list、check-in、account_book、treehole)多为端云一体案例。
每个案例详情页都提供三个入口:云端实践、本地开发、案例公仓。云端实践会直接创建独享容器,编辑器、编译器、模拟器预置好;本地开发则给出克隆地址;案例公仓用于读源码和提 Issue。
三、两个端云一体案例的技术看点
1)云同步待办清单
端侧 ArkTS 负责交互,云侧用 8 个 FunctionGraph 云函数 + APIG 专享版 + RDS MySQL 三张表(users/sessions/tasks)。仓库里提供部署脚本一键部署和验收脚本端到端验收,端侧通过 30 秒轮询做自动同步。这个案例的价值在于把「端侧不直连数据库」的边界讲清楚了:鉴权和数据读写统一收口云端。
2)员工签到 App
由码道智能体从一句话需求生成 PRD/HLD、端侧与云侧代码。技术栈是 HarmonyOS ArkTS + Node.js/Express + MySQL,签到判定用 Haversine 公式计算 GPS 距离,配合最早/最晚双记录策略。端侧 6 页面 + 4 Service,云侧 3 组路由 + JWT 鉴权,部署用 Nginx 反代 + PM2 守护。它更适合作为「从需求到部署联调」的完整样板。
四、读仓库时值得注意的细节
翻提交记录能看到几个真实踩坑点,自己动手时可以少走弯路:
- 目录结构会调整,README 里的路径要和 harmony_app / harmony_cloud 的实际目录对齐,克隆后先看最新提交而不是旧教程截图;
- oh-package 配置文件中多余的 hvigor 插件声明可能导致 ohpm 安装 404,遇到依赖拉不下来先检查这里;
- ConfigCenter 的默认 URL 不要硬编码,安全扫描会把它当成配置泄露问题;
- 案例的 case 配置文件会跟随 IDE 规范更新,导入案例包失败时优先同步仓库最新版本。
五、建议的上手顺序
先用 Lv.1 的一个小案例跑通「创建项目 → 编译 → 云手机运行」的闭环,确认环境和账号没问题;再挑一个 Lv.2 纯端侧案例熟悉 Canvas 与本地持久化;最后进入 Lv.4 端云一体,按部署脚本 → 验收脚本 → 端侧联调的顺序推进。每天保持一次案例浏览和一次代码仓协作,比一次性啃完大案例更容易形成稳定节奏。
以上内容基于鸿蒙开发实践中心公开案例信息与案例公仓提交记录整理,具体以仓库最新代码为准。
- 点赞
- 收藏
- 关注作者
评论(0)