2048N

2048N 是我CJackHwang基于上游项目（已征得上游仓库所有者的承接维护许可）进行深度性能优化与拓展完善版本，面向小米 Vela 快应用/RPK 环境适配。

应用信息

• 应用名：2048N
• 包名：me.cjack.b2048n
• 当前版本：1.2.0
• 应用说明：由CJackHwang基于上游B2048项目进行深度性能优化与拓展完善的版本

功能特性

1. 游戏核心
   • 经典 2048 合成逻辑
   • 当前分数与历史最高记录
   • 一步撤销
   • 自动保存游戏状态
2. 拓展完善
   • 支持更高数值方块显示
   • 支持传统分数与最高方块计分模式切换
   • 亮色/暗色主题切换
   • 实验性动画开关
3. 设备适配
   • 胶囊屏：小米手环 9、10、11（按屏宽自动区分 Band9 与 Band10/11 布局）
   • 矩形屏：小米手环 9 Pro、10 Pro（BandPro 布局）
   • 红米手表6（432×514）：独立 watch-rect 布局，宽 400+ 的竖向矩形屏自动匹配
4. 性能优化
   • 固定棋盘几何参数，减少移动时的布局测量
   • 移动后按需更新方块内容和样式
   • 文件保存使用真正防抖与脏标记，降低频繁写入开销
   • 移除未引用图片素材，减少 RPK 包体
   • 默认使用 release/JSC 打包，兼容当前 Vela 5 模拟器；不启用 Protobuf 二进制模板

CJackHwang 优化说明（截止目前）

本项目由我（CJackHwang）在上游版本基础上继续优化与完善，重点围绕 Vela 快应用/RPK 环境下的实际运行体验进行调整：

• 动画流畅性优化：优化方块移动、合成与状态刷新过程，降低动画卡顿和视觉跳变。
• 性能深度优化：减少不必要的布局测量、样式重算和重复渲染，让棋盘在连续滑动时保持更稳定的响应。
• 存储写入优化：通过保存防抖减少频繁落盘，降低游戏过程中不必要的 I/O 开销。

性能优化记录

当前版本围绕小米手环 9、9 Pro、10、10 Pro、11 与红米手表6 的共用棋盘逻辑，以及胶囊屏/矩形屏（BandPro）/红米手表6（watch-rect）三套布局做了以下优化：

1. 打包与运行配置
   • npm run build 默认执行 aiot release --enable-jsc，生成可在当前 Vela 5 模拟器和目标设备运行的 release 包。
   • 不启用 Protobuf 二进制模板：当前 Vela 5 模拟器加载 style.bin/template.bin 会在启动阶段触发运行时断言。
   • npm run build:compat 生成不含 JSC 的兼容包，用于排查设备运行时差异。
   • 保留 npm run build:debug 用于显式生成 debug 包。
   • manifest 中关闭运行日志输出，降低发布包运行时干扰。
   • 移除未使用的 system.router feature，仅保留实际使用的 system.prompt、system.file、system.folme。
2. 响应式状态裁剪
   • 只把真正驱动 UI 的数据放在页面 private 中。
   • 撤销状态等非 UI 数据移到模块变量，减少 viewModel observer 和数据代理开销。
   • 方块文本和样式数组原地更新，避免每步移动替换整组数组。
3. 存储写入优化
   • 保存逻辑改为真正 debounce：连续操作期间会不断延后写入，只在操作稳定后落盘。
   • 增加 saveDirty 脏标记；动画手势在 onHide / onDestroy 时会先结算新方块，再立即保存最终棋盘。
   • 复用保存 payload 对象，并让异步写入串行化，只保留最新快照，避免同一路径并发写入倒灌旧状态。
   • 保持旧版 game_data.json 字段兼容，不破坏已有存档。
4. 移动热路径优化
   • 去掉每次滑动时创建方向数组的 includes 判断，改用 switch。
   • 去掉手势方向的 toLowerCase()，直接按 Vela swipe 事件方向处理。
   • 无效移动不再提前备份棋盘，确认棋盘会变化后才复制撤销状态。
   • checkGameOver() 只在新方块生成后棋盘已满时执行。
