鸿蒙纯端侧实战:ArkUI 数独小游戏里的三个关键设计

举报
yd_251390123 发表于 2026/11/14 19:26:52 2026/11/14
【摘要】 一、引言做鸿蒙端侧应用,真正容易踩坑的往往不是 UI 语法,而是状态、算法与持久化三者的边界。本文以「数独小游戏」这个纯端侧案例为主线,梳理三个可复用的设计:声明式 UI 与纯函数逻辑解耦、确定性 PRNG 生成题库、以及用 @ohos.file.fs 直读文件规避 dataPreferences 的跨页面读旧值问题。二、逻辑与 UI 解耦:冲突校验返回掩码冲突校验与通关判定全部写成不依赖 ...

一、引言

做鸿蒙端侧应用,真正容易踩坑的往往不是 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

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。