Android Studio（AS）、Android Gradle 插件（AGP）、Gradle、JDK 的对应关系
Android Studio 版本决定了其 AGP 版本范围，AGP 版本又决定了所需的 Gradle 版本，而 Gradle 版本最终决定了需要哪个 JDK
新版本的 Android Studio 通常兼容一个范围内的旧版 AGP，但旧版的 Android Studio 无法使用比它自身发布晚的新版 AGP。
📊 Android Studio 与 AGP 版本兼容性对照表
📊 AGP 版本与 Gradle 版本兼容性对照表
📊 Gradle 与 JDK 版本兼容性对照表
关键兼容性原则解读
- AGP 与 JDK 的硬性要求
- AGP 8.0 是一个重要的分水岭。从该版本开始，强制要求使用 JDK 17 或更高版本
- 如果您尝试将项目升级到 AGP 8.x，但本地环境仍使用 JDK 11 或 8，构建一定会失败。
- Gradle 与 JDK 的兼容性
- Gradle 本身对运行的 JVM 版本也有要求。例如，Gradle 7.x 系列最高支持到 JDK 17，而 Gradle 8.x 则能够支持 JDK 21 等更高版本
- 如果您在 Gradle 7.4 的环境下使用 Java 21，就会收到类似 'The maximum compatible Gradle JVM version is 17' 的错误提示。
如何查看当前版本？
- Android Studio 版本：在菜单栏中选择'Android Studio' → 'About Android Studio'。
- AGP 版本：查看项目根目录下的 build.gradle 文件中的 dependencies 块。
- Gradle 版本：查看 gradle/wrapper/gradle-wrapper.properties 文件中的 distributionUrl。
- Gradle 使用的 JDK：在 Android Studio 中，进入 File > Settings > Build, Execution, Deployment > Build Tools > Gradle，查看 Gradle JVM 设置。
如何解决版本冲突？
面对版本不兼容，通常有两个解决方向：
- 调整组件版本以匹配（推荐用于现有项目）：如果只是想快速让旧项目运行起来，最安全的方法是保持 AGP 和 Gradle 版本基本不变，而将 Gradle JVM 切换到项目兼容的 JDK 版本（例如 JDK 17）。这通常更稳定。
