鸿蒙数独小游戏云端实践:从项目创建到 hvigor 编译打包全记录
最近在华为云鸿蒙开发实践中心体验了「数独小游戏:HarmonyOS + ArkUI 纯端侧开发」案例的云端实践,全程在云端容器环境完成项目创建、代码拉取与编译打包,把流程和踩坑记录一下,供想上云实践的朋友参考。
一、云端环境准备
进入鸿蒙开发实践中心 → 案例中心 → 打开「数独小游戏」案例详情页 → 点击云端实践。版本选择页提供了两种环境:体验版(免费试用、秒级启动、数据不保留)和持久化版(核时计费、关机保存数据)。个人体验选体验版即可,全程不消耗核时额度。
二、项目创建与代码拉取
进入开发环境后系统自动弹出「新建项目」对话框:项目名称和案例公仓地址(gitcode.com/harmony-practice-center/Harmony-APP-sudoku.git)已预填,只需填写本地工作目录。注意目录名规则:仅英文、数字与 - _ . /,不能含中文和空格。
点击创建后,系统自动从 GitCode 完成首次代码拉取(本案例约 730 个文件),项目状态变为「活跃」。
三、编译踩坑:SDK 版本不匹配
让 CodeArts CLI 智能体执行 hvigor 构建时首次失败:案例工程的 compileSdkVersion 为 5.1.1(24),而当前云端 DevEco 环境仅支持到 API 26(26.0.0),版本不兼容导致构建报错。
解决办法:修改 build-profile.json5 中 compileSdkVersion / compatibleSdkVersion / targetSdkVersion 至环境支持的 26.0.0,保存后重新构建。
四、构建结果
修正后重新执行 hvigor 构建,顺利输出 BUILD SUCCESSFUL,产物位于 entry/build/default/outputs/default/entry-default-unsigned.hap(约 679KB,debug 包)。
五、小结与建议
1. 云端实践最大的好处是零本地环境配置,浏览器即可完成开发、编译、打包全流程;
2. 体验版容器 3 小时后会自动释放,注意及时保存产物;
3. 遇到 SDK 版本报错不要慌,对照环境支持的 API 版本调整 build-profile.json5 即可;
4. 案例自带 54 道分难度题库、冲突校验与本地持久化,代码结构清晰,很适合作为鸿蒙入门第一个完整项目。
- 点赞
- 收藏
- 关注作者
评论(0)