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

73 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M8 0.9.4 发布候选记录
日期: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 全部条目保持未勾选。