鸿蒙数独小游戏云端实践:从项目创建到 hvigor 编译打包全记录

举报
yd_235783506 发表于 2026/11/16 10:52:01 2026/11/16
【摘要】 在鸿蒙开发实践中心完成数独案例云端实践的记录:体验版容器创建项目、从 GitCode 拉取代码、修复 SDK 版本兼容问题,最终 hvigor 编译打包生成 HAP,附踩坑与建议。

最近在华为云鸿蒙开发实践中心体验了「数独小游戏: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 道分难度题库、冲突校验与本地持久化,代码结构清晰,很适合作为鸿蒙入门第一个完整项目。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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