31 lines
2.5 KiB
Markdown
31 lines
2.5 KiB
Markdown
# 可选的单 ROM 桌面检查
|
||
|
||
用于区分 ROM/内核输出问题和 Android 显示问题。它使用项目锁定的两个内核,以及生产代码的哈希、
|
||
兼容选项、像素转换和显示尺寸计算;不启动 Android、Oboe 或 GL,不代替实机验收。默认检查一份 ROM 的 1800 帧,
|
||
保存几个 PPM 帧和统计结果,再做一次核心状态往返;不会安装为应用或自动加入 Stage 检查。
|
||
|
||
本机已验证 MinGW GCC 16.1.0/Ninja。从项目根目录配置(先按 `docs/build.md` 获取固定第三方源码):
|
||
|
||
```powershell
|
||
$taskSdkCmake = "$env:LOCALAPPDATA\Android\Sdk\cmake\3.22.1\bin"
|
||
$env:Path = "C:\gcc-16.1.0-64\bin;$env:Path"
|
||
& "$taskSdkCmake\cmake.exe" -S tools/rom-probe -B build/rom-check -G Ninja "-DCMAKE_MAKE_PROGRAM=$taskSdkCmake/ninja.exe" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_BUILD_TYPE=Release
|
||
& "$taskSdkCmake\cmake.exe" --build build/rom-check --target probe_fceumm probe_nestopia -j 8
|
||
Copy-Item -LiteralPath '龙珠英雄.nes' -Destination build/rom-check/sample.nes
|
||
& build/rom-check/probe_fceumm.exe build/rom-check/sample.nes build/rom-check/fceumm 1800
|
||
& build/rom-check/probe_nestopia.exe build/rom-check/sample.nes build/rom-check/nestopia 1800
|
||
```
|
||
|
||
Windows 的上游文件接口要求 UTF-8,而窄字符命令行编码可能不同,所以本机检查使用 ASCII 名称的
|
||
字节相同副本;它不修改原 ROM,也不涉及应用内已经使用哈希文件名的导入路径。样本不进入 Git。
|
||
|
||
可在帧数后传 `original-defaults` 暂时绕过兼容规则,重现两个内核的原始选项。帧数限 60~3600。
|
||
只核对显示尺寸时可传 60 帧;输出 `texture` 为回调纹理尺寸,`base` 为核心基础尺寸,
|
||
`integer_viewport` 为生产算法在 1664×1248 区域内计算的整数缩放结果,不是实际 Android 截图。
|
||
固定输入脚本在第 180、420 帧按 Start,在第 720~1620 帧每隔 180 帧按一次 A,每次 3 帧;这只是
|
||
可重复的启动/菜单操作,不是通用自动游玩或完整游戏验收。
|
||
|
||
输出中的非零音频计数表示核心确实产生音频样本,不代表听感测试通过。退出码为零仅表示加载及核心
|
||
状态往返成功;仍须查看帧内容判断是否卡死/黑屏。原始 NTSC 下的 CPU 卡死也可能支持状态序列化。
|
||
状态往返比较恢复前后再运行 30 帧的画面哈希,不触碰用户存档,也不替代应用存档封装/写盘测试。
|