Android Studio 4.0.1加依赖出Gradle错误,AGP已为4.0.1仍提示需升级
Android Studio 4.0.1 插件版本匹配类报错排查方案
- 核对AGP与Gradle的硬绑定版本
Android Gradle Plugin 4.0.1 对Gradle的最低适配要求为6.1.1,版本不匹配会连锁触发三类报错:即Gradle缺少所需方法、提示需要升级插件、需要重新应用Gradle插件:- 打开项目根目录下
gradle/wrapper/gradle-wrapper.properties文件,检查distributionUrl字段指向的Gradle版本,确保版本号≥6.1.1 - 修正字段为标准写法,例如
distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip,清理旧项目残留的Gradle 5.x、6.0.x等低版本配置
- 打开项目根目录下
- 排查AGP版本的多位置覆盖问题
多位置版本声明不一致,会导致IDE实际识别到的AGP版本低于4.0.1,触发虚假的升级提示:- 打开项目根目录下的项目级
build.gradle,检查buildscript块下的AGP依赖声明,确保依赖坐标为com.android.tools.build:gradle:4.0.1,不要使用.+类动态版本号、不要通过全局变量传递旧版本号 - 逐模块检查所有子模块的
build.gradle文件,确认没有在模块级buildscript块重复声明AGP依赖、单独指定旧版本号 - 检查项目根目录下是否存在
buildSrc模块、自定义Gradle插件逻辑,确认这类自定义内容中没有硬编码低于4.0.1的AGP版本要求
- 打开项目根目录下的项目级
- 调整依赖仓库的拉取优先级
仓库排序错误会导致实际无法拉取到4.0.1版本的AGP,被缓存的旧版本依赖替代:- 在项目级
build.gradle的buildscript块、allprojects块的仓库列表中,将google()(谷歌Maven仓库)放在列表最顶端 - 避免将版本缓存不全的第三方镜像、jcenter仓库放在首位,防止拦截4.0.1版本AGP的拉取请求
- 在项目级
- 清除IDE缓存触发全量配置重识别
旧缓存残留会导致IDE读取过期的配置信息,即便本地配置完全正确也会弹出版本升级提示:- 打开Android Studio菜单栏的
File > Invalidate Caches...,勾选全部清除选项后执行IDE重启 - 重启后通过本地路径重新打开项目,等待IDE完成项目结构全量扫描、依赖全量拉取后,再执行Gradle同步操作
- 打开Android Studio菜单栏的
完成以上操作后,即可在保持AGP 4.0.1配置不变的前提下,解决三类连锁报错,不需要盲目升级更高版本的AGP来适配当前版本的Android Studio。
内容的提问来源于stack exchange,提问作者Priyanka Nigam
相关产品推荐
相关产品推荐

