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

原创已于 2025-05-15 16:07:00 修改 · 2.8w 阅读

77 ·

CC 4.0 BY-SA版权

文章标签：

#gradle #android studio #android

于 2022-05-02 16:58:22 首次发布

android基础专栏收录该内容

37 篇文章

订阅专栏

本文详细介绍了Android Studio中Gradle与Gradle插件版本的匹配问题，包括如何查看和修改两者版本，以及如何解决因版本不兼容导致的编译错误。建议尽量使用高版本以获取更好的性能和修复的bug。提供了官方文档链接和匹配表格，指导开发者选择正确的版本组合。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

先打个小广告，最近在尝试出海项目，可以尝试一下我的第一个网站。

由于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)，如果遇到解决不了的问题，我们可以共同探讨：
在这里插入图片描述