Android Gradle 插件与Gradle版本对应关系
下表列出了各个 Android Gradle 插件版本所需的 Gradle 版本。为了获得最佳性能,您应使用 Gradle 和插件这两者的最新版本。
插件版本 | 所需的 Gradle 版本 Kotlin版本 AS版本 |
---|---|
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+ |
2.3.0+ | 3.3+ |
3.0.0+ | 4.1+ |
3.1.0+ | 4.4+ |
3.2.0 - 3.2.1 | 4.6+ 1.2.51+ |
3.3.0 - 3.3.3 | 4.10.1+ 1.3.0+(rec:1.3.21) rec:3.3.2+ |
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+ |
更新 Android Gradle 插件
在更新 Android Studio 时,您可能会收到将 Android Gradle 插件自动更新为最新可用版本的提示。您可以选择接受该更新,也可以根据项目的构建要求手动指定版本。
您可以在 Android Studio 的 File > Project Structure > Project 菜单中指定插件版本,也可以在顶级 build.gradle
文件中进行指定。该插件版本适用于在相应 Android Studio 项目中构建的所有模块。以下示例从 build.gradle
文件中将插件的版本设置为 4.0.0:
buildscript {
repositories {
// Gradle 4.1 and higher include support for Google's Maven repo using
// the google() method. And you need to include this repo to download
// Android Gradle plugin 3.0.0 or higher.
google()
...
}
dependencies {
classpath 'com.android.tools.build:gradle:4.0.0'
}
}
注意:不应在版本号中使用动态依赖项(如 'com.android.tools.build:gradle:2.+'
),使用此功能可能会导致意外的版本更新和难以解析版本差异。
更新 Gradle
在更新 Android Studio 时,您可能会收到一并将 Gradle 更新为最新可用版本的提示。您可以选择接受该更新,也可以根据项目的构建要求手动指定版本。
您可以在 Android Studio 的 File > Project Structure > Project 菜单中指定 Gradle 版本,也可以通过在 gradle/wrapper/gradle-wrapper.properties
文件中修改 Gradle 分发引用来指定。以下示例在 gradle-wrapper.properties
文件中将 Gradle 的版本设置为 6.1.1。
...
distributionUrl = https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
...
Android Gradle插件各版本差异情况,请参考Android Gradle 插件版本说明 中各版本Release Note说明。