release: prepare NESLite 1.0.0 with dual cores and signed packaging
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
# 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 共用证据安排;其余专项仅按
|
||||
原发布门槛和证据有效性补齐。实机、长测、签名和发布门槛保持未勾选。
|
||||
@@ -0,0 +1,52 @@
|
||||
# 原始整数缩放比例修复(0.9.18)
|
||||
|
||||
日期:2026-09-14。对应 F04/M2-03a、M2-03b。本次修复用户截图中 Nestopia 游戏画面横向拉宽的
|
||||
问题,完成 L1 局部验证并提供调试 APK;未连接 Android 设备,M2-03b 的 L2 画面复核仍待完成。
|
||||
|
||||
## 原因与改动
|
||||
|
||||
固定提交的 Nestopia 默认启用复合视频过滤,视频回调输出为 602×224,
|
||||
`retro_get_system_av_info` 给出的基础尺寸仍为 256×224。原渲染器直接以纹理宽高计算整数倍率,
|
||||
把横向扩展的采样宽度当成了 NES 原始像素宽度,因此整幅画面变扁。
|
||||
|
||||
- 视频缓冲同时保存纹理尺寸和基础尺寸,像素与基础尺寸在同一帧快照内交接;重复帧保留上一完整快照,
|
||||
新帧使用当时的基础尺寸,缺失基础尺寸时成对回退为纹理尺寸。
|
||||
- GL 仍按纹理实际宽高上传;整数显示改按基础宽高选择最大共同整数倍率并居中。空间不足一倍时,
|
||||
等比例缩小以完整显示。4:3 模式继续按 4:3 适配,暂停时切换模式也重新计算显示区域。
|
||||
- 沿用内核选项、固定提交、存档配置身份与存档路径;这次只修正前端显示尺寸。
|
||||
|
||||
在 1664×1248 的显示区域中,Nestopia 旧算法得到 1204×448;修复后为 1280×1120,即
|
||||
256×224 的五倍,与同基础尺寸的 FCEUmm 相同。原始整数模式保持基础像素比例,与强制 4:3 显示有区别。
|
||||
|
||||
## 分级验证
|
||||
|
||||
| 层级/检查 | 结果与范围 |
|
||||
| --- | --- |
|
||||
| L1/显示与缓冲 | `neslite_video_viewport_test` 通过:扩展纹理与基础尺寸分离、共同整数倍率、4:3 切换、区域大小变化、重复帧、缓冲清空与新帧尺寸、缺失基础尺寸、刚好一倍和不足一倍边界 |
|
||||
| L1/共享缓冲回归 | `neslite_core_selection_test` 通过,保留原有格式转换与跨内核帧序号检查 |
|
||||
| L1/真实内核尺寸 | 对已有本地“龙珠英雄”样本,两内核各采集 60 帧;FCEUmm 为纹理 256×224/基础 256×224,Nestopia 为纹理 602×224/基础 256×224,生产显示算法均计算出 1280×1120,位置 192,64 |
|
||||
| L1/应用构建 | 最终 `assembleDebug` 通过;`BuildIdentityTest` 1 项和 `AspectRatioFrameLayoutTest` 3 项通过 |
|
||||
| L1/最终 APK | 3 个 arm64 原生库的 ELF LOAD 段与 APK 16 KB 对齐检查通过,版本 0.9.18-debug/9018 |
|
||||
| L2/手机画面 | 待复核;ADB 无已连接设备。桌面探针使用真实内核和生产尺寸算法,不启动 Android/GL,也未运行截图中的 Mario ROM |
|
||||
|
||||
本次没有运行 Stage 全量、全 ROM 遍历、长稳或重新执行历史专项。桌面探针自带的一次核心状态往返
|
||||
也返回通过,仅保留在日志中,不作为本次存档验收。尺寸验证使用原样本的字节相同副本,ROM 不进入 APK。
|
||||
|
||||
日志:`.build/video-viewport-native-0.9.18.log`、`.build/video-viewport-android-0.9.18.log`、
|
||||
`.build/video-viewport-final-build-0.9.18.log`、`.build/video-viewport-native-apk-0.9.18.json`;
|
||||
真实内核尺寸为 `.build/rom-probe/video-fceumm-0.9.18.log` 与 `video-nestopia-0.9.18.log`。
|
||||
|
||||
局部原生测试可在构建对应目标后用 CTest 的
|
||||
`-R '^neslite_(video_viewport|core_selection)_test$'` 选择;真实核心尺寸检查见
|
||||
[探针说明](../../tools/rom-probe/README.md),传入 60 帧即可。
|
||||
|
||||
## 安装包与待复核步骤
|
||||
|
||||
- APK:`.build/releases/NESLite-0.9.18-debug-arm64-v8a.apk`,与
|
||||
`app/build/outputs/apk/debug/app-debug.apk` 字节相同;24,176,631 字节。
|
||||
- SHA-256:`015D5C76BC8BF0E25549059DE21704470543D0A7170FB5F5D6C0BC6AEC7964E6`。
|
||||
- application ID:`org.neslite.app.debug`;`versionCode = 9018`。当前工作区构建,未创建 Git 提交。
|
||||
|
||||
安装新版后,用 Nestopia 打开原截图中的游戏,在设置中切换“原始整数缩放”和“保持 4:3”,检查人物、
|
||||
文字与场景不再横向拉宽,整数模式保留居中黑边;暂停时再切换一次确认立即生效。FCEUmm 的同类复核
|
||||
与 XCORE-04 的切换检查合并完成,不重复跑同一路径;目标手机结果记录后再完成 M2-03b。
|
||||
@@ -0,0 +1,78 @@
|
||||
# 龙珠英雄黑屏定位与 0.9.17 修复
|
||||
|
||||
日期:2026-09-14。用户提供了项目根目录的 `龙珠英雄.nes`。本次在两个固定内核中复现 NTSC 启动
|
||||
卡死,并加入按精确文件哈希选择 Dendy 的兼容规则;Android 调试 APK 已构建,手机端仍待复核。
|
||||
对应计划 F15/XCORE-05,不作为 GCORE 或 G8 的完整放行证据。
|
||||
|
||||
## 文件与复现结果
|
||||
|
||||
| 项目 | 实际值 |
|
||||
| --- | --- |
|
||||
| 文件大小 | 262,160 字节,等于 16 字节头+256 KiB PRG |
|
||||
| 完整文件 SHA-256 | `f2fa5c9e40dc68e25fc9d9a4d5f2d5c9179c393d16c0d4e76f843aa17a6df981` |
|
||||
| PRG CRC32 | `20d4221c` |
|
||||
| iNES 头 | `4e 45 53 1a 10 00 42 00 00 00 00 00 00 00 00 00` |
|
||||
| 头部声明 | Mapper 4、256 KiB PRG、无 CHR-ROM、带电池,未正确表达此文件所需的 Dendy 制式 |
|
||||
| 复现平台 | Windows x64、MinGW GCC 16.1.0;同一 libretro 环境选项默认值与输入脚本 |
|
||||
| FCEUmm 提交 | `236ccdfc911e84c60fea6b9d0699c2d440a8de14` |
|
||||
| Nestopia 提交 | `224713b257c8620513c1c9ca28dc7f8dea711e18` |
|
||||
|
||||
原始默认选项下,两个内核都成功返回加载完成,但持续输出单色画面。FCEUmm 的 600 帧检查仅有
|
||||
2 次画面变化、非零音频样本计数为 0;Nestopia 为 4 次变化、非零音频计数为 1,并报告 CPU Jam。
|
||||
临时 CPU 跟踪在 FCEUmm 第 23 帧观察到中断恢复后从错误的程序存储区取指,在 `$9020` 执行停止指令。
|
||||
该复现在桌面直接取得核心视频回调,不经过 Android 或 GL,因而可以确认黑屏已经发生在游戏执行阶段。
|
||||
|
||||
针对启动时序分别检查 PAL 与 Dendy 后,Dendy 在两个内核均能显示中文启动画面并进入菜单;选择
|
||||
Dendy 作为此文件的兼容制式。Dendy 是核心的 CPU/PPU 时序配置,不是修改手机刷新率;NES 2.0
|
||||
对该制式有独立定义,见 [NESdev 时序字段](https://www.nesdev.org/wiki/NES_2.0#CPU/PPU_Timing)。
|
||||
这里只声明已实测的文件,不按中文文件名、Mapper 4 或所有中文游戏泛化此修复。
|
||||
|
||||
原始复现日志:`.build/rom-probe/fceumm.log`、`nestopia.log`;临时跟踪记录为
|
||||
`.build/rom-probe/fceumm-trace.txt`。跟踪只用于定位,最终检查工具和 APK 使用未修改的上游核心源码。
|
||||
|
||||
## 应用改动
|
||||
|
||||
- `rom_compatibility` 在宿主读入 ROM 后用实际字节计算 SHA-256;仅上述完整哈希命中
|
||||
`long-zhu-ying-xiong-dendy-v1`,不依赖文件名或 UI 传入的身份字符串。
|
||||
- 环境回调注册选项时,FCEUmm 使用 `fceumm_region=Dendy`,Nestopia 使用
|
||||
`nestopia_force_system=dendy`。其余选项、其他 ROM 和两个内核提交保持原值。
|
||||
- 状态诊断包含 `compatibilityProfile`;卸载时重置,下一款游戏不会继承该规则。
|
||||
- 原 ROM 字节及其哈希、游戏索引和电池存档位置保留。实际制式进入现有即时存档配置元数据,因此
|
||||
旧 NTSC 即时存档按原兼容检查拒绝加载且保留文件;本次没有自动删除、改写或迁移用户进度。
|
||||
- 新增可选 `tools/rom-probe/` 检查工具,明确传入单份本地 ROM 才运行;本地游戏样本加入 Git 忽略,
|
||||
不进入 APK 或应用源码发布包。
|
||||
|
||||
## 局部验证
|
||||
|
||||
| 检查 | 结果与边界 |
|
||||
| --- | --- |
|
||||
| 兼容规则单测 | `neslite_rom_compatibility_test` 通过;覆盖精确哈希、不同/缺失哈希、两个内核的键名和值、其他选项不受影响 |
|
||||
| FCEUmm+生产兼容规则 | 1800 帧,约 36 模拟秒;50.007 FPS、91 次画面变化、非零音频计数 1,454,099;一次核心状态往返通过 |
|
||||
| Nestopia+生产兼容规则 | 1800 帧,约 36 模拟秒;50.007 FPS、92 次画面变化、非零音频计数 1,474,223;一次核心状态往返通过 |
|
||||
| 画面检查 | 两个内核均看到中文启动、剧情选择和代码输入菜单;固定 Start/A 脚本会改变菜单状态,不再持续黑屏 |
|
||||
| Android 构建/版本 | `assembleDebug` 通过;BuildIdentityTest 1 项通过,版本 `0.9.17-debug`/9017 |
|
||||
| 最终 APK 静态原生检查 | 全部 3 个 arm64 库 LOAD 段和 APK 的 16 KB 对齐通过;没有新增共享库依赖 |
|
||||
| 原文件保护 | 修复后再次计算用户原文件 SHA-256,与输入一致 |
|
||||
|
||||
核心状态往返是在 1800 帧后序列化、运行 30 帧、恢复并再运行相同 30 帧,比较画面哈希;每个内核
|
||||
只做一次,不等同于 Android 存档文件、100 次循环、听感或完整玩法验收。两次 30 帧不计入上表的
|
||||
1800 帧启动统计。尚未验证 Android 上本次自动规则、完整战斗/通关及长期运行。
|
||||
|
||||
验证日志:`.build/rom-probe/verified-fceumm.log`、`verified-nestopia.log`、
|
||||
`android-build-0.9.17.log`、`android-native-0.9.17.json`;抽样画面为同目录的
|
||||
`verified-fceumm-179.png`、`verified-fceumm-599.png`、`verified-nestopia-599.png` 等。
|
||||
复跑单 ROM 检查见 [工具说明](../../tools/rom-probe/README.md);规则单测可用 CTest 精确选择
|
||||
`^neslite_rom_compatibility_test$`。没有运行 Stage 全量、全库 ROM 遍历、长稳或重复的历史专项。
|
||||
|
||||
## 交付与手机复核
|
||||
|
||||
版本:`0.9.17-debug`,`versionCode 9017`,ID `org.neslite.app.debug`,arm64-v8a。
|
||||
源码基于 `e3842c21dcd4c00f34a740da86947c93b5b93afb` 及当前工作区改动,未创建新的 Git 提交。
|
||||
APK 为 `app/build/outputs/apk/debug/app-debug.apk`,另提供同字节的版本化副本
|
||||
`.build/releases/NESLite-0.9.17-debug-arm64-v8a.apk`,大小 24,176,631 字节。
|
||||
SHA-256:`3A08617A13F0EBBD058F3F93AA12F6CB5E65FEC8865124771E9960EA020A8540`。
|
||||
|
||||
安装新版后从游戏列表重新打开原有“龙珠英雄”即可命中规则,无需重新导入或改名。FCEUmm 和 Nestopia
|
||||
均有对应设置;若用户正在旧版会话中,需重新打开游戏。ADB 当前未发现已授权手机,手机加载、输入、
|
||||
声音和完整玩法需继续按 XCORE-04/05 复核;若仍失败,诊断中的应用版本、内核、ROM 哈希及
|
||||
`compatibilityProfile` 可用于确认是否实际运行了本次修复。
|
||||
Reference in New Issue
Block a user