先介绍2个概念:
AGP:全称为Android Gradle Plugin,或称Android Gradle插件。通常配置在Android工程的根build.gradle中,例如:classpath 'com.android.tools.build:gradle:7.0.4'。
Gradle版本:通常配置在gradle-wrapper.properties中,例如:distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-all.zip。
AGP与Gradle版本有版本兼容关系,如果两者版本不兼容,会导致编译失败。
AGP与Gradle版本的兼容对照表
插件版本 | 所需的最低 Gradle 版本 |
---|---|
8.9 | 8.11.1 |
8.8 | 8.10.2 |
8.7 | 8.9 |
8.6 | 8.7 |
8.5 | 8.7 |
8.4 | 8.6 |
8.3 | 8.4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7.4 | 7.5 |
老版本:
插件版本 | 所需的 Gradle 版本 |
---|---|
7.3 | 7.4 |
7.2 | 7.3.3 |
7.1 | 7.2 |
7.0 | 7.0 |
4.2.0+ | 6.7.1 |
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 |
注:此对照表来源于官方的:https://developer.android.com/build/releases/gradle-plugin?hl=zh-cn#updating-gradle