Files
NESLite/docs/toolchain.md
T

41 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](../third_party/manifest.json) 作为机器可读
锁文件保存。依赖获取执行 `tools/fetch-third-party.ps1`;这个脚本只检出固定提交,检测到已有
非锁定工作树会失败,不会覆盖它。