# NESLite 可复现构建说明 本说明对应 0.9.12 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、 FCEUmm 或 Oboe 文件。 ## 前置条件 1. 安装或使用 [toolchain.md](toolchain.md) 中的 JDK 17.0.17+10、SDK Platform 36.1、 NDK 28.2.13676358 与 Android CMake 3.22.1。 2. 设置 `JAVA_HOME` 指向 JDK 17;不能用系统默认的 JDK 21。 3. 设置 `ANDROID_HOME`(或在未设置时使用本机记录的 SDK 根目录)。`local.properties` 仅保存 本机 `sdk.dir`,不提交。 4. 首次构建需要访问 Google Maven、Maven Central 与 Gradle 分发服务,以取得已锁定版本。 5. M2~M4 构建原生内核、音频和输入层前,运行: ```powershell .\tools\fetch-third-party.ps1 ``` 该脚本根据 `third_party/manifest.json` 检出固定提交;M4 构建需要 FCEUmm、libretro headers 与 Oboe。 ## 构建调试 APK ```powershell pwsh -NoProfile -File .\tools\check.ps1 -Scope Build ``` 产物为 `app/build/outputs/apk/debug/app-debug.apk`,其中只包含 `arm64-v8a` 的 `libneslite_jni.so`。调试包的 application ID 是 `org.neslite.app.debug`。 ## 有界检查入口 | 命令 | 范围 | 不会执行 | | --- | --- | --- | | `pwsh -NoProfile -File ./tools/check.ps1 -Scope Build` | 生成调试 APK | 单元、原生、实机、长测 | | `pwsh -NoProfile -File ./tools/check.ps1 -Scope Local` | Kotlin 本地单元测试 | APK、原生、实机、长测 | | `pwsh -NoProfile -File ./tools/check.ps1 -Scope Module` | 原生 smoke test 与 Kotlin 本地单测 | APK、实机、长测 | | `pwsh -NoProfile -File ./tools/check.ps1 -Scope Stage` | 当前 APK、原生 smoke test 与 Kotlin 本地单测 | 设备、ROM 兼容、耐久、H 专项 | `Stage` 是本地阶段入口,不是 G1~G9 的替代。实机、ROM、存档、插拔和耐久验收必须在 相应里程碑按 [acceptance.md](acceptance.md) 执行和记录。 ## 构建候选交付材料 先提交所有候选源码并保持工作区干净,然后执行: ```powershell pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\package-rc.ps1 ``` 脚本重跑 Stage 和 release lint,生成 `org.neslite.app` 的未签名 release APK、完整原生符号、应用及 三个固定第三方依赖的源码包、许可证/说明、静态原生审计、候选清单和 SHA-256。输出位于 `.build/rc-0.9.12/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 arm64-v8a 库。 默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离 环境签名并重新执行对齐/签名/设备检查。未签名包不能用于安装、覆盖升级或 G8 运行验收。 冻结的 12 个 CC0 最小 ROM 冒烟样本可用下列命令在忽略目录重建: ```powershell pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\generate-rc-roms.ps1 ``` 它们不包含游戏素材,也不能替代音画、滚屏、电池进度和长稳所需的合法代表游戏样本。设备长稳采集 入口为 `tools/collect-h-long.ps1`;默认 120 分钟、60 秒一次,只负责采集,不自动批准内存趋势。 ## M1 诊断版安装 连接并授权一台目标手机后执行: ```powershell pwsh -NoProfile -File .\tools\check-m1-device.ps1 ``` 脚本安装并启动 `0.1.3-debug` 诊断版;手柄操作和导出步骤见 [controller-x5lite.md](controller-x5lite.md)。连接多台设备时传入 `-Serial `。 ## 清理 只清理本工程生成物时删除 `build/`、`app/build/` 和 `.build/`;不要删除 SDK、NDK、 `.toolchains/` 或用户的签名密钥。上述输出均已被 Git 忽略。