鸿蒙数独小游戏:确定性题库生成、实时冲突校验与文件直读持久化实践
做一个“点开就能玩”的鸿蒙数独游戏,真正的难点不在画 9×9 棋盘,而在三件事:题库怎么来、填错怎么立刻发现、通关进度重启后怎么还在。本文结合一个纯端侧实现的数独小游戏,拆解这三点的实现思路。
一、题库:用确定性变换生成 54 道题
数独题目的合法性来自终盘。做法是先准备一个合法的基准终盘,再对它做确定性变换:数字重映射、行带内交换、列带内交换、同一宫带内的行列置换。这些变换都保持行、列、宫的合法性,因此生成的新终盘天然合法。
挖空时从终盘中按难度挖掉不同数量的格子:简单难度挖 30 格左右,困难难度挖 50 格以上。挖空后只校验“填满且无冲突即通关”,不再与内置答案逐格比对——这样即使题目存在多解,任意一套合法终盘都能通关。
为了让同一难度每次打开题目稳定、可复现,生成过程使用种子随机数:
function mulberry32(seed: number) {
return () => {
seed |= 0; seed = seed + 0x6D2B79F5 | 0;
let t = Math.imul(seed ^ seed >>> 15, 1 | seed);
t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
return ((t ^ t >>> 14) >>> 0) / 4294967296;
};
}
用固定种子洗牌、挖空,同一批题目在任何设备上都完全一致,既方便测试,也方便把固定样例写进验收用例。
二、冲突校验:把它写成纯函数
填一个数字后,要立刻知道它与同行、同列、同宫是否冲突。把“冲突”算成一个掩码,而不是直接改 UI:
// board 为 81 格的一维数组,0 表示空格
function calcConflicts(board: number[]): boolean[] {
const bad: boolean[] = new Array<boolean>(81).fill(false);
const check = (cells: number[]) => {
const seen = new Map<number, number[]>();
cells.forEach((idx) => {
const v = board[idx];
if (v === 0) return;
if (!seen.has(v)) seen.set(v, []);
seen.get(v)!.push(idx);
});
seen.forEach((idxs) => {
if (idxs.length > 1) idxs.forEach((i) => { bad[i] = true; });
});
};
for (let r = 0; r < 9; r++) check(rowCells(r));
for (let c = 0; c < 9; c++) check(colCells(c));
for (let b = 0; b < 9; b++) check(boxCells(b));
return bad;
}
纯函数的最大好处是可测试:给固定输入、断言固定输出,不用启动模拟器。棋盘组件只负责把掩码映射成红色高亮,逻辑与渲染彻底解耦。通关判定也是同理:棋盘填满且掩码全为 false,即弹出庆祝卡片,返回首页后对应难度进度加一。
三、进度持久化:为什么选文件直读
进度要跨页面、跨启动保留。可选的两种本地存储,行为差异很大:
- dataPreferences 是轻量 KV 存储,内部维护内存 Map。getPreferences() 加载时把文件读进内存,此后 get() 只查缓存;两个页面各自持有独立缓存实例,A 页 flush() 后,B 页的缓存仍是旧值,读到的就是旧进度。
- @ohos.file.fs 直读没有应用级缓存,每次 open 加 read 都走 OS 文件系统,磁盘上是什么就读到什么。
数独的通关进度要在“返回首页时立刻刷新”,属于跨页面强一致场景,因此这里选择文件直读:把进度写成 sudoku_progress.json 放在应用沙箱 filesDir,每次写入用 TRUNC 全量覆盖、finally 里 closeSync;每次读取都是 open、read、close 的完整周期,不持有长期文件描述符。
import { fileIo as fs } from '@kit.CoreFileKit';
const FILE = `${getContext().filesDir}/sudoku_progress.json`;
export interface Progress {
solvedIds: string[];
}
export function saveProgress(progress: Progress): void {
const file = fs.openSync(FILE, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE | fs.OpenMode.TRUNC);
try {
fs.writeSync(file, JSON.stringify(progress));
} finally {
fs.closeSync(file);
}
}
export function loadProgress(): Progress {
let file: fs.File | null = null;
try {
file = fs.openSync(FILE, fs.OpenMode.READ_ONLY);
return JSON.parse(fs.readTextSync(file)) as Progress;
} catch {
return { solvedIds: [] };
} finally {
if (file) fs.closeSync(file);
}
}
注意两点:文件不存在时返回空进度而不是抛错;写入全量覆盖,避免没有 TRUNC 时残留旧数据尾巴。如果非要用 dataPreferences,读之前必须先调 removePreferencesFromCache() 强制 reload——代价是每次读都全文件加载,频繁读取时反而不如文件直读。
四、UI 层:声明式组件怎么组织
棋盘用 ArkUI 声明式 UI:9×9 用嵌套循环渲染,数字面板用 @Builder 抽成独立组件;预填数字不可点击,玩家填入的数字经 @Prop、@Link 传入校验层,冲突掩码变化时只刷新对应格子的样式。
首页的进度卡片(已通关数 / 总题数,按难度分项)不持有状态,每次回到首页重新 loadProgress() 再渲染——这是文件直读带来的直接收益:不需要在页面间传递状态,也不需要监听刷新事件。
五、验收清单
- 点“随机一题”进入棋盘,9×9 渲染正常,预填数字不可修改;
- 填入与同行重复的数字,冲突格实时红色高亮;
- 正确填满整盘弹出庆祝卡片,返回首页对应难度进度加一;
- 杀掉应用再打开,进度仍在;
- 用固定种子跑同一难度两次,题目完全一致。
小结
这个小游戏没有后端、没有网络权限,全部逻辑都在端侧:确定性变换生成题库、纯函数做冲突校验、文件直读做进度持久化。三处共同点是“把状态变化收敛到可预测的、单向的路径上”——这也是大多数纯端侧鸿蒙应用可以复用的套路:扫雷、华容道、记忆翻牌,换上同样的结构都能成立。
- 点赞
- 收藏
- 关注作者
评论(0)