Android Gradle 插件对应的 Gradle 版本

帅次

已于 2025-02-28 14:01:44 修改

阅读量1.2w

点赞数 7

分类专栏： Android 基础梳理文章标签： gradle android android studio androidx appcompat adb android jetpack

于 2021-06-23 16:06:56 首次发布

本文链接：https://blog.csdn.net/g984160547/article/details/118155389

版权

Android 基础梳理专栏收录该内容

45 篇文章

订阅专栏

一、Android Gradle 插件和 Gradle 版本兼容性

二、检查和更新 Android Gradle 插件(AGP)

三、检查和更新 Gradle 版本

四、示例

五、Android Gradle 插件和 Android Studio 兼容性

六、国内镜像(腾讯云/华为云)

七、下载Gradle到本地

一、Android Gradle 插件和 Gradle 版本兼容性

Android Gradle 插件（AGP）版本与相应 Gradle 版本的兼容性列表。确保你使用的 Gradle 版本与 AGP 版本兼容是解决构建问题的重要步骤。

插件版本	需要的 Gradle 版本
8.7	8.9
8.5 - 8.6	8.7
8.4	8.6
8.3	8.4
8.2	8.2
8.0 - 8.1	8.0
7.0.0 - 7.4.2	7.0 - 7.5
4.2.0 - 4.2.2	6.7.1 - 6.8.3
4.1.0 - 4.1.3	6.5 - 6.7.1
4.0.0 - 4.0.2	6.1.1 - 6.5
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版本（我自己也没记住，总要去网上扒好久），咱们今天就把这个给全弄过来，方便于查看。

Android Studio 构建系统以Gradle为基础，并且 Android Gradle 插件添加了几项专用于构建 Android 应用的功能。虽然 Android 插件通常会与Android Studio的更新步调保持一致，但插件（以及 Gradle 系统的其余部分）可独立 Android Studio运行并单独更新。

本页将介绍如何让Gradle工具保持最新状态，以及最近的更新包含哪些内容。

如需详细了解如何使用Gradle配置Android build，可参阅Android-Gradle详解。

二、检查和更新 Android Gradle 插件(AGP)

在更新 Android Studio 时，你可能会收到将 Android Gradle 插件自动更新为最新可用版本的提示。你可以选择接受该更新，也可以根据项目的构建要求手动指定版本。

确保在 Demo/gradle/wrapper/build.gradle 文件中设置正确的 AGP(Android Gradle Plugin 的缩写，中文全称是 Android Gradle 插件) 版本：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.2.0'
    }
}

注意：不应在版本号中使用动态依赖项（如 'com.android.tools.build:gradle:4.+'）。使用此功能可能会导致意外的版本更新和难以解析版本差异。

三、检查和更新 Gradle 版本

确保在 Demo/gradle/wrapper/gradle-wrapper.properties 文件中设置了正确的 Gradle 版本：

#Mon Jul 15 16:01:16 CST 2024
distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

四、示例

上面我们使用的 AGP 是 4.2.0，对应的 Gradle 版本是 6.7.1。

现在我们使用 AGP 是 7.4.2，对应 Gradle 版本是 7.5。设置如下：

4.1 设置 gradle-wrapper.properties 文件

4.2 设置 build.gradle 文件

五、Android Gradle 插件和 Android Studio 兼容性

Android Studio 构建系统以 Gradle 为基础，并且 Android Gradle 插件 (AGP) 添加了几项专用于构建 Android 应用的功能。下表列出了各个 Android Studio 版本所需的 AGP 版本。

Android Studio 版本	AGP 版本
瓢虫 \| 2024.2.1 Ladybug \| 2024.2.1	3.2 - 8.7
Koala 功能更新 \| 2024.1.2 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
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

六、国内镜像(腾讯云/华为云)

腾讯云镜像地址：https://mirrors.cloud.tencent.com/gradle/

华为云镜像地址：https://mirrors.huaweicloud.com/gradle/

配置方法：在项目的gradle/wrapper/gradle-wrapper.properties文件中，将distributionUrl替换为国内的镜像地址。例如：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.3-all.zip

七、下载Gradle到本地

gradle可能会由于网络原因下载失败。这个时候我们可以首先下载后gradle，然后再配置。
- 下载地址：https://blog.csdn.net/ii950606/article/details/109105402
把减压好的gradle随便减压到一个目录，然后配置distributionUrl 为本地路径。
点击File->Sync Project with Gradle files