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）。这通常更稳定。
- 升级组件以匹配新环境（适合新项目或升级）：如果您希望使用新版本 JDK 的特性，可以相应地升级项目的 AGP 和 Gradle 版本到支持该 JDK 的版本。注意，这可能会引起其他依赖库的兼容性问题，需要充分测试。
💎 总结与最佳实践
- 升级顺序：当需要升级整个开发环境时，建议按 JDK → Gradle → AGP → Android Studio 的顺序进行验证，逆向升级很容易出问题。
- 推荐使用 LTS JDK：为避免频繁升级，建议选择 JDK 17 或 JDK 21 等长期支持版本来进行 Android 开发。
- 保持编译版本最新：在项目的 build.gradle 中，compileSdkVersion 建议设置为最新的稳定版，这与 Android Studio 或 JDK 版本无直接依赖，但能确保你能使用最新的 API。
- 使用 Gradle Wrapper：对于不同的项目，强烈建议使用项目自带的 Gradle Wrapper（gradlew 脚本）来构建，它可以自动下载和管理正确的 Gradle 版本，实现项目间的环境隔离。