有时在导入新项目时候,Android Studio会报Minimum supported Gradle version is 3.3. Current version is 2.14.1错误,原因是项目Gradle版本和Gradle插件版本对应不上。
Gradle是一个构建项目的工具,即把一堆堆的目录、文件按照一定的规则关联起来,形成一个项目的自动化构建工具。Gradle插件是针对Gradle发行版和Android SDK Build Tools封装的一个工具,它主要是调用Gradle的代码和批处理工具来构建项目,还可以调用Android SDK的编译打包功能。
在项目中,Gradle和Gradle版本是有一个对应关系的,具体关系可以在官方文档可以查看到,或者在文末的表格也可以查看,根据自己Gradle版本修改Gradle插件版本,或者根据Gradle插件版本修改Gradle版本。
修改Gradle版本应该在项目根目录中的build.gradle文件中修改,修改Gradle插件版本应在项目根目录gradle文件夹下的gradle-wrapper.properties文件中修改,具体文件位置与代码位置如下图所示。
// build.gradle 文件
dependencies {
// Gradle版本(修改后面的版本号就行)
classpath 'com.android.tools.build:gradle:3.6.3'
}
// gradle-wrapper.properties 文件
// Gradle插件版本(一样是修改版本号即可)
distributionUrl = https://services.gradle.org/distributions/gradle-5.6.4-all.zip
举个例子,当前我的插件版本是2.3,但是我的Gradle版本是2.14.1,根据表中的对应关系是对应不上,在编译的时候报错。这时我们可以保持Gradle插件版本不动,修改Gradle版本为3.3以上,或者保持Gradle版本不变,修改插件版本为2.1.3-2.2.3之间。
| 插件版本 | 所需Gradlw版本 |
|---|---|
| 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+ |