鸿蒙数独小游戏案例实战:纯 ArkUI 端侧的网格渲染与状态收敛
一、案例定位:为什么值得看数独
数独是鸿蒙开发实践中心里少数“纯端侧、零后端”的完整案例:不连数据库、不调云服务、不需要账号体系,一个 ArkTS 工程跑起来就能玩。它的价值不在业务复杂度,而在把 ArkUI 的三件基本功一次性摆在你面前——网格布局、状态驱动重绘、手势与焦点管理。做完这个案例,再回头看需要端云协同的记账本、云相册,会清晰很多。
二、棋盘渲染:九宫格不是九个 Grid
最容易踩的坑是把 9×9 棋盘写成嵌套 Grid:外层 9 个大格,每个大格里再套一个 3×3 的 Grid。这样写视觉上没错,但你会发现后面所有“行/列/宫”的校验逻辑都在跟两套坐标系打架——格子的索引要经历一次 (宫行, 宫列, 行, 列) 到 (行, 列) 的映射,出错概率极高。
更稳的做法是只用一个 Grid,columnsTemplate 写成九个 1fr,items 按行优先铺满 81 个格子,然后用 position 或边框来做宫的分隔线:第 2、5 列的右侧加粗边框,第 2、5 行的下方加粗边框,视觉上自然呈现九宫,逻辑坐标始终只有一套 (row, col)。
Grid() {
ForEach(this.cells, (cell: Cell) => {
GridItem() { /* 单元格内容 */ }
})
}
.columnsTemplate('1fr 1fr 1fr 1fr 1fr 1fr 1fr 1fr 1fr')
.columnsGap(0)
.rowsGap(0)
三、状态管理:一份二维数组,三层视图
棋盘本质是一份 81 长度的模型数据,每个格子至少要知道三件事:当前值、是否为题目给定的固定格、是否被用户改错。我把它们塞进一个 Cell 类,用 @Observed 标记,视图侧用 @ObjectLink 引用单个格子。这样点一个格子只重绘一个 GridItem,而不是整盘 81 个。
这是本案例最值得抄的一处:如果用 @State 挂一个 Cell[] 二维数组,任何一次赋值都会触发整个 Grid 重建,81 个节点重排在中低端机上肉眼可见地卡一下;换成 @Observed + @ObjectLink 之后,落子几乎是瞬时的。
四、输入与校验:冲突检测要“即时但不啰嗦”
数独的校验分两层:一是行、列、宫内的重复,二是解的唯一性。案例里只做了第一层,这也符合小游戏的定位。实现上不要在每次输入时遍历全部 81 格,只检查当前格子所在的行、列、宫(共 27 个格子),时间复杂度可以忽略。
交互上有个细节值得注意:冲突格不要立刻弹 Toast。用户连点数字时 Toast 会疯狂堆叠,正确做法是把冲突格的字色标红,并在顶部状态栏显示一行提示,等状态恢复再清除标记。案例里用的就是这个策略,体验明显更干净。
五、端侧性能:三处容易忽略的开销
第一处是 ForEach 的 keyGenerator。数独格子的位置永远不变,key 必须用 row-col 拼接的稳定字符串,一旦用了索引以外的随机值,每次重绘都会重建全部子组件。
第二处是数字键盘。案例用 1–9 的按钮组而不是系统输入法,省掉了输入法弹起导致的布局抖动;如果要支持手写输入,记得给 Grid 外层套 Scroll 并锁定滚动方向,否则棋盘会被顶飞。
第三处是计时常量。计时器用 setInterval 一秒一次刷新文本,这个刷新只应该驱动顶部那一个 Text,不要挂在页面级的 @State 上,否则每秒整页重组一次,电量掉得很快。
六、小结
数独案例的代码量不大,但把 ArkUI 的几个关键判断都浓缩了:能用一套坐标就别用两套,能让一个格子响应式就别让整盘响应式,能用局部校验就别全量遍历。这三条在后面的端云协同案例里同样成立——把云相册的图片列表、记账本的账单列表换成 81 个格子,你会发现问题是同一个问题。
建议的动手顺序:先把棋盘渲染出来(哪怕只有静态数据),再接入状态管理让落子生效,最后补冲突校验和计时。一步一验证,比一次写完再调错要快得多。
- 点赞
- 收藏
- 关注作者
评论(0)