2.9 KiB
2.9 KiB
M0 工具链与依赖锁定
记录日期:2026-09-12。构建和依赖版本只使用下表中的精确值;工程配置不允许
latest、+ 或浮动范围。
本机构建环境
| 项目 | 锁定版本 | 本机位置/状态 | 说明 |
|---|---|---|---|
| PowerShell | 7.6.6 | 系统默认 pwsh |
仅用于运行构建入口;不影响 APK 字节码或原生 ABI。 |
| JDK | Temurin 17.0.17+10 | E:\\Codex\\NESLite\\.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/M6 锁定,尚未引入 |
| 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;这个脚本只检出固定提交,检测到已有
非锁定工作树会失败,不会覆盖它。