Files
NESLite/docs/reports/core-selection-0.9.16.md

73 lines
5.3 KiB
Markdown
Raw Permalink 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.
# NESLite 0.9.16 双内核开发记录
本页保留 0.9.16 当时的证据;后来收到具体 ROM 后的定位与 0.9.17 修复见
[龙珠英雄兼容记录](long-zhu-ying-xiong-0.9.17.md)。通用构建输出路径可能已被新版本覆盖。
日期:2026-09-14。对应 F15/XCORE;应用版本 `0.9.16-debug`、`versionCode 9016`、
ID `org.neslite.app.debug`、ABI `arm64-v8a`。本次基于提交
`e3842c21dcd4c00f34a740da86947c93b5b93afb` 的工作区改动构建,尚未创建新的源码提交。
这是局部开发检查记录,不是 GCORE 或 G8 放行记录。
## 已实现行为
- 保留 FCEUmm `236ccdfc911e84c60fea6b9d0699c2d440a8de14`,新增 Nestopia
`224713b257c8620513c1c9ca28dc7f8dea711e18`,两个内核均随 APK 提供。
- 默认 FCEUmm;设置页可改默认,长按游戏可单独指定或跟随默认。选择写入 DataStore,下一次打开
游戏生效;同一模拟线程先关闭旧会话再打开新会话。状态页和存档管理展示活动内核。
- FCEUmm 的原有存档路径不变,Nestopia 使用独立路径;旧包只归 FCEUmm,新包携带内核 ID/提交,
跨内核包与即时存档拒绝导入。异常恢复计数也按内核分开。
- 宿主支持 XRGB8888、0RGB1555 转 RGB565,保留 pitch 处理和重复帧;清空缓冲后帧序号继续递增。
- 修正无电池内存游戏被读档前保护误拒绝的问题:电池大小为零时保护核心状态即可,实际存在电池
内存时仍要求完整快照;失败后继续执行回滚。模拟线程在全部成员初始化完成后才启动。
## L1 结果
构建环境延用 JDK 17.0.17+10、AGP 8.13.2、Gradle 8.13、NDK 28.2.13676358、CMake 3.22.1。
Windows 本地测试将 Java 临时目录定向到 `.build/java-tmp`;偏好持久化测试使用 DataStore 的 Okio
文件存储以支持 Windows 替换已有文件,并关闭后重开文件验证持久化。Android 生产存储仍使用标准
`preferencesDataStore`。未更改业务依赖版本。
| 检查 | 结果 | 证据/范围 |
| --- | --- | --- |
| arm64 Debug APK | 通过 | `.build/core-selection-build.log`;原生和 Kotlin 编译、链接、打包成功 |
| Kotlin 定向测试 | 6 项通过,0 失败 | CorePreferencesTest 3 项、AppSettingsTest 2 项、BuildIdentityTest 1 项;`app/build/test-results/testDebugUnitTest/` |
| 原生局部测试 | 2 个测试程序通过 | `neslite_core_selection_test`、`neslite_native_smoke_test`;`.build/native-tests/Testing/Temporary/LastTest.log` |
| Nestopia 导出 | 21 个宿主必需入口存在 | APK 解包后检查动态符号表;运行时仍会检查入口和 API 版本 |
| APK 与 ELF 静态对齐 | 通过 | `.build/core-selection-native-audit.json`;全部 3 个原生库 LOAD 段最小对齐 16384,APK 16 KB 对齐合格 |
局部原生用例覆盖内核 ID、旧路径保留、目录与恢复键隔离、包身份及旧包归属、跨内核状态拒绝、
像素通道转换和 pitch 边界、清空后帧序号。原有 smoke 用例复核共享的视频和存档封装/提交行为。
没有将 Android 动态库真正加载、内核运行或无电池游戏的完整读档路径记作自动测试通过。
复跑本轮局部检查(工具链配置见构建说明):
```powershell
.\gradlew.bat :app:assembleDebug :app:testDebugUnitTest --tests org.neslite.app.core.CorePreferencesTest --tests org.neslite.app.settings.AppSettingsTest --tests org.neslite.app.BuildIdentityTest
cmake -S app/src/main/cpp -B .build/native-tests
cmake --build .build/native-tests --config Debug --target neslite_native_smoke_test neslite_core_selection_test
ctest --test-dir .build/native-tests -C Debug -R 'neslite_(native_smoke|core_selection)_test' --output-on-failure
.\tools\check-rc-native.ps1 -ApkPath app/build/outputs/apk/debug/app-debug.apk -OutputPath .build/core-selection-native-audit.json
```
仅文档改动无需复跑以上命令;实现修改按 todo.md 的影响映射选取相关项。本轮未执行 Stage 全量本地
集合、发布 lint、100 次存读档、插拔轮次或 2 小时长稳。
## 构建产物
`app/build/outputs/apk/debug/app-debug.apk`,24,176,631 字节,调试签名,可覆盖同 ID/同调试签名的旧版。
SHA-256:`3BBB41F94F64799DEF49D7A087BB36159E07F1BB6D4F67CFE4D77587E9EF9956`。
APK 原生库为 `libneslite_jni.so`(含 FCEUmm/Oboe)、`libneslite_nestopia.so`、
`libdatastore_shared_counter.so`,均为 arm64-v8a;依赖检查仅出现 Android 系统库,无缺失的第三方共享库。
静态检查通过不能代替 Android 4 KB/16 KB 运行检查。
## 未验证项与最短实测路径
ADB 未发现已连接设备;未取得用户所说“龙珠英雄”的具体 ROM、SHA-256、Mapper 或黑屏日志。
该名称不能唯一确定游戏内容,因此不推断 Mapper,也不宣称新增 Nestopia 已解决黑屏。
先按 XCORE-04 完成 Android 同进程切换、重启选择记录、独立电池与即时存档的短路径,再按 XCORE-05
对同一份“龙珠英雄”分别验证两个内核。Nestopia 也可能不兼容该 ROM;双内核都失败时保留诊断继续定位。
候选冻结时,受影响内核的兼容集、H-AV、H-SAVE、H-NATIVE 按 GCORE/G8 共用证据安排;其余专项仅按
原发布门槛和证据有效性补齐。实机、长测、签名和发布门槛保持未勾选。