鸿蒙纯端侧实战:ArkUI 数独小游戏里的三个关键设计
一、引言
做鸿蒙端侧应用,真正容易踩坑的往往不是 UI 语法,而是状态、算法与持久化三者的边界。本文以「数独小游戏」这个纯端侧案例为主线,梳理三个可复用的设计:声明式 UI 与纯函数逻辑解耦、确定性 PRNG 生成题库、以及用 @ohos.file.fs 直读文件规避 dataPreferences 的跨页面读旧值问题。
二、逻辑与 UI 解耦:冲突校验返回掩码
冲突校验与通关判定全部写成不依赖 UI 的纯函数,棋盘组件只消费返回的布尔掩码来高亮,复用与测试成本都低:
export function computeConflicts(board: CellData[][]): boolean[][] { /* ... */ }
export function isSolved(board: CellData[][]): boolean { /* ... */ }
这样在验证算法时可以直接喂固定棋盘并断言输出,不需要先起模拟器或截图。
三、确定性题库:PRNG + 基准解置换 + 盲挖
题库用确定性 PRNG(mulberry32),保证同一 seed 每次生成完全相同的 54 题(简单/中等/困难各 18):
function mulberry32(a: number) {
return function () {
a |= 0; a = a + 0x6D2B79F5 | 0;
let t = Math.imul(a ^ a >>> 15, 1 | a);
t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
return ((t ^ t >>> 14) >>> 0) / 4294967296;
};
}
生成流程是:一个合法终盘 → 行/列置换与数字替换(保持合法性)→ 盲挖空格。要注意盲挖不做唯一性校验,所以题目可能存在多解;这不是 bug,通关判定只校验「填满且无冲突」,不与内置 solution 比对。
四、文件持久化:为何不用 dataPreferences
通关后返回首页进度不更新,基本都是 dataPreferences 单例缓存导致跨页面读到旧值。改用 @ohos.file.fs 直接读写 JSON,每次 load 都取磁盘最新值:
const file = fs.openSync(path, fs.OpenMode.READ_ONLY);
const stat = fs.statSync(path);
const buf = new ArrayBuffer(stat.size);
fs.readSync(file.fd, buf);
fs.closeSync(file);
const progress: ProgressData = JSON.parse(buf2str(buf));
配合首页 onShow 时重新 load,进度才能真正做到「重启仍在、返回即新」。
五、小结
三个设计串起来就是一条清晰的端侧数据流:ArkUI 页面 → 纯函数逻辑层 → 本地 JSON 文件 → 页面 onShow 重新读取。不依赖网络、账号与云服务,端侧应用同样能做得很稳。案例公仓:https://gitcode.com/harmony-practice-center/Harmony-APP-sudoku.git
- 点赞
- 收藏
- 关注作者
评论(0)