Files
NESLite/docs/build.md
T

3.7 KiB
Raw Blame History

NESLite 可复现构建说明

本说明对应 0.9.6 候选基线。命令使用系统默认 PowerShell 7.6.6(pwsh)从仓库根目录执行;不需要手工复制 .so、 FCEUmm 或 Oboe 文件。

前置条件

  1. 安装或使用 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 构建原生内核、音频和输入层前,运行:

    .\tools\fetch-third-party.ps1
    

    该脚本根据 third_party/manifest.json 检出固定提交;M4 构建需要 FCEUmm、libretro headers 与 Oboe。

构建调试 APK

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 执行和记录。

构建候选交付材料

先提交所有候选源码并保持工作区干净,然后执行:

pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\package-rc.ps1

脚本重跑 Stage 和 release lint,生成 org.neslite.app 的未签名 release APK、完整原生符号、应用及 三个固定第三方依赖的源码包、许可证/说明、静态原生审计、候选清单和 SHA-256。输出位于 .build/rc-0.9.6/。静态审计逐个检查 APK 内 .so 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 arm64-v8a 库。

默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离 环境签名并重新执行对齐/签名/设备检查。未签名包不能用于安装、覆盖升级或 G8 运行验收。

冻结的 12 个 CC0 最小 ROM 冒烟样本可用下列命令在忽略目录重建:

pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\generate-rc-roms.ps1

它们不包含游戏素材,也不能替代音画、滚屏、电池进度和长稳所需的合法代表游戏样本。设备长稳采集 入口为 tools/collect-h-long.ps1;默认 120 分钟、60 秒一次,只负责采集,不自动批准内存趋势。

M1 诊断版安装

连接并授权一台目标手机后执行:

pwsh -NoProfile -File .\tools\check-m1-device.ps1

脚本安装并启动 0.1.3-debug 诊断版;手柄操作和导出步骤见 controller-x5lite.md。连接多台设备时传入 -Serial <adb序列号>。

清理

只清理本工程生成物时删除 build/、app/build/ 和 .build/;不要删除 SDK、NDK、 .toolchains/ 或用户的签名密钥。上述输出均已被 Git 忽略。