HarmonyOS 数独小游戏:ArkUI 棋盘渲染、冲突校验与本地持久化
数独看似是一个经典小游戏,却很适合作为 HarmonyOS 纯端侧开发的综合练习。它同时涉及声明式界面、复杂网格状态、算法校验、题库生成和本地持久化。把这些部分拆开设计,可以得到一套清晰、可测试、可复用的工程结构。
一、用状态驱动 9×9 棋盘
端侧可以划分为首页、游戏页和选题列表三个页面。首页展示通关进度与随机出题入口,选题页按难度组织题目,游戏页负责棋盘、数字面板和状态反馈。ArkUI 的核心优势是状态变化自动驱动界面更新,因此每个单元格不应直接操作视图,而应保存数值、是否预填、是否选中和是否冲突等状态。
在组件设计上,可以用 @State 管理当前棋盘和选中位置,用 @Prop 向单元格传递只读属性,再通过 @Builder 抽取重复的宫格、数字按钮和进度卡片。9×9 棋盘既可以使用 Grid,也可以按三行三列的宫结构组合。无论采用哪种方式,都要保证预填数字不可编辑、选中格有明显反馈、同行同列同宫的关联格可区分。
二、把冲突校验写成纯函数
数独规则适合与 UI 完全解耦。computeConflicts 接收棋盘数据,返回冲突位置集合或布尔掩码;isSolved 只判断棋盘是否填满并且不存在行、列、宫冲突。这样算法层不依赖页面组件,可以用固定输入输出直接验证。
校验时需要分别遍历九行、九列和九个 3×3 宫。遇到 0 或空值时跳过;同一数字出现多次,就把所有相关位置标记为冲突。页面只消费结果并改变颜色,不在渲染代码里重复实现规则。这个边界很重要:一旦把算法散落到点击事件和组件样式中,后续增加提示、撤销或笔记模式会非常难维护。
三、生成可复现的分级题库
离线应用不依赖服务器,也可以生成稳定题库。常见方法是准备一个合法终盘,再通过行列置换、数字替换等保持合法性的操作得到新终盘,最后按难度挖去不同数量的格子。使用确定性伪随机数生成器后,相同种子会得到相同结果,便于测试和复现。
需要明确的是,简单的随机挖空只能保证题目有解,不一定保证唯一解。如果产品要求严格唯一解,就必须增加求解器并统计解的数量。对于入门案例,可以在说明中明确边界,并让通关判定依据“填满且无冲突”,而不是强制与预置答案逐格相同。
四、用文件持久化避免旧缓存
进度数据可以保存为 JSON,例如记录已通关题目编号、各难度完成数量和最近游戏状态。通过 @ohos.file.fs 直接读写应用沙箱中的文件,每次首页显示时重新读取磁盘最新数据,可以避免跨页面共享单例缓存导致的旧值问题。
写入时要先构造完整的新对象,再一次性序列化保存;读取时处理文件不存在、JSON 损坏和字段缺失等情况,并提供默认结构。卸载应用后沙箱数据会被清除,因此基础版本应清楚说明它是纯本地进度,不宣称云同步。
五、验收要覆盖界面与算法
“应用能启动”只是第一步。完整验收应包括:预填格不可修改;同行、同列和同宫重复数字即时高亮;合法终盘能够通关;返回首页后进度增加;重启应用后记录仍保留;重置操作能清空进度。同时用固定样例验证 computeConflicts、isSolved 和题库生成结果,避免仅凭截图判断算法正确。
通过这个案例可以看到,纯端侧应用同样需要明确分层:ArkUI 页面负责交互,纯函数负责规则,题库模块负责可复现数据,存储模块负责持久化。保持这些责任边界,未来增加计时、最佳成绩、候选笔记甚至云端排行榜时,都能在原有结构上平稳扩展。
- 点赞
- 收藏
- 关注作者
评论(0)