release: prepare NESLite 1.0.0 with dual cores and signed packaging
This commit is contained in:
@@ -5,18 +5,19 @@
|
||||
| 产品名称 | NESLite |
|
||||
| 文档版本 | V1.0 |
|
||||
| 编制日期 | 2026-09-12 |
|
||||
| 需求依据 | [design.md](../design.md) |
|
||||
| 最近修订 | 2026-09-14:按用户确认增加内置内核选择 F15,见第 11 节 |
|
||||
| 需求依据 | [design.md](../design.md) 及第 11 节用户需求增补 |
|
||||
| 目标版本 | Android 应用 1.0.0 |
|
||||
| 首要设备 | 用户的 Honor MagicOS 10 手机+小鸡 X5 Lite 手柄 |
|
||||
| 当前状态 | 规划完成,开发尚未开始;编制前目录仅有设计文档,尚无 Android 工程,也未初始化 Git 仓库 |
|
||||
| 当前状态 | 用户确认产品可发布,准备 1.0.0 签名交付至 git.m3frame.com/shen/NESLite;打包入口为打包.cmd,输出统一在 build;历史专项证据与任务勾选状态见 todo.md,不将未执行项自动视为通过 |
|
||||
|
||||
本计划将 `design.md` 转化为可执行的任务、阶段依赖、交付物和验收门槛。产品范围以设计文档为准;工期、实现默认值和测试样本数量属于本计划提出的执行基线,尚无实机测试结果。文档版本 V1.0 不代表应用已经达到 1.0.0。
|
||||
本计划将 `design.md` 转化为可执行的任务、阶段依赖、交付物和验收门槛。产品范围以设计文档及明确记录的用户增补为准;工期、实现默认值和测试样本数量属于执行基线,不能代替验收结果。文档版本 V1.0 不代表应用已经达到 1.0.0。
|
||||
|
||||
## 1. 开发目标与范围
|
||||
|
||||
### 1.1 交付目标
|
||||
|
||||
交付一款采用固定版本 FCEUmm 内核、自研 Android 前端、原生手柄输入的轻量 NES/FC 模拟器。用户能够完成“导入游戏 → 连接手柄 → 开始游戏 → 暂停和存档 → 退出 → 恢复进度”,并在目标手机上获得稳定的速度、声音和操作体验。
|
||||
交付一款内置固定版本 FCEUmm 和 Nestopia 内核、自研 Android 前端、原生手柄输入的轻量 NES/FC 模拟器。用户能够完成“导入游戏 → 选择内核 → 连接手柄 → 开始游戏 → 暂停和存档 → 退出 → 恢复进度”,并在目标手机上获得稳定的速度、声音和操作体验。
|
||||
|
||||
第一版复用内核的 CPU、PPU、APU 和 Mapper 实现,开发重心为 Android 适配、libretro 宿主、音视频调度、输入和数据可靠性。所有内核能力均需经过前端接入和测试才能算作产品功能。
|
||||
|
||||
@@ -40,10 +41,11 @@
|
||||
| F12 | 虚拟方向键、A/B、Start、Select,基础触屏菜单操作 | M6 | 无手柄可完成基本游戏操作,支持多点触控和取消事件 |
|
||||
| F13 | 手柄测试、运行状态、错误日志和诊断导出 | M1 基础,M7 完成 | 能定位设备、输入、音频、存档和原生错误 |
|
||||
| F14 | arm64 发布、4 KB/16 KB 验证、安装升级、源码及许可证交付 | M8~M9 | 发布包、源码、符号、构建记录和验收报告对应 |
|
||||
| F15 | 内置 FCEUmm/Nestopia 选择,默认值与逐游戏覆盖,独立存档 | XCORE(第 11 节),M8 汇总 | 持久选择、下次加载生效、切回原内核保留存档、同 ROM 对照验证 |
|
||||
|
||||
### 1.3 明确不做
|
||||
|
||||
V1.0 不做联网对战、云存档、多平台模拟、在线下载游戏、复杂 CRT 滤镜、回溯、run-ahead、用户下载或切换内核。FDS、光枪、四人适配器和第二只手柄的完整体验留待 V1.1 之后。
|
||||
V1.0 不做联网对战、云存档、多平台模拟、在线下载游戏、复杂 CRT 滤镜、回溯、run-ahead、用户下载或导入外部内核。内置内核选择按 F15 纳入本轮。FDS、光枪、四人适配器和第二只手柄的完整体验留待 V1.1 之后。
|
||||
|
||||
导入器首版仅开放 `.nes`,不扩展到压缩包、UNIF 或固件管理。应用不附带商业游戏 ROM。首版交付以可安装 APK 为准,应用商店上架不计入本轮工期。
|
||||
|
||||
@@ -56,8 +58,8 @@ V1.0 不做联网对战、云存档、多平台模拟、在线下载游戏、复
|
||||
| Android | `minSdk 28`,`compileSdk 36`,`targetSdk 36` | 延续设计目标;实际手机 API、ABI 和页大小在 M1 读取 |
|
||||
| 应用层 | Kotlin、AndroidX、原生 View | 单一 `app` 模块,按包划分职责;游戏使用独立页面 |
|
||||
| 数据 | Room+DataStore | Room 管理游戏元数据;DataStore 管理设置和控制器配置 |
|
||||
| 内核 | FCEUmm+libretro 接口 | M0 选定完整提交 SHA;M2 编译验证后冻结 |
|
||||
| 原生层 | C/C++、JNI、Android NDK、CMake | 优先将固定内核静态链接进 JNI 库;上游构建适配保留可复现脚本 |
|
||||
| 内核 | 固定提交的 FCEUmm/Nestopia+libretro 接口 | 清单记录完整提交 SHA;默认 FCEUmm,Nestopia 按 F15 接入 |
|
||||
| 原生层 | C/C++、JNI、Android NDK、CMake | FCEUmm 静态链接进 JNI;Nestopia 使用包内独立共享库;可复现构建并隔离同名符号 |
|
||||
| 视频 | `GLSurfaceView`+OpenGL ES | 原生帧缓冲交接;不经 Kotlin 每帧搬运图像 |
|
||||
| 音频 | Oboe | 记录实际流参数,支持请求低延迟失败后的回退 |
|
||||
| 构建工具 | AGP 8.13.2、Gradle 8.13、JDK 17 | 采用设计给出的兼容组合;M0 在本机完成构建验证 |
|
||||
@@ -141,11 +143,12 @@ Paused → Stopping → Idle
|
||||
├── saves/<sha256>/battery/ 游戏自身存档及有效备份
|
||||
├── saves/<sha256>/states/ 10 个手动槽位及元数据、缩略图
|
||||
├── saves/<sha256>/auto/ 最近 3 份自动恢复点
|
||||
├── saves/cores/nestopia/<sha256>/ Nestopia 独立的 battery、states、auto、recovery 与会话标记
|
||||
├── system/ 内核需要的稳定系统目录
|
||||
└── diagnostics/ 限额日志及会话标记
|
||||
└── diagnostics/ 限额日志
|
||||
```
|
||||
|
||||
Room 数据库和 DataStore 使用各自标准应用目录;数据库记录游戏哈希、显示名、内部文件关联、收藏、最近游玩时间和列表可见状态。哈希按导入文件的完整字节计算,不擅自去头或改写文件;内容不同的版本分别管理。
|
||||
FCEUmm 延续 `saves/<sha256>/`,读档保护副本及会话标记也在各内核、各 ROM 根目录内。Room 数据库和 DataStore 使用各自标准应用目录;数据库记录游戏哈希、显示名、内部文件关联、收藏、最近游玩时间和列表可见状态。哈希按导入文件的完整字节计算,不擅自去头或改写文件;内容不同的版本分别管理。
|
||||
|
||||
导入按“读取 URI → 有界流式复制和头部校验 → 计算 SHA-256 → 提交内部正式文件 → 数据库事务登记”执行。取消、空间不足及提交中断必须清理临时文件;数据库和文件系统不能形成单一事务,因此需在启动时对未登记正式文件及缺失文件记录进行核对和恢复。
|
||||
|
||||
@@ -212,7 +215,7 @@ Room 数据库和 DataStore 使用各自标准应用目录;数据库记录游
|
||||
| --- | --- |
|
||||
| 0.2.0/M2-01 | 编译锁定的 FCEUmm;接入 libretro API 版本检查、回调注册、初始化、目录、选项、玩家一端口和卸载 |
|
||||
| 0.2.1/M2-02 | SAF 导入、文件大小与头部校验、SHA-256 去重、稳定内部副本、最小 Room 索引和错误提示 |
|
||||
| 0.2.2/M2-03 | 视频回调、协商像素格式、行跨度与重复帧处理;GL 显示、4:3 和整数缩放基础能力 |
|
||||
| 0.2.2/M2-03 | 视频回调、协商像素格式、行跨度与重复帧处理;区分纹理宽高与内核基础尺寸,GL 按基础尺寸整数缩放并支持 4:3 适配;空间不足一倍时等比例缩小 |
|
||||
| 0.2.3/M2-04 | 模拟线程和会话状态机;手柄快照接入;启动、暂停、继续、重置、退出;基础电池存档读写 |
|
||||
|
||||
**出口条件:** 至少 3 个有权使用的样本完成加载和运行,其中包含一个电池存档样本;完整操作流程通过;正常退出再加载后游戏自身进度可恢复;损坏文件加载失败不会破坏现有数据。
|
||||
@@ -291,7 +294,7 @@ Room 数据库和 DataStore 使用各自标准应用目录;数据库记录游
|
||||
| M8-03 | 检查全部发布原生库与 APK 的 16 KB 对齐;4 KB 和 16 KB 环境运行;API 28 基线冒烟 |
|
||||
| M8-04 | 同应用 ID/签名覆盖升级、Room/设置迁移和存档兼容验证;整理发布源码、许可证、符号和已知问题 |
|
||||
|
||||
**出口条件:** 第 7 节发布门槛全部通过,无阻断或高优先级缺陷;最终候选包而非仅调试包通过安装、加载、输入、音频、保存恢复及退出冒烟。修复后重跑受影响用例;内核、时钟或存档格式变动须重跑对应完整测试集。
|
||||
**出口条件:** 第 7 节发布门槛全部通过,无阻断或高优先级缺陷;最终候选包而非仅调试包通过安装、加载、输入、音频、保存恢复及退出冒烟。修复后重跑受影响用例;内核、时钟或存档格式变动在开发时先做局部检查,冻结候选前补齐受影响的完整测试集,按 todo.md 分级规则复用仍有效证据。
|
||||
|
||||
### M9/1.0.0:正式交付
|
||||
|
||||
@@ -419,11 +422,11 @@ FCEUmm 上游声明采用 GNU GPL v2,并要求参考源文件头部细节,
|
||||
- [ ] 存档格式、内核升级兼容策略、升级安装记录和已知问题。
|
||||
- [ ] `LICENSE`、`THIRD_PARTY_NOTICES` 及对应依赖许可证材料。
|
||||
|
||||
只有 F01~F14 在约定范围内完成、发布指标通过且无阻断/高优先级缺陷时,才将应用标记为 1.0.0。
|
||||
只有 F01~F15 在约定范围内完成、发布指标通过且无阻断/高优先级缺陷时,才将应用标记为 1.0.0。
|
||||
|
||||
## 10. 首轮启动清单
|
||||
|
||||
首轮执行 M0 和 M1,先交付能安装、能加载原生库、能验证真实手柄输入的 0.1.x 诊断版。
|
||||
本节保留初始启动顺序。首轮执行 M0 和 M1,先交付能安装、能加载原生库、能验证真实手柄输入的 0.1.x 诊断版。
|
||||
|
||||
1. 建立 Android+JNI 最小工程,锁定工具链,生成首个可安装 APK。
|
||||
2. 确定应用 ID、依赖提交、基础数据目录及版本管理方式。
|
||||
@@ -433,3 +436,31 @@ FCEUmm 上游声明采用 GNU GPL v2,并要求参考源文件头部细节,
|
||||
6. 完成 M1 出口检查后,进入 M2 的 ROM 导入和 FCEUmm 接入。
|
||||
|
||||
首轮以设备与手柄实测为目标。首次音画完整的可玩验收在 M3,可靠日常使用验收在 M6~M7,正式发布在 M8~M9 全部门槛通过后进行。
|
||||
|
||||
## 11. F15 增补:内置内核选择(2026-09-14)
|
||||
|
||||
用户确认在应用内置的多个内核间切换,并反馈“龙珠英雄”无法打开、黑屏。本增补覆盖原设计中不提供
|
||||
内核切换的限制;仍不提供外部内核文件、在线下载或自动尝试所有内核。原 M0~M9 编号和已有验收证据
|
||||
保留,增加 XCORE 实现任务及 GCORE 门槛,纳入 G8 汇总。0.9.16 为开发验证版本,原工期估算不含本增补。
|
||||
|
||||
行为契约:初始默认 FCEUmm,可设 Nestopia 为默认;每个 ROM 可覆盖默认或恢复“跟随默认”。选择持久化,
|
||||
只在下次打开游戏时生效;旧会话先保存/卸载/销毁,再初始化所选内核。单次只运行一个内核实例。
|
||||
FCEUmm 保留原存档目录,Nestopia 使用独立目录;电池、即时存档、备份和异常恢复计数均隔离,跨内核
|
||||
状态与存档包拒绝导入。固定提交、具体目录和封装细节以依赖清单及 `docs/save-format.md` 为准。
|
||||
|
||||
| 任务 | 交付内容 | 前置 | 最小验收 |
|
||||
| --- | --- | --- | --- |
|
||||
| XCORE-01 | 固定 Nestopia 来源并接入双内核宿主、像素格式转换和打包 | 现有可构建的 M2/M3 接口 | L1:arm64 构建、必需入口、局部转换用例、全部库静态对齐 |
|
||||
| XCORE-02 | 默认和逐游戏选择、持久记录、下次加载生效及当前内核展示 | XCORE-01 | L1:应用编译,默认/覆盖/取消与磁盘重开读取的局部测试 |
|
||||
| XCORE-03 | 按内核隔离存档与恢复标记,校验存档包身份,保留旧 FCEUmm 数据 | XCORE-01、现有 M5 格式接口 | L1:旧路径、独立路径、包往返、跨内核拒绝、旧包归属 |
|
||||
| XCORE-04 | 在 Android 验证切换、重启持久化和独立进度 | XCORE-02、XCORE-03 | L2:同进程 FCEUmm→Nestopia→FCEUmm,一份带电池及一份无电池样本的相关分支 |
|
||||
| XCORE-05 | 定位“龙珠英雄”黑屏,按已确认哈希修正制式选择并记录双内核结果 | XCORE-04、具体 ROM 与目标手机;桌面复现可提前独立完成 | L1:精确匹配及选项隔离;L2:记录哈希/Mapper/区域/包与内核提交,分别验证加载、进入游戏、输入及音画 |
|
||||
|
||||
GCORE 为 L3 汇总门槛,依赖 XCORE-01~05;待办条目给出可勾选标准。开发时只运行受影响模块的局部
|
||||
检查和上述短路径;冻结候选时一次性补受影响内核的兼容集、H-AV、H-SAVE 和 H-NATIVE,已有仍有效证据
|
||||
按待办第 2 节复用。GCORE 与 G8 引用同一报告,不能各启动一轮重复测试。H-LONG/H-INPUT/H-UPGRADE
|
||||
保留原发布节点,只有相关证据失效或尚未取得时补齐。桌面测试和静态对齐通过不代替手机加载、16 KB 运行
|
||||
或具体游戏兼容结果。
|
||||
|
||||
接入证据见 [双内核报告](reports/core-selection-0.9.16.md),具体 ROM 的制式修复见
|
||||
[0.9.17 记录](reports/long-zhu-ying-xiong-0.9.17.md),任务状态只在 [todo.md](../todo.md) 勾选。
|
||||
|
||||
Reference in New Issue
Block a user