Files
NESLite/docs/reports/m8-release-candidate.md
T

5.6 KiB
Raw Blame History

M8 0.9.4 发布候选记录

此文件保留 0.9.4 的历史候选证据。0.9.15 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.15 候选记录。

日期: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 全部条目保持未勾选。