关键词：AndroidStudio版本、AGP版本、Gradle版本、JDK版本、AndroidStudio与AGP版本对应关系、AGP与Gradle对应关系、Gradle与Java版本对应关系、Gradle与Kotlin版本对应关系
更新日期：2025年07月01日
一、Android Gradle 插件（AGP）和 Android Studio 兼容性
Android Studio 与 AGP 版本对应关系。
Android Studio 支持的 AGP 版本范围。
AS 支持的 AGP 最低版本。
新版本
Android Studio 版本 |
所需的 AGP 版本 |
Narwhal | 2025.1.2 |
4.0-8.12 |
Narwhal | 2025.1.1 |
3.2-8.11 |
Meerkat | 2024.3.2 |
3.2 - 8.10 |
Meerkat | 2024.3.1 |
3.2 - 8.9 |
Ladybug | 2024.2.2 |
3.2 - 8.8 |
Ladybug | 2024.2.1 |
3.2 - 8.7 |
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 |
旧版
Android Studio 版本 |
所需的 AGP 版本 |
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 插件版本说明
二、Android Gradle 插件（AGP）对应 Grade 版本
新版本
插件版本 |
所需的最低 Gradle 版本 |
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 |
数据来源：Android Gradle 插件版本说明
三、Gradle 版本与 Java、Kotlin 版本的对应关系
Gradle 版本与 JDK 版本的对应关系、Gradle 版本与 Kotlin 版本的对应关系。
Java 兼容性
Java 版本 |
支持工具链 |
支持运行 Gradle |
8 |
不适用 |
2.0 |
9 |
不适用 |
4.3 |
10 |
不适用 |
4.7 |
11 |
不适用 |
5.0 |
12 |
不适用 |
5.4 |
13 |
不适用 |
6.0 |
14 |
不适用 |
6.3 |
15 |
6.7 |
6.7 |
16 |
7.0 |
7.0 |
17 |
7.3 |
7.3 |
18 |
7.5 |
7.5 |
19 |
7.6 |
7.6 |
20 |
8.1 |
8.3 |
21 |
8.4 |
8.5 |
22 |
8.7 |
8.8 |
23 |
8.10 |
8.10 |
24 |
8.14 |
8.14 |
25 |
N/A |
N/A |
Kotlin 兼容性
Gradle 已使用 Kotlin 1.6.10 至 2.0.20-Beta2 进行测试。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 |
数据来源：Gradle 兼容性说明
总结
由于 Android 应用的项目涉及到 AGP、Android Studio、Gradle、Java、Kotlin，再加上项目本身使用的 SDK 基本都会使用到 AndroidX 组件，而随着 AndroidX 组件迁移到 Kotlin 重写，其内的 SDK 又对 Kotlin 的版本有一定的要求，这就导致项目的整体 AGP 升级和 SDK 的升级面临重重困难，这需要我们对着以上所涉及内容的版本兼容性说明小心翼翼的修改。
如果有什么建议或者问题可以随时联系我，共同探讨学习：
- Github： likfe
- CSDN：他叫自己Mr.张
- 掘金：cafeting
- 微博：cafeting
