AndroidStudio、AGP、Gradle、JDK 版本对应关系

关键词：AndroidStudio版本、AGP版本、Gradle版本、JDK版本、AndroidStudio与AGP版本对应关系、AGP与Gradle对应关系、Gradle与Java版本对应关系、Gradle与Kotlin版本对应关系

更新日期：2025年07月02日

一、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.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
Giraffe | 2022.3.1	3.2-8.1
Flamingo | 2022.2.1	3.2-8.0

旧版

Android Studio 版本	所需的 AGP 版本
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
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 的升级面临重重困难，这需要我们对着以上所涉及内容的版本兼容性说明小心翼翼的修改。