5.3 KiB
NESLite 0.9.16 双内核开发记录
本页保留 0.9.16 当时的证据;后来收到具体 ROM 后的定位与 0.9.17 修复见 龙珠英雄兼容记录。通用构建输出路径可能已被新版本覆盖。
日期:2026-09-14。对应 F15/XCORE;应用版本 0.9.16-debug、versionCode 9016、
ID org.neslite.app.debug、ABI arm64-v8a。本次基于提交
e3842c21dcd4c00f34a740da86947c93b5b93afb 的工作区改动构建,尚未创建新的源码提交。
这是局部开发检查记录,不是 GCORE 或 G8 放行记录。
已实现行为
- 保留 FCEUmm
236ccdfc911e84c60fea6b9d0699c2d440a8de14,新增 Nestopia224713b257c8620513c1c9ca28dc7f8dea711e18,两个内核均随 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 动态库真正加载、内核运行或无电池游戏的完整读档路径记作自动测试通过。
复跑本轮局部检查(工具链配置见构建说明):
.\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 共用证据安排;其余专项仅按 原发布门槛和证据有效性补齐。实机、长测、签名和发布门槛保持未勾选。