Gradle、AGP、JDK、API各版本插件匹配关系

创作时间:

作者:

@小白创作中心

Gradle、AGP、JDK、API各版本插件匹配关系

引用

CSDN

https://blog.csdn.net/hisrDT/article/details/143161024

本文整理了Android开发中各种工具的版本兼容性信息，包括Gradle、AGP（Android Gradle Plugin）、JDK、SDK Build Tools、Android Studio等。虽然文章内容详尽且对开发者具有参考价值，但需要注意的是，本文最后更新于2024年10月，部分信息可能已经过时。建议在实际开发中，以官方最新文档为准。

命令行设置Gradle版本

gradle wrapper --gradle-version 8.6

项目中设置Gradle版本

在gradle/wrapper/gradle-wrapper.properties文件中设置：

#distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
distributionUrl = https\://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip

Gradle、AGP（Android Gradle Plugin）版本匹配关系

AGP插件版本	最低 Gradle 版本	最小JDK	最小SDK Build Tools	备注
8.5	8.7
8.4	8.6
8.3	8.4
8.2	8.2
8.1	8.0
8.0	8.0	Java 17	30.0.2
7.4	7.5	Java 11	30.0.2
7.3	7.4	Java 11	30.0.2
7.2	7.3.3	Java 11	30.0.2
7.1	7.2	Java 11	30.0.2
7.0	7.0	Java 11	30.0.2
4.2.0+	6.7.1	Java 8	30.0.2
4.1.0+	6.5+	Java 8	29.0.2
4.0.0+	6.1.1+	Java 8	29.0.2
3.6.0 - 3.6.4	5.6.4+	Java 8	28.0.3
3.5.0 - 3.5.4	5.4.1+	Java 8	28.0.3
3.4.0 - 3.4.3	5.1.1+	Java 8	28.0.3
3.3.0 - 3.3.3	4.10.1+	Java 7	28.0.3
3.2.0 - 3.2.1	4.6+	Java 7	28.0.3
3.1.0+	4.4+	Java 7	27.0.3
3.0.0+	4.1+	Java 7	26.0.2
2.3.0+	3.3+	Java 7	25.0.0
2.1.3 - 2.2.3	2.14.1 - 3.5	Java 7	23.0.2	？
2.0.0 - 2.1.2	2.10 - 2.13	Java 7	21.1.1	？
1.5.0	2.2.1 - 2.13	Java 7	21.1.1
1.2.0 - 1.3.1	2.2.1 - 2.9	Java 7	21.1.1
1.0.0 - 1.1.3	2.2.1 - 2.3	Java 7	21.1.1

API、版本号、版本名称对应表

图1：Android API版本与代号对应表

图2：Android Studio版本与AGP版本对应表

Android Studio所需最小AGP版本

Android Studio 版本	所需的 AGP 版本	备注
瓢虫	2024 年 2 月 1 日	3.2-8.7
Koala 功能更新	2024 年 1 月 2 日	3.2-8.6
考拉	2024 年 1 月 1 日	3.2-8.5
水母	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 API级别所要求的最低工具版本

API 级别	最低 Android Studio 版本	最低 AGP 版本
VanillaIceCream 预览版	水母	2023 年 3 月 1 日
34	Hedgehog	2023.1.1
33	Flamingo	2022.2.1

Gradle、Kotlin插件、Kotlin语言版本匹配关系

Gradle版本	Kotlin插件版本	Kotlin语言版本
8.7	1.9.22	1.8
8.5	1.9.20	1.8
8.4	1.9.10	1.8
8.3	1.9.0	1.8
8.2	1.8.20	1.8
8.0	1.8.10	1.8
7.6	1.7.10	1.4
7.5	1.6.21	1.4
7.3	1.5.31	1.4
7.2	1.5.21	1.4
7.0	1.4.31	1.4
6.8	1.4.20	1.3
6.5	1.3.72	1.3
6.4	1.3.71	1.3
6.3	1.3.70	1.3
6.1	1.3.61	1.3
6.0	1.3.5	1.3
5.6	1.3.41	1.3
5.5	1.3.31	1.3
5.3	1.3.21	1.3
5.2	1.3.20	1.3
5.1	1.3.11	1.3
5.0	1.3.10	1.3