Files
NESLite/docs/toolchain.md
T

2.9 KiB
Raw Blame History

M0 工具链与依赖锁定

记录日期:2026-09-12。构建和依赖版本只使用下表中的精确值;工程配置不允许 latest、+ 或浮动范围。

本机构建环境

项目 锁定版本 本机位置/状态 说明
PowerShell 7.6.6 系统默认 pwsh 用于运行打包.cmd;不影响 APK 字节码或原生 ABI。
JDK Temurin 17.0.17+10 E:\\Codex\\NESLite\\build\\toolchains\\jdk-17.0.17+10 供 Gradle/AGP 使用;系统默认 JDK 21 不用于本工程。
Android SDK Platform 36.1 C:\\Users\\shenw_o246oq4\\AppData\\Local\\Android\\Sdk\\platforms\\android-36.1 compileSdk = 36,AGP 8.13 可支持 API 36.1。
Android Build Tools 36.1.0 C:\\Users\\shenw_o246oq4\\AppData\\Local\\Android\\Sdk\\build-tools\\36.1.0 由 AGP 选择,不固定使用系统 37.0.0。
NDK 28.2.13676358 (r28c) C:\\Users\\shenw_o246oq4\\AppData\\Local\\Android\\Sdk\\ndk\\28.2.13676358 app/build.gradle.kts 中锁定。
Android CMake 3.22.1 C:\\Users\\shenw_o246oq4\\AppData\\Local\\Android\\Sdk\\cmake\\3.22.1 app/build.gradle.kts 中锁定;不使用系统 CMake 4.4.0-rc2。
AGP 8.13.2 Gradle version catalog 要求 Gradle 8.13 与 JDK 17。
Gradle Wrapper 8.13 gradle/wrapper/gradle-wrapper.properties 分发包 SHA-256 已锁定。
Kotlin 2.3.0 Gradle version catalog AGP 8.13.2 支持 Kotlin 2.3。

app/build.gradle.kts 同时将 Android Java source/target compatibility 和 Kotlin JVM toolchain 固定为 17, 避免 Gradle 运行时 JDK 影响 Kotlin/Java 目标版本的一致性。

SDK 管理器会提示其 XML 解析版本早于 Android Studio 安装的部分元数据;它仍可安装本项目锁定的 NDK 与 CMake。该提示不改变产物使用的具体版本,后续升级 SDK 管理器时必须重新记录。

应用与规划依赖

依赖 固定版本/提交 来源 许可证 当前状态
AndroidX Core KTX 1.17.0 Google Maven Apache-2.0 M0 已引入
AndroidX Activity KTX 1.12.0 Google Maven Apache-2.0 M0 已引入
Room 2.7.2 Google Maven Apache-2.0 M2 已引入
DataStore Preferences 1.1.7 Google Maven Apache-2.0 M4 已引入
FCEUmm 236ccdfc911e84c60fea6b9d0699c2d440a8de14 libretro/libretro-fceumm GPL-2.0-only M2 已编译并静态链接
libretro.h 0c9622896333ee62dc4326bbe8784a210ddeb03c libretro/RetroArch MIT M2 已引入
Oboe tag 1.10.0, commit a81bb9f87d4105b84b682685d3bfbb5beca371d1 google/oboe Apache-2.0 M3 已编译并静态链接

详细的 Git 来源和补丁数组由 third_party/manifest.json 作为机器可读 锁文件保存。依赖获取执行 tools/fetch-third-party.ps1;这个脚本只检出固定提交,检测到已有 非锁定工作树会失败,不会覆盖它。