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

韩曙亮

发布于 2023-04-24 11:21:38

3.9K0

发布于 2023-04-24 11:21:38

文章被收录于专栏：韩曙亮的移动开发专栏

在开发时 , 建议将

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