Gradle版本、插件以及Android API对应关系

Android Studio 构建系统以 Gradle 为基础，而 Android Gradle 插件添加了几项专用于构建 Android 应用的功能。虽然 Android Gradle 插件 (AGP) 通常会与 Android 同步更新在 Studio 中，但插件（以及 Gradle 系统的其余部分）可以独立于 Android Studio，并且需要单独更新。

在这里我汇总了Android Gradle版本、插件以及Android API之间的对应关系，主要是为了自己后面方便查找，另外也希望能够给有需要的同学提供帮助。

可能有新同学会问，Gradle插件和Gradle插件版本怎么看，怎么配置，那么我这里也给出Android Studio中的Gradle插件和Gradle版本的查看方式，仅供参考。

Gradle插件版本,一般在项目根目录下的build.gradle中配置，如下：

新版Android Studio中的配置

plugins {
    id 'com.android.application' version '8.0.2' apply false
    id 'com.android.library' version '8.0.2' apply false
}

老版Android Studio中的配置

uildscript {
    repositories {
        ...
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.2.1'
    }
}

Gradle版本查看，一般是在项目根目录下的gradle/wrapper/gradle-wrapper.properties中查看，如下给出的Gradle版本就是8.0。

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

可能还有同学会问，Android Strdio不是图形化界面吗，怎么还要手动打开文件查看，是否有直接在Studio产看的方式，当然，答案是肯定的，查看方式：File -> Project Structure -> Project 中即可直接查看，如下图:

6c3fcff3839b4a52b557e8e728b0e5ed.png

好了，这下可以看Android API 、Gradle插件、版本以及Android Studio之间的对应关系了。

Gradle 插件和Gradle版本对应关系https://developer.android.google.cn/build/releases/gradle-plugin#updating-plugin

插件版本	所需的最低 Gradle 版本
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
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 Studio version	Required AGP version
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
Hedgehog 2023.1.1	3.2-8.2
Giraffe 2022.3.1	3.2-8.1
Flamingo 2022.2.1	3.2-8.0

Gradle版本、插件以及Android API对应关系

推荐阅读更多精彩内容