# 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 已引入 | | 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](../third_party/manifest.json) 作为机器可读 锁文件保存。依赖获取执行 `tools/fetch-third-party.ps1`;这个脚本只检出固定提交,检测到已有 非锁定工作树会失败,不会覆盖它。