关键词：AndroidStudio版本、AGP版本、Gradle版本、JDK版本、AndroidStudio与AGP版本对应关系、AGP与Gradle对应关系、Gradle与Java版本对应关系、Gradle与Kotlin版本对应关系
更新日期：2025年11月07日
一、Android Gradle 插件（AGP）和 Android Studio 兼容性
Android Studio 与 AGP 版本对应关系。
Android Studio 支持的 AGP 版本范围。
AS 支持的 AGP 最低版本。
注意：
Narwhal Feature Drop | 2025.1.2起，AGP 最小版本升到 4.0，不再支持 AGP 3.XNarwhal | 2025.1.1是最后一个支持 AGP 3.x 的版本。Flamingo | 2022.2.1是首个支持 APG 8.0 的版本
新版本
| Android Studio 版本 | 所需的 AGP 版本 |
|---|---|
| Otter | 2025.2.1 | 4.0 - 8.13 |
| Narwhal 4 Feature Drop | 2025.1.4 | 4.0 - 8.13 |
| Narwhal 3 Feature Drop | 2025.1.3 | 4.0 - 8.13 |
| Narwhal Feature Drop | 2025.1.2 | 4.0 - 8.12 |
| Narwhal | 2025.1.1 | 3.2 - 8.11 |
| Meerkat Feature Drop | 2024.3.2 | 3.2 - 8.10 |
| Meerkat | 2024.3.1 | 3.2 - 8.9 |
旧版
| Android Studio 版本 | 所需的 AGP 版本 |
|---|---|
| Ladybug Feature Drop| 2024.2.2 | 3.2 - 8.8 |
| Ladybug | 2024.2.1 | 3.2 - 8.7 |
| Koala Feature Drop | 2024.1.2 | 3.2 - 8.6 |
| Koala | 2024.1.1 | 3.2 - 8.5 |
| Jellyfish | 2023.3.1 | 3.2 - 8.4 |
| Iguana | 2023.2.1 | 3.2 - 8.3 |
| Hedgehog | 2023.1.1 | 3.2 - 8.2 |
| Giraffe | 2022.3.1 | 3.2 - 8.1 |
| Flamingo | 2022.2.1 | 3.2 - 8.0 |
| Electric Eel | 2022.1.1 | 3.2 - 7.4 |
| Dolphin | 2021.3.1 | 3.2 - 7.3 |
| Chipmunk | 2021.2.1 | 3.2 - 7.2 |
| Bumblebee | 2021.1.1 | 3.2 - 7.1 |
| Arctic Fox | 2020.3.1 | 3.1 - 7.0 |
二、Android Gradle 插件（AGP）对应 Grade 版本
新版本
| 插件版本 | 所需的最低 Gradle 版本 |
|---|---|
| 8.13 | 8.13 |
| 8.12 | 8.13 |
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
旧版
| 插件版本 | 所需的 Gradle 版本 |
|---|---|
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0+ | 6.7.1 |
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1+ |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
三、Gradle 版本与 Java、Kotlin 版本的对应关系
Gradle 版本与 JDK 版本的对应关系、Gradle 版本与 Kotlin 版本的对应关系。
Java 兼容性
| Java 版本 | 支持工具链 | 支持运行 Gradle |
|---|---|---|
| 8 | N/A | 2.0 to 8.14.* |
| 9 | N/A | 4.3 to 8.14.* |
| 10 | N/A | 4.7 to 8.14.* |
| 11 | N/A | 5.0 to 8.14.* |
| 12 | N/A | 5.4 to 8.14.* |
| 13 | N/A | 6.0 to 8.14.* |
| 14 | N/A | 6.3 to 8.14.* |
| 15 | 6.7 | 6.7 to 8.14.* |
| 16 | 7.0 | 7.0 to 8.14.* |
| 17 | 7.3 | 7.3 and after |
| 18 | 7.5 | 7.5 and after |
| 19 | 7.6 | 7.6 and after |
| 20 | 8.1 | 8.3 and after |
| 21 | 8.4 | 8.5 and after |
| 22 | 8.7 | 8.8 and after |
| 23 | 8.10 | 8.10 and after |
| 24 | 8.14 | 8.14 and after |
| 25 | 9.1.0 | 9.1.0 and after |
| 26 | N/A | N/A |
Kotlin 兼容性
Gradle 已使用 Kotlin 2.0.0 至 2.2.20 进行测试。Beta 版和 RC 版可能适用，也可能不适用。
| 嵌入式 Kotlin 版本 | 最低 Gradle 版本 | Kotlin 语言版本 |
|---|---|---|
| 1.3.10 | 5.0 | 1.3 |
| 1.3.11 | 5.1 | 1.3 |
| 1.3.20 | 5.2 | 1.3 |
| 1.3.21 | 5.3 | 1.3 |
| 1.3.31 | 5.5 | 1.3 |
| 1.3.41 | 5.6 | 1.3 |
| 1.3.50 | 6.0 | 1.3 |
| 1.3.61 | 6.1 | 1.3 |
| 1.3.70 | 6.3 | 1.3 |
| 1.3.71 | 6.4 | 1.3 |
| 1.3.72 | 6.5 | 1.3 |
| 1.4.20 | 6.8 | 1.3 |
| 1.4.31 | 7.0 | 1.4 |
| 1.5.21 | 7.2 | 1.4 |
| 1.5.31 | 7.3 | 1.4 |
| 1.6.21 | 7.5 | 1.4 |
| 1.7.10 | 7.6 | 1.4 |
| 1.8.10 | 8.0 | 1.8 |
| 1.8.20 | 8.2 | 1.8 |
| 1.9.0 | 8.3 | 1.8 |
| 1.9.10 | 8.4 | 1.8 |
| 1.9.20 | 8.5 | 1.8 |
| 1.9.22 | 8.7 | 1.8 |
| 1.9.23 | 8.9 | 1.8 |
| 1.9.24 | 8.10 | 1.8 |
| 2.0.20 | 8.11 | 1.8 |
| 2.0.21 | 8.12 | 1.8 |
| 2.2.0 | 9.0.0 | 2.2 |
| 2.2.20 | 9.2.0 | 2.2 |
数据来源：Gradle 兼容性说明
总结
由于 Android 应用的项目涉及到 AGP、Android Studio、Gradle、Java、Kotlin，再加上项目本身使用的 SDK 基本都会使用到 AndroidX 组件，而随着 AndroidX 组件迁移到 Kotlin 重写，其内的 SDK 又对 Kotlin 的版本有一定的要求，这就导致项目的整体 AGP 升级和 SDK 的升级面临重重困难，这需要我们对着以上所涉及内容的版本兼容性说明小心翼翼的修改。
如果有什么建议或者问题可以随时联系我，共同探讨学习：