41 lines
2.9 KiB
Markdown
41 lines
2.9 KiB
Markdown
# 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`;这个脚本只检出固定提交,检测到已有
|
||
非锁定工作树会失败,不会覆盖它。
|