数独小游戏背后的三个ArkUI工程细节:棋盘渲染、确定性题库与离线进度持久化
最近在鸿蒙开发实践中心跟了一个数独小游戏的案例,规模不大,但把它拆开看,恰好覆盖了 ArkUI 端侧开发里最容易踩坑的三件事:棋盘这种密集网格怎么渲染、题库怎么在不联网的前提下做到确定可复现、以及进度数据怎么可靠地落在本地。这篇把过程里的思路整理出来,给同样在做纯端侧小应用的同学参考。
一、9×9 棋盘的声明式渲染与实时冲突高亮
数独棋盘是典型的"数据驱动视图"场景。整个页面拆成三个路由页:Index 负责首页的进度卡片与出题入口,GamePage 渲染 9×9 棋盘与数字面板,PuzzleListPage 按难度选题。棋盘本身用 Grid 布局加 ForEach 遍历 81 个单元格,每格绑定一个单元格状态对象(当前值、是否预置、是否冲突)。ArkUI 的声明式模型在这里的优势是:不需要手动操作任何 DOM,只要把冲突标记写进状态,UI 自动刷新。
冲突校验是每次填数后同步计算的:对当前格分别取同行、同列、同宫的值做集合比对,发现重复就给相关格打上冲突标记,渲染层用红色高亮呈现。这里有个细节值得注意——校验函数要做成纯函数,输入棋盘快照、输出冲突集合,这样无论是填数触发还是撤销触发,逻辑都走同一条路径,不会出现"高亮残留"。
二、不联网怎么造一个确定性的题库
案例最终内置了 54 道题:简单、中等、困难各 18 道,每题有唯一解,而且结果可复现。关键在于生成过程用了带种子的确定性算法:先按固定种子生成终盘(用回溯法填满整个棋盘),再按难度对应的挖洞数量逐个移除格值,每移除一个就验证解的唯一性,不唯一就回退。这样产出的每一道题都稳定可验证,用户刷到的第 7 道困难题永远是同一道——这在没有服务端校验的离线应用里非常重要,否则"通关判定"本身就不可信。
如果只是随手用 Math.random 生成,题库每次启动都变,进度记录和难度曲线就全乱了。确定性生成的另一个好处是题库可以随代码一起做版本管理,出问题能精确复现。
三、通关进度的本地持久化
进度记录用的是端侧本地文件:每关的完成状态、用时、最后游玩的题目编号,在关键动作(通关、切页、退后台)时写入。首页的进度卡片在每次返回时重新读取,所以"返回首页进度自动更新"不需要任何额外同步逻辑,读的就是同一份文件。
这里的原则是:写文件的时机宁多勿少,读写都做异常兜底。端侧应用的存储不可假设永远完整,进程被杀、存储满、文件损坏都可能发生,进度丢失对小游戏是毁灭性体验,所以宁可多写几次文件。
写在最后
整个应用全程离线运行,不联网、不登录,反而把架构逼得很干净:状态都是本地的,渲染完全由数据驱动,题库和进度都有确定的落盘位置。对想入门 HarmonyOS 的开发者来说,这种"小而完整"的端侧项目比一上来就上云的案例更适合建立手感。案例公仓在 GitCode 上开源(harmony-practice-center/Harmony-APP-sudoku),clone 下来用 DevEco Studio 就能跑,建议从冲突高亮这一段开始读,那是 ArkUI 状态管理最直观的教材。
- 点赞
- 收藏
- 关注作者
评论(0)