鸿蒙数独小游戏:确定性题库生成、实时冲突校验与文件直读持久化实践

举报
yd_239758213 发表于 2026/11/14 11:48:37 2026/11/14
【摘要】 纯端侧鸿蒙数独小游戏实现拆解:确定性变换生成 54 道题库、纯函数做行列宫冲突校验、@ohos.file.fs 文件直读持久化通关进度,避开 dataPreferences 跨页面缓存读旧值的问题。

做一个“点开就能玩”的鸿蒙数独游戏,真正的难点不在画 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 渲染正常,预填数字不可修改;
  • 填入与同行重复的数字,冲突格实时红色高亮;
  • 正确填满整盘弹出庆祝卡片,返回首页对应难度进度加一;
  • 杀掉应用再打开,进度仍在;
  • 用固定种子跑同一难度两次,题目完全一致。

小结

这个小游戏没有后端、没有网络权限,全部逻辑都在端侧:确定性变换生成题库、纯函数做冲突校验、文件直读做进度持久化。三处共同点是“把状态变化收敛到可预测的、单向的路径上”——这也是大多数纯端侧鸿蒙应用可以复用的套路:扫雷、华容道、记忆翻牌,换上同样的结构都能成立。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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