3.7 KiB
NESLite 可复现构建说明
本说明对应 0.9.12 候选基线。命令使用系统默认 PowerShell 7.6.6(pwsh)从仓库根目录执行;不需要手工复制 .so、
FCEUmm 或 Oboe 文件。
前置条件
-
安装或使用 toolchain.md 中的 JDK 17.0.17+10、SDK Platform 36.1、 NDK 28.2.13676358 与 Android CMake 3.22.1。
-
设置
JAVA_HOME指向 JDK 17;不能用系统默认的 JDK 21。 -
设置
ANDROID_HOME(或在未设置时使用本机记录的 SDK 根目录)。local.properties仅保存 本机sdk.dir,不提交。 -
首次构建需要访问 Google Maven、Maven Central 与 Gradle 分发服务,以取得已锁定版本。
-
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.12/。静态审计逐个检查 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 忽略。