【Android】Android Studio 开发工具 / Android Gradle Plugin 插件 / Gradle 构建工具版本兼容问题 ( 2023 年 4 月 17 日更新 )

在开发时 , 建议将

• Android Studio
• Android Gradle Plugin
• Gradle 构建工具

都 升级成最新版本 , 新版本会兼容旧版本 ;

如果三者版本出现不兼容的情况 , 很容易出现各种奇怪的编译问题 ;

参考文档 : Android Gradle 插件版本说明 ;

一、Android Gradle Plugin 插件版本 与 所需的最低 Gradle 构建工具版本 对应关系

---

Android Gradle 插件在 Android Studio 工程根目录 下的 build.gradle 构建脚本中配置 , 其中 id 'com.android.application' version 和 id 'com.android.library' version 配置的就是 Android Gradle Plugin 插件的版本号 ;

plugins {
    id 'com.android.application' version '7.4.1' apply false
    id 'com.android.library' version '7.4.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.5.31' apply false
}

Gradle 构建工具在 " gradle/wrapper/gradle-wrapper.properties " 文件中配置 , 其中 distributionUrl 配置的就是 Gradle 构建工具的下载链接 ;

#Fri Apr 14 18:47:17 CST 2023
distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

Android Gradle 插件版本 与 所需的最低 Gradle 构建工具版本 对应关系 :

Android Gradle Plugin 插件版本	所需的最低 Gradle 构建工具版本
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
下面是 Android Gradle Plugin 插件 旧版本	下面是 所需的最低 Gradle 构建工具 旧版本
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 Plugin 插件版本 与 Android Studio 开发工具 对应关系

---

参考链接 : https://developer.android.google.cn/studio/releases/gradle-plugin?hl=zh-cn

Android Studio 版本	所需 Android Gradle 插件版本
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