Flutter项目执行assembleRelease构建任务失败如何解决?
问题原因
- Gradle构建过程中无法拉取到指定的Android构建工具依赖,涉及
com.android.tools.build:builder:4.1.0和com.android.tools.build:bundletool:0.14.0两个构件 - 国内用户绝大多数情况是网络限制导致无法正常访问谷歌官方maven源
- 少部分情况为本地Gradle缓存损坏、Android Gradle Plugin(AGP)与Gradle版本不匹配导致的依赖解析异常
解决方法
方案一:替换为国内镜像源(优先尝试)
修改Android目录下的两个配置文件:
- 打开
android/build.gradle,替换buildscript和allprojects下的repositories配置:
buildscript { ext.kotlin_version = '1.7.10' // 保持你自己项目的kotlin版本即可 repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/jcenter' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } dependencies { // 保持你原有配置的AGP版本不变即可,这里是4.1.0 classpath "com.android.tools.build:gradle:4.1.0" classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" } } allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/jcenter' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } }
- 打开
android/gradle/wrapper/gradle-wrapper.properties,替换gradle下载地址为国内镜像:
# AGP 4.1.0对应适配Gradle 6.5~6.7.1版本,不要修改为不兼容的版本 distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-6.7-all.zip
方案二:清理缓存重试
如果已经配置过镜像仍然报错,执行以下操作:
- 项目根目录执行
flutter clean清理项目本地缓存 - 删除当前用户根目录下的
.gradle/caches文件夹,清除全局Gradle缓存 - 重新执行构建命令即可
方案三:核对版本匹配
确认你项目的AGP版本和Gradle版本适配:AGP 4.1.0必须搭配6.5-6.7.1区间的Gradle版本,版本不兼容会直接导致依赖解析失败。
内容的提问来源于stack exchange,提问作者amir mohammad
相关产品推荐
相关产品推荐

