数独小游戏上鸿蒙:一次纯端侧 ArkUI 实践,编译一次就通过了
11 月 16 日晚做的每周实践鸿蒙案例,选的是“数独小游戏:HarmonyOS + ArkUI 纯端侧开发”。选它只有一个理由:纯离线、免费,不依赖云端服务和付费资源,适合一次跑通。这篇把当晚的实际过程记下来,重点是环境适配那一步。
一、为什么选纯离线案例
成长中心的每周实践有不少案例,有的要开对象存储桶、有的要同步临时 AK/SK,走到一半就可能弹出授权或付费提示。数独这个案例在介绍里就写明了纯端侧开发,逻辑和界面都在端侧,不用联网、不用配云资源。做之前先看案例页确认这一点,比做到一半再回头换案例省事。案例页地址是纯文字:harmonybp.developer.huaweicloud.cn/cases/c0043e1e9d0240d19c23fa2556d5ecfc
二、在 DevSpace 免费试用里搭环境
实践是在 AI DevSpace 的免费试用环境里做的。新建一个 Sudoku 项目,把案例仓库 Harmony-APP-sudoku 拉下来,然后按案例说明走标准构建:先 ohpm install 装依赖,再 hvigorw assembleHap 编译。构建一次成功,产物是 entry-default-unsigned.hap,967K。
全程没有出现临时 AK/SK 同步同意框,也没有 OAuth 授权弹窗和付费提示。这一点值得单独记一笔:不是每个案例都这样,选案例时看到“纯离线”“免费”这两个词,基本就等于排除了这两类中断。
三、唯一卡住的地方:SDK 版本对不上
构建前唯一要改的,是 SDK 兼容版本。案例的目标 SDK 是 6.1.0(API 23),而工作区的 SDK 是 26,版本对不上就编不过。改法只动工作区里的配置:把 build-profile.json5 里的 compatibleSdkVersion 改成 26.0.0,再写好 local.properties,改完直接编译通过。
这个改动只在工作区里生效,不改案例本身,也不影响案例仓库。回头看,案例跑不通的时候,先对一下目标 SDK 和本地 SDK 的版本,比反复重装环境要快。
四、怎么确认这一步真的做完了
两个证据。第一是产物:编译成功后生成了 967K 的 Hap 包,文件在、有大小,不是只跑通了命令。第二是积分:这项每周实践的 +100 在 11 月 16 日 21:32 到账,当时余额到了 880 分。任务中心显示已完成,才算闭环,只看构建成功还不够。
五、给后来人的清单
- 优先选纯离线、免费的案例,先把授权和付费这两类中断排除掉。
- 动手前先对 SDK 版本:看案例的目标版本,再看工作区的版本,对不上先改配置。
- SDK 的改动只做在工作区里,别去改案例仓库本身。
- 构建命令按案例说明走:ohpm install 再 hvigorw assembleHap,产物文件和大小要亲眼确认。
- 最后以任务中心的已完成和积分到账为准,不要只凭一句“构建成功”就收尾。
小结
这次实践本身不难,难的是别在环境上浪费时间。选对案例、版本对齐、产物确认,三步走完,一次编译通过,+100 也顺利到账。下一个每周实践,我还会先按这个清单过一遍再动手。
- 点赞
- 收藏
- 关注作者
评论(0)