You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用本地编译Flutter引擎构建应用失败,Gradle依赖拉取超时及仓库配置疑问

使用本地编译Flutter引擎构建应用失败,Gradle依赖拉取超时及仓库配置疑问

兄弟,我前阵子用本地编译的Flutter引擎打包时也踩过一模一样的坑,给你拆解下问题根源和解决办法:

首先你遇到的超时错误本质是:Gradle还在死磕Google的Maven仓库拉取io.flutter:arm64_v8a_release依赖,但你的网络连不上Google服务器。而你明明用了本地编译的引擎,问题就出在Gradle没优先读取本地的Flutter Maven仓库,反而跑去远程找了。

下面是具体的排查和解决步骤:

1. 先明确本地引擎依赖的存放位置

你编译好的本地Flutter引擎,对应的Maven依赖包其实就存在你修改后的Flutter SDK目录里,路径大概是:
你的本地Flutter SDK路径/bin/cache/artifacts/engine/
里面会分不同平台(比如android-arm64)的文件夹,每个文件夹下都是标准的Maven仓库结构,包含你需要的arm64_v8a_release依赖。

2. 调整Gradle仓库的优先级

Gradle是按仓库的声明顺序查找依赖的,所以你得把本地Flutter Maven仓库放在最前面,确保Gradle先找本地,找不到再去远程。具体改这两个地方:

  • 项目根目录的build.gradle:找到allprojects下的repositories块,把本地仓库放在最顶部:
    allprojects {
        repositories {
            // 先加本地Flutter Maven仓库,路径根据你的SDK位置调整
            maven { url '../flutter/bin/cache/artifacts/engine' }
            // 然后是你的镜像仓库
            maven { url '你的镜像地址' }
            // 最后再放远程仓库(其实本地有了可以注释掉,避免多余请求)
            // google()
            // jcenter()
        }
    }
    
    注意路径要对应你的Flutter SDK位置,如果是Flutter项目,相对路径一般是../flutter;如果是单独的Android项目,就写绝对路径。
  • 检查local.properties:确保里面的flutter.sdk指向的是你修改后的本地Flutter SDK,而不是默认的官方SDK,不然Gradle还是会用默认配置去远程拉取。

3. 别用动态版本号,直接指定本地依赖版本

你当前的依赖用的是io.flutter:arm64_v8a_release:+,这个+会让Gradle去远程仓库找最新版本,哪怕本地已经有了。解决办法是:

  • 去本地Flutter Maven仓库的arm64_v8a_release文件夹里,打开maven-metadata.xml,找到里面的具体版本号(比如1.0.0-xxxxxx,xxxxxx是你编译引擎的哈希值)。
  • 在app/build.gradle的dependencies里,把依赖改成固定版本:
    implementation 'io.flutter:arm64_v8a_release:1.0.0-xxxxxx'
    
    这样Gradle就不会再去远程找版本了,直接用本地的。

4. 清理Gradle缓存,强制刷新依赖

有时候Gradle会缓存之前的仓库配置,执行下面的命令(在项目根目录):

./gradlew clean build --refresh-dependencies

这个命令会清理旧缓存,强制Gradle重新读取你的仓库配置和依赖。

最后说下为什么你配置了镜像还是会去Google:因为io.flutter的专属依赖只有Flutter本地仓库和Google Maven仓库有,国内镜像一般不会同步这些包,所以Gradle在本地找不到的话,就会 fallback 到Google仓库,导致超时。核心就是让Gradle优先找到本地的依赖。

内容来源于stack exchange

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.07 10:58:07