简介

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

插件版本和gradle版本对应

gradle插件版本	gradle版本
1.0.0 - 1.1.3	2.2.1 - 2.3
1.2.0 - 1.3.1	2.2.1 - 2.9
1.5.0	2.2.1 - 2.13
2.0.0 - 2.1.2	2.10 - 2.13
2.1.3 - 2.2.3	2.14.1 - 3.5
2.3.0+	3.3+
3.0.0+	4.1+
3.1.0+	4.4+
3.2.0 - 3.2.1	4.6+
3.3.0 - 3.3.3	4.10.1+
3.4.0 - 3.4.3	5.1.1+
3.5.0 - 3.5.4	5.4.1+
3.6.0 - 3.6.4	5.6.4+
4.0.0+	6.1.1+
4.1.0+	6.5+
4.2.0+	6.7.1+
7.0	7.0+
7.1	7.2+
7.2	7.3.3+
7.4	7.3+
7.5	7.4+
8.0	8.0

Android Studio 对应的Gradle 插件版本

Android Studio 版本	所需插件版本
As 2.2.2	2.0.0 - 2.2.3
As 3.6	3.0 - 6.7.1
Arctic Fox | 2020.3.1	3.1-7.0
Bumblebee | 2021.1.1	3.2-7.1
Chipmunk | 2021.2.1	3.2-7.2
Dolphin | 2021.3.1	3.2-7.3
Electric Eel | 2022.1.1	3.2-7.4
Flamingo | 2022.2.1	3.2-8.0

重要版本更新

版本编号变更2020 年 11 月

我们将更新 Android Gradle 插件 (AGP) 的版本号以使其更接近底层 Gradle 构建工具。 重要变更如下

• AGP 现在将使用语义版本控制并且重大变更将在主要版本中发布。

• 每年将发布一个 AGP 主要版本与 Gradle 主要版本保持一致。

• AGP 4.2 之后的版本为版本 7.0并且会要求升级到 Gradle 7.x 版。AGP 的每个主要版本都会要求在底层 Gradle 工具中进行主要版本升级。

• API 的废弃将提前大约一年进行同时提供替代功能。废弃的 API 将在大约一年后的下次重大更新期间移除。

Gradle 7.3.02022 年 9 月

Android Gradle 插件 7.3.0 是一个主要版本包含各种新功能和改进。

最低版本	默认版本	备注
Gradle	7.4	7.4	如需了解详情请参阅更新 Gradle。
SDK Build Tools	30.0.3	30.0.3	安装或配置 SDK Build Tools。
NDK	不适用	23.1.7779620	安装或配置其他版本的 NDK。
JDK	11	11	如需了解详情请参阅设置 JDK 版本。

7.0.02021 年 7 月

最低版本	默认版本	备注
Gradle	7.0.2	7.0.2	如需了解详情请参阅更新 Gradle。
SDK Build Tools	30.0.2	30.0.2	安装或配置 SDK Build Tools。
NDK	不适用	21.4.7075529	安装或配置其他版本的 NDK。
JDK	11	11	如需了解详情请参阅设置 JDK 版本。

需要 JDK 11 才能运行 AGP 7.0

Variant API 已稳定

针对库依赖项提高了 lint 性能

lint 任务现在可以显示为“UP-TO-DATE”

移除了 Android Gradle 插件构建缓存

不支持在 Java 资源文件夹中添加原生库

与 1.4.x Kotlin 多平台插件不兼容

Android Gradle 插件 7.0.0 与 Kotlin 多平台插件 1.5.0 及更高版本兼容。使用 Kotlin 多平台支持的项目需要更新到 Kotlin 1.5.0 才能使用 Android Gradle 插件 7.0.0。解决方法之一是您可以将 Android Gradle 插件降级到 4.2.x不过建议不要这样做。

移除了依赖项配置 

在 AGP 7.0 中移除了以下配置或依赖项范围

• compile
  根据用例该配置已被 api 或 implementation 替换。
  同样适用于 *Compile 变体例如 debugCompile。

• provided
  该配置已被 compileOnly 替换。
  同样适用于 *Provided 变体例如 releaseProvided。

• apk
  该配置已被 runtimeOnly 替换。

• publish
  该配置已被 runtimeOnly 替换。

在大多数情况下AGP 升级助理会自动将您的项目迁移到新配置。

Gradle 4.2.02021 年 3 月

	最低版本	默认版本	备注
Gradle	6.7.1	不适用	如需了解详情请参阅更新 Gradle。
SDK Build Tools	30.0.2	30.0.2	安装或配置 SDK Build Tools。
NDK	不适用	21.4.7075529	安装或配置其他版本的 NDK。

新功能

此版本的 Android Gradle 插件包含以下新功能。

默认情况下使用 Java 语言版本 8

从 4.2 版本开始AGP 将默认使用 Java 8 语言级别。Java 8 提供对一些更新语言功能包括 lambda 表达式、方法引用和静态接口方法的访问权限。如需查看受支持功能的完整列表请参阅 Java 8 文档。

现在支持 v3 和 v4 签名

 Android Gradle 插件 4.2 现在支持 APK v3 和 APK v4 签名格式。 如需在 build 中启用这两种格式之一或同时启用这两种格式请将以下属性添加到模块级 build.gradle 或 build.gradle.kts 文件中

// build.gradle

android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}

通过 APK v4 签名您可以使用 Android 11 中的 ADB 增量 APK 安装快速部署大型 APK。此新标志负责部署过程中的 APK 签名步骤。

按变体配置应用签名

现在可以按变体在 Android Gradle 插件中启用或停用应用签名。

以下示例展示了如何在 Kotlin 或 Groovy 中使用 onVariants() 方法按变体设置应用签名

androidComponents {
    onVariants(selector().withName("fooDebug"), {
        signingConfig.enableV1Signing.set(false)
        signingConfig.enableV2Signing.set(true)
    })

gradle插件版本 和 gradle版本 介绍以及他们的对应关系

1.1 版本代码: 
	gradle版本: distributionUrl = https\://services.gradle.org/distributions/gradle-4.6-all.zip
	gradle插件版本: classpath 'com.android.tools.build:gradle:2.3.3'
	
1.2 位置
	gradle版本: 项目/gradle/wrapper/gradle-wrapper.properties 文件中
	gradle插件版本: 项目/build.gradle 文件中

总要地址

Android Gradle 插件版本说明  |  Android 开发者  |  Android Developers