Flutter 替换镜像源

一、核心镜像替换(针对 Maven 仓库)

Flutter 依赖的 Google Maven 仓库(https://maven.google.comhttps://dl.google.com/dl/android/maven2)可替换为国内镜像,常见的有:

  1. 阿里云镜像 (推荐)

    将 Google 仓库替换为:
    https://maven.aliyun.com/repository/google

  2. 华为云镜像

    替换为:
    https://repo.huaweicloud.com/repository/maven/

二、具体配置方法

  1. 全局 Gradle 配置(推荐,影响所有项目)

修改 Gradle 全局配置文件,让所有 Flutter/Android 项目默认使用镜像:

  • WindowsC:\Users\<你的用户名>\.gradle\gradle.properties

  • Mac/Linux~/.gradle/gradle.properties

在文件中添加以下内容(配置代理和镜像):

复制代码
# 阿里云镜像配置
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }

# 若需要代理(可选)
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=你的代理端口
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=你的代理端口
  1. 项目级配置(仅当前项目生效)

如果只想针对单个 Flutter 项目修改,需编辑项目中的 Gradle 配置:

  1. 打开 Flutter 项目目录下的 android/build.gradle 文件。

  2. 找到 allprojects 块中的 repositories,替换 Google 仓库地址:

    allprojects {
    repositories {
    // 替换原 Google 仓库
    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://maven.aliyun.com/repository/jcenter' }
    mavenCentral()
    // 保留其他必要仓库(如本地仓库)
    maven { url "$flutterRoot/packages/flutter_tools/gradle/maven_repo" }
    jcenter() { url "https://maven.aliyun.com/repository/jcenter" }
    }
    }

  3. Flutter 引擎镜像(针对 flutter doctor 检查的引擎资源)

flutter doctor 卡在下载 Flutter 引擎(如 https://storage.googleapis.com/ 相关资源),可配置 Flutter 镜像源:

  • 临时生效(每次终端执行):

    复制代码
    # 阿里云 Flutter 镜像
    export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
    export PUB_HOSTED_URL=https://pub.flutter-io.cn
  • 永久生效(推荐):

    • Windows:在 "环境变量" 中添加上述两个变量(值同上)。

    • Mac/Linux:编辑 ~/.bash_profile~/.zshrc,添加上述两行,然后执行 source ~/.bash_profile(或对应配置文件)生效。

三、验证配置是否生效

  1. 执行 flutter clean 清除缓存。

  2. 重新运行 flutter doctor,观察是否仍有 Google API 相关错误。

  3. 若涉及项目依赖下载,可执行 flutter pub getcd android && ./gradlew clean(Mac/Linux)/ gradlew clean(Windows)测试。

四、注意事项

  1. 镜像源可能存在同步延迟,若某镜像失效,可尝试切换其他镜像(如华为云、腾讯云镜像)。

  2. 部分特殊依赖(如 Google Play 服务相关)可能必须访问官方仓库,此时需配合合规代理使用。

  3. 配置后若出现依赖冲突,可删除项目的 android/.gradle 缓存目录后重试。

通过以上配置,大部分 flutter doctor 中的 Google API 访问问题均可解决。

相关推荐
wordbaby42 分钟前
Flutter列表渲染的"诡异"问题:为什么我的数据总是第一个?
前端·flutter
恋猫de小郭1 小时前
谷歌开启 Android 开发者身份验证,明年可能开始禁止“未经验证”应用的侧载,要求所有开发者向谷歌表明身份
android·前端·flutter
苏元17 小时前
Flutter + GetX:Dio 多接口 401 拦截后跳登录,避免重复跳转和 Controller 找不到问题
flutter
Mhua_Z19 小时前
使用 flutter_tts 的配置项
flutter
你听得到1121 小时前
弹窗库1.1.0版本发布!不止于统一,更是全面的体验升级!
android·前端·flutter
RaidenLiu21 小时前
Riverpod 3 :掌握异步任务处理与 AsyncNotifier
前端·flutter
无知的前端1 天前
Flutter 模型转JSON跳过零值/null
flutter·json
jiushiapwojdap2 天前
Flutter上手记:为什么我的按钮能同时在iOS和Android上跳舞?[特殊字符][特殊字符]
android·其他·flutter·ios
木子雨廷2 天前
Flutter 局部刷新小组件汇总
前端·flutter
恋猫de小郭2 天前
iOS 26 正式版即将发布,Flutter 完成全新 devicectl + lldb 的 Debug JIT 运行支持
android·前端·flutter