鸿蒙端云一体实践手记:用 ArkUI 打造可离线运行的数独小游戏
【摘要】 本文记录我浏览鸿蒙开发实践中心「数独小游戏」案例后的实践要点:它是一个纯端侧的 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),要恢复时直接读文件,不走长生命周期的内存缓存。这一点在开发和在线调试时尤其重要:重新安装、升级或连接到模拟器调试时,旧的内存缓存很容易读到过期数据。
快速上手
- 克隆代码:git clone https://gitcode.com/harmonyos/SudokuGame.git,进入 SudokuGame 目录;
- 用 DevEco Studio 5.2.0.945 以上版本打开工程,安装配套 SDK 后同步依赖;
- 点 Run,应用装到真机或模拟器即可开始游戏;
- 退出前先点“保存”,再打开自动恢复。
验收清单
- 难度切换后棋盘正确重置;
- 撤销、重做、提示、笔记模式都可正常使用;
- 退出重进后,题目进度和最高成绩都在;
- 离线状态下和联网状态下的表现一致。
小结
相比“端云一体”类案例,这个数独案例的最大特点就是“轻”:纯端侧、零云端依赖、逻辑干净,适合用来练 ArkUI 声明式界面、状态管理和文件持久化。下一步我打算试着给它加一个云端排行榜,看看端侧进度怎么和云端同步。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)