彻底解决Android Studio Minimum supported Gradle version is X.Y.Z. Current version is x.y.z.问题

文章目录

1. Gradle 插件版本
2. Gradle 版本
3. Gradle 与Gradle Plugin兼容搭配
4. 我哪里寻找`Gradle`版本和`Gradle plugin`版本
5. 总结

由于Android Studio 是基于Gradle 编译的，面对众多的Gradle版本，类似于Android碎片化的概念，在编译项目上或多或少会存在兼容性问题。如题，

Minimum supported Gradle version is 6.1.1. Current version is 5.6.4...,
Minimum supported Gradle version is 6.7.1. Current version is 5.6. If using the gradle wrapper, try editing the distributionUrl in....

等等类似的问题，都可以归结到Gradle版本插件和 Gradle版本上兼容性问题。

1. Gradle 插件版本

在项目的根目录下存在一个build.gradle文件：

然后你打开这个文件，在 dependencies下面可以看到：

此时可以看到我们当前使用的Gradle plugin版本为4.2.2。

2. Gradle 版本

打开Android Studio --> File --> Project Structure..., 接可以找到Gradle的版本：

找到Project项：

此时你可以看到当前 gradle的版本是 6.8,当前(22年5月2日)时间gradle最新版本为7.4.2, 可以查询到的网站为https://gradle.org/releases/ 里面存在所有的历史可用的版本

3. Gradle 与Gradle Plugin兼容搭配

由于Gradle设计之处并未很好的考虑到兼容性，所有有些Gradle版本之间就不兼容，更别谈Gradle Plugin之间的问题了。那么合适的Gradle版本和Gradle Plugin之间应该什么样的对应关系呢？

其实这个问题早在Google开发者文档中存在了，地址为

https://developer.android.com/studio/releases/gradle-plugin。

我今天就把这个表摘抄出来：

插件版本	所需的Gradle版本
1.0.0 - 1.1.3	2.2.1 - 2.3
1.2.0 - 1.3.1	2.2.1 - 2.0
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.6.0 - 3.6.4	5.6.4 +
4.0.0 +	6.1.1 +
4.2.0 +	6.7.1 +
7.0	7.0 +
7.1	7.2+
7.2	7.3+

所以当我们遇到以上问题时，无非就是两种解决方案：

修改 Gradle plugin版本，然后来适配Gradle版本；
修改 Gradle版本，然后来适配Gradle plugin版本。

至于怎么修改，是需要基于你们团队的意愿和个人想法了。不过我给出的想法是，尽量把Gradle和Gradle Plugin版本提高到高版本，因为高版本可能修复了低版本的bug，同时在编译做了很多优化，可以明显缩短我们编译的时间，提高开发效率。

比如我现在项目中 Gradle plugin版本是 4.2.2， Gradle版本是6.8, 正好落在匹配兼容的区间，所以是可以顺利编译通过的。

我另外一个项目的配置是：

同样也是在这个表中，符合预期的。

4. 我哪里寻找`Gradle`版本和`Gradle plugin`版本

其实上面已经说过，关于Gradle版本，可以直接在其官网查找：

https://gradle.org/releases/

我们可以看一下：

那么对于Gradle plugin版本哪里找呢？其实也可以找到，我们可以在在 Maven仓库中搜索：

https://mvnrepository.com/

然后搜索到 com.android.tools.build:

打击打开，找到Google项：

找到与我们Gradle匹配的项,点击进入然后直接复制即可用了：

5. 总结

这个应该算得上一个比较基础性的问题，其实你在每次升级Android Studio时，将Gradle和Gradle plugin版本同时升级一次就可以了。这里做个记录，算是对这个问题的终结的答复了，如果你在开发的过程中，也存在类似的问题，不妨也尝试尝试我这种方式，看看是否可以解决您的问题。下面是我的微信(备注Gradle)，如果遇到解决不了的问题，我们可以共同探讨：