鸿蒙端云一体实践手记:用 ArkUI 打造可离线运行的数独小游戏

举报
yd_257599996 发表于 2026/11/13 19:36:36 2026/11/13
【摘要】 本文记录我浏览鸿蒙开发实践中心「数独小游戏」案例后的实践要点:它是一个纯端侧的 HarmonyOS 应用,不依赖云端,适合作为 ArkUI 入门练手。 案例做了什么这个案例实现了一个完整的数独小游戏,跑在 HarmonyOS NEXT(API 20,DevEco Studio 5.2.0.945)上。功能覆盖:9×9 棋盘、按 3×3 宫格划线,支持简单 / 中等 / 困难三档难度切换;随机...

本文记录我浏览鸿蒙开发实践中心「数独小游戏」案例后的实践要点:它是一个纯端侧的 HarmonyOS 应用,不依赖云端,适合作为 ArkUI 入门练手。

案例做了什么

这个案例实现了一个完整的数独小游戏,跑在 HarmonyOS NEXT(API 20,DevEco Studio 5.2.0.945)上。功能覆盖:

  • 9×9 棋盘、按 3×3 宫格划线,支持简单 / 中等 / 困难三档难度切换;
  • 随机出题、填数校验、笔记模式、撤销 / 重做、提示、计时与胜负判定;
  • 题目进度与最高成绩自动保存,下次打开可以继续玩;
  • 内置 54 道随机题目,配合确定性随机算法,每次进入题库的题目组合不会固定。

最值得学到的三个设计

1. 业务逻辑全部写成纯函数

棋盘的冲突检查、胜负判断等逻辑与界面完全分开,输入一个棋盘就能算出结果。这种写法让逻辑可以单独跑单元测试,不用启动界面,也不依赖状态,改起来很省心。

2. 随机出题要用“确定性随机”

案例没有用普通的随机数接口,而是用一个带种子的伪随机生成算法:输入同一个种子,输出的题目顺序完全一样。这样题库列表既每次都不重样,又能保证题目不会重复、可以复现和调试。需要记住:这个生成器要每次现算现用,不能做成长期缓存的单例,否则题目会固定不变。

3. 存档要直接读写文件

进度保存直接读写应用沙箱里的 JSON 文件(画布存 sudoku_save.json,题库存 SudokuBank.json),要恢复时直接读文件,不走长生命周期的内存缓存。这一点在开发和在线调试时尤其重要:重新安装、升级或连接到模拟器调试时,旧的内存缓存很容易读到过期数据。

快速上手

  1. 克隆代码:git clone https://gitcode.com/harmonyos/SudokuGame.git,进入 SudokuGame 目录;
  2. 用 DevEco Studio 5.2.0.945 以上版本打开工程,安装配套 SDK 后同步依赖;
  3. 点 Run,应用装到真机或模拟器即可开始游戏;
  4. 退出前先点“保存”,再打开自动恢复。

验收清单

  • 难度切换后棋盘正确重置;
  • 撤销、重做、提示、笔记模式都可正常使用;
  • 退出重进后,题目进度和最高成绩都在;
  • 离线状态下和联网状态下的表现一致。

小结

相比“端云一体”类案例,这个数独案例的最大特点就是“轻”:纯端侧、零云端依赖、逻辑干净,适合用来练 ArkUI 声明式界面、状态管理和文件持久化。下一步我打算试着给它加一个云端排行榜,看看端侧进度怎么和云端同步。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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