5.6 KiB
5.6 KiB
M8 0.9.4 发布候选记录
此文件保留 0.9.4 的历史候选证据。0.9.7 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.7 候选记录。
日期:2026-09-12
候选范围冻结为 M7 已实现功能加 M8 验收/交付能力,不再新增产品功能。源码冻结点为包含本报告的
M8 提交;tools/package-rc.ps1 只接受干净工作区,并把实际提交写入 candidate-manifest.json。
冻结身份与配置
| 项目 | 冻结值 |
|---|---|
| applicationId | org.neslite.app |
| RC 版本 | 0.9.4,versionCode 9004,arm64-v8a,min/target SDK 28/36 |
| FCEUmm | 236ccdfc911e84c60fea6b9d0699c2d440a8de14,静态链接 |
| libretro header | 0c9622896333ee62dc4326bbe8784a210ddeb03c |
| Oboe | 1.10.0 / a81bb9f87d4105b84b682685d3bfbb5beca371d1,静态链接 |
| 构建 | AGP 8.13.2、Gradle 8.13、Kotlin 2.3.0、JDK 17.0.17+10、NDK 28.2.13676358、CMake 3.22.1 |
| 显示/音频/存档 | M7 配置、48 kHz 请求与设备实际格式、M5 v1 存档封装;本阶段未改变核心提交和存档格式 |
| 兼容样本 | m8-rc-rom-set.md 中 12 个固定 CC0 样本;失败样本不得移除 |
F01~F14 证据索引与重跑决定
| 需求 | 当前可引用证据 | RC 决定 |
|---|---|---|
| F01 导入 | M2 报告及 JVM 解析/边界测试 | 用 12 个冻结样本执行 RC 导入;真机待跑 |
| F02 游戏库 | M2/M6 报告及 Room/JVM 测试 | 中文长名、收藏、隐藏、重关联关键路径待跑 |
| F03 游戏控制 | M2/M7 状态机及原生测试 | 加载、运行、暂停、继续、重置、退出待跑 |
| F04 显示 | M2/M6 视口与设置实现 | 实际画面、过滤、整数缩放和重建待跑 |
| F05 音频/时序 | M3/M7 实现与原生统计 | H-AV 从未取得,必须跑 NTSC/PAL |
| F06 手柄映射 | M1/M4 诊断和 JVM 映射测试 | X5 Lite 实测签名及全路径缺失,必须跑 |
| F07 输入细节 | M4 输入来源/连发测试 | H-HOT 从未取得,必须跑;存档菜单手柄路径待跑 |
| F08 快进 | M3/M4/M6 实现与时钟测试 | 真机倍率、静音及失焦取消待跑 |
| F09 游戏/状态存档 | M5 原生安全提交与格式测试 | H-SAVE 100 次及实机分支从未取得,必须跑 |
| F10 存档包/恢复 | M5 格式、校验和故障测试 | SAF、实际空间/中断及恢复路径待跑 |
| F11 生命周期 | M7 策略与竞态测试 | H-LIFE 从未取得,必须跑 |
| F12 虚拟按键 | M6 多来源 JVM 测试 | 纯触屏完整主链待跑 |
| F13 诊断 | M1/M7 有界导出与轮换测试 | 真机导出可读性及会话关联待跑 |
| F14 原生与交付 | M0 工具链锁、M8 静态审计与交付脚本 | 静态 16 KB 审计可本机完成;双页大小、API 28、签名升级待跑 |
现有报告没有任何满足 H-AV、H-HOT、H-SAVE、H-LIFE、H-LONG、H-INPUT、H-NATIVE 运行部分或
H-UPGRADE 完整口径的实机结果,因此本候选不复用这些项目为“通过”。M8 新增输入指标在 JNI 接收
变化掩码时以 C++ steady_clock 起点计时,在核心线程首次采样前结束;容量 2048,导出样本数、平均、
P95 和最大值。只有正常 Running 状态下累计至少 1000 次后,才能按一个实际模拟帧的阈值判定。
自动检查与静态原生审计
tools/check.ps1 -Scope Stage通过:arm64-v8a debug APK 构建成功,Windows 原生测试 1/1,JVM 37/37、0 失败。原生测试新增固定容量输入延迟窗口、平均、P95、最大值和重置验证。- release APK、FULL 原生符号和 Android 迁移测试 APK 均构建成功;迁移测试只完成编译,因无设备没有
执行。release lint 为 0 错误、55 个非阻断警告,详情见
docs/known-issues.md。 - 静态审计清点出
lib/arm64-v8a/libneslite_jni.so与 DataStore 的lib/arm64-v8a/libdatastore_shared_counter.so,没有遗漏或非 arm64 ABI。Android Build Tools 36.1.0 的zipalign -P 16通过;NDK r28c 的 LLVM 19.0.1 检查两库全部 ELF LOAD 段,最小对齐均为 16,384 字节。FCEUmm 和 Oboe 静态链接在libneslite_jni.so中。 - 最终干净提交的 APK、符号、应用源码、三个第三方源码和材料哈希由
tools/package-rc.ps1写入.build/rc-0.9.4/candidate-manifest.json与SHA256SUMS.txt,避免在受提交元数据影响的报告中固定 预检产物哈希。
设备验收入口
- 12 个固定样本由
tools/generate-rc-roms.ps1重建并逐哈希核对;它们只承担解析、加载、暂停和退出 冒烟。产品关键路径、H-AV 与 H-LONG 仍需具有动作/滚屏、声音和可观察电池进度的合法游戏样本。 - H-LONG 使用
tools/collect-h-long.ps1,两个不同代表样本各运行 120 分钟,每 60 秒保留一次原始 meminfo、CSV 和警告日志;脚本只把无崩溃/ANR的足时运行标为“待审内存趋势”,不能自动宣判通过。 - Room v1/v2 架构已随源码保存,Android 迁移测试验证中文名称和新增收藏/隐藏/最近字段;仍须在 同 ID/同签名覆盖安装中核对 ROM、DataStore、控制器档案和全部存档文件。
当前结论
M8 的自动采集、静态审计和交付基础设施已准备。由于没有连接 Android 设备、可观察玩法的合法样本、
发布密钥和旧版同签名数据集,M8-01b、M8-02a/b、M8-03b、M8-04a 及 G8 不能执行;M8-04b 的完整
候选交付也受签名和前置验收阻断。按照 todo.md 的阶段依赖与证据规则,M8 全部条目保持未勾选。