5. 核心合成算法优化
   • 四方向移动改为固定 4 格的“读取、压缩、合并、写回”流程。
   • 删除 added 合并标记矩阵。
   • 删除 noBlockHorizontal() / noBlockVertical() 路径扫描函数。
   • 合成时增量维护分数、历史最高分、当前最大方块和历史最大方块。
   • 只有读档、撤销、新游戏等非热路径保留全盘最大值重算。
6. 动画与渲染优化
   • 棋盘位置使用固定几何参数，不在移动时调用布局测量。
   • Folme 动画只使用 translateX / translateY，不动画 left、top、尺寸或颜色。
   • 使用 folme.startGroup() 批量启动动画，减少逐个启动动画的桥调用。
   • 内部动画队列复用轻量槽位，减少移动计算阶段分配。
   • 传给 Folme 的动画参数使用一次性快照，避免运行时保留或改写复用对象导致动画错位。
   • 动画使用真机验证后的稳定节奏：110ms 动画、0.1 Folme duration、一次 DOM 提交后 32ms reset 延迟。
   • 动画结束后先提交最终棋盘 UI，再 reset 本轮实际动过的格子，避免无意义的全棋盘 reset。
7. 模板与节点优化
   • 亮/暗背景和按钮使用动态 src，减少重复 if/else 节点。
   • 关于菜单继续使用 if，关闭后从 VDOM 移除长图和菜单节点。
   • 菜单滚动关闭 bounce，减少小屏设备上不必要的滚动物理开销。
   • 方块仍使用 <text> + CSS 绘制，不使用方块图片素材，降低资源解码和内存成本。
   • 预计算小屏每格的位置类名以及 16 个文本/样式绑定键，所有设备刷新棋盘时复用固定字符串。

原型协作

即时设计原型共享链接：2048N

邀请您查看「2048N」，点击链接开启协作，方便继续修改和完善设计原型。

上游致谢

本项目基于上游 2048 项目继续二次开发与适配完善。感谢上游开源代码与早期移植工作，为 2048N 的优化和扩展提供了基础。

• lst 开源的 B2048 代码

• CheongSzesuen 基于 B2048 的环10移植版本

开发说明

构建环境要求 Node.js >=20.19.0；该下限由当前锁定的 Sass 版本决定，GitHub Actions 也使用同一版本。

构建

npm run build

npm run build 默认生成 release/JSC 包且不启用 Protobuf 二进制模板。构建产物会输出到 dist/ 目录，RPK 文件名会使用当前 manifest 中的包名和版本号。

回归测试

npm test

测试覆盖存档恢复、动画切后台结算、异步写入顺序、过期回调隔离，以及 2,500 组四方向合并规则。

如需生成不含 JSC 的兼容包，可执行：

npm run build:compat

当前 Vela 5 模拟器验收使用默认包；Protobuf 二进制模板会在页面启动阶段触发运行时断言。

如需生成 debug 包：

npm run build:debug

命令行启动模拟器

AIoT-IDE 之外可以直接用同一套调试配置启动模拟器、安装 release 包并打开应用：

npm run emulator -- --device band9 --once
npm run emulator -- --device band10 --once
npm run emulator -- --device bandpro --once

--once 会在启动后保存一张截图并自动关闭模拟器；去掉它可以保持模拟器运行，按 Ctrl-C 关闭。脚本会自动读取当前局域网地址生成 /tmp/quickapp_debug_cfg.json，避免 IDE 配置残留旧地址导致黑屏。

签名证书

release 打包需要项目根目录存在以下文件：

sign/private.pem
sign/certificate.pem

可用 OpenSSL 生成本地测试证书：

mkdir -p sign
openssl req -newkey rsa:2048 -nodes -keyout sign/private.pem -x509 -days 3650 -out sign/certificate.pem -subj /CN=2048N

sign/ 已被忽略，私钥不要提交到仓库。

颜色

方块颜色在 src/pages/index/index.ux 的样式区维护，可以按数值分别调整亮色和暗色主题。

Folme 动画

Folme 动画接口文档 中记录了动画接口与 2048N 中的使用方式。

开发记录

2048N 开发记录 记录了真机踩坑和项目最佳实践。

许可证

AGPL-3.0-only