76 lines
5.6 KiB
Markdown
76 lines
5.6 KiB
Markdown
# 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 全部条目保持未勾选。
|