为加速在中国下载和安装 Flutter,请考虑使用 镜像站点镜像

使用 Flutter 镜像站点

#

China Flutter User Group (CFUG) 维护的简体中文 Flutter 网站 https://flutterdart.cn 以及一个镜像。其他镜像可以在 本指南的末尾找到。

配置您的机器以使用镜像站点

#

要在中国安装或使用 Flutter,请使用值得信赖的 Flutter 镜像。这需要在您的机器上设置两个环境变量。

以下所有示例都假定您正在使用 CFUG 镜像。

配置您的机器以使用镜像站点

此过程需要使用 Powershell。

  1. 在 Powershell 中打开一个新窗口,准备运行脚本。

  2. PUB_HOSTED_URL 设置为您的镜像站点。

    C:> $env:PUB_HOSTED_URL="https://pub.flutter-io.cn"
  3. FLUTTER_STORAGE_BASE_URL 设置为您的镜像站点。

    C:> $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
  4. 从您的镜像站点下载 Flutter 归档文件。在您喜欢的浏览器中,访问 Flutter SDK 归档

  5. 创建一个文件夹来安装 Flutter,然后进入该文件夹。

    可以考虑使用 %USERPROFILE%dev 这样的路径。

    C:> New-Item -Path '`%USERPROFILE%dev`' -ItemType Directory; cd `%USERPROFILE%dev`
  6. 从 zip 归档文件中提取 SDK。

    本示例假定您下载了 Windows 版 Flutter SDK。

    C:> Expand-Archive .\flutter_windows_3.13.0-stable.zip
  7. 将 Flutter 添加到您的 PATH 环境变量中。

    C:> $env:PATH = $pwd.PATH + "/flutter/bin",$env:PATH -join ";"
  8. 运行 Flutter Doctor 来验证您的安装。

    C:> flutter doctor

在此示例中,flutter pub get 将从 flutter-io.cn 获取包,在您设置了 PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL 的任何终端中。

在此过程中使用 $env: 设置的任何环境变量仅适用于当前窗口。

要永久设置这些值,请按照以下示例设置环境变量

# cd to flutter dir
$currentDirectory = Get-Location   
$newPath = "$currentDirectory\bin;$env:PATH"
[System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
[System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User')
[System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')

Write-Host ". $PROFILE"

此过程需要使用您的终端。

  1. 在终端中打开一个新窗口,准备运行脚本。

  2. PUB_HOSTED_URL 设置为您的镜像站点。

    export PUB_HOSTED_URL="https://pub.flutter-io.cn"
  3. FLUTTER_STORAGE_BASE_URL 设置为您的镜像站点。

    export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
  4. 从您的镜像站点下载 Flutter 归档文件。在您喜欢的浏览器中,访问 Flutter SDK 归档

  5. 创建一个文件夹来安装 Flutter,然后进入该文件夹。

    可以考虑使用 ~/dev 这样的路径。

    mkdir ~/dev; cd `~/dev`
  6. 从 zip 归档文件中提取 SDK。

    本示例假定您下载了 macOS 版 Flutter SDK。

    unzip flutter_macos_3.13.0-stable.zip
  7. 将 Flutter 添加到您的 PATH 环境变量中。

    export PATH="$PWD/flutter/bin:$PATH"
  8. 运行 Flutter Doctor 来验证您的安装。

    flutter doctor

在此示例中,flutter pub get 将从 flutter-io.cn 获取包,在您设置了 PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL 的任何终端中。

在此过程中使用 export 设置的任何环境变量仅适用于当前窗口。

要永久设置这些值,请将这三个 export 命令追加到您喜欢的 shell 所使用的 *rc*profile 文件中。这会类似于以下内容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

此过程需要使用您的终端。

  1. 在终端中打开一个新窗口,准备运行脚本。

  2. PUB_HOSTED_URL 设置为您的镜像站点。

    export PUB_HOSTED_URL="https://pub.flutter-io.cn"
  3. FLUTTER_STORAGE_BASE_URL 设置为您的镜像站点。

    export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
  4. 从您的镜像站点下载 Flutter 归档文件。在您喜欢的浏览器中,访问 Flutter SDK 归档

  5. 创建一个文件夹来安装 Flutter,然后进入该文件夹。

    可以考虑使用 ~/dev 这样的路径。

    mkdir ~/dev; cd `~/dev`
  6. 从 tar.xz 归档文件中提取 SDK。

    本示例假定您下载了 Linux 版 Flutter SDK。

    tar -xf flutter_linux_3.13.0-stable.tar.xz
  7. 将 Flutter 添加到您的 PATH 环境变量中。

    export PATH="$PWD/flutter/bin:$PATH"
  8. 运行 Flutter Doctor 来验证您的安装。

    flutter doctor

在此示例中,flutter pub get 将从 flutter-io.cn 获取包,在您设置了 PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL 的任何终端中。

在此过程中使用 export 设置的任何环境变量仅适用于当前窗口。

要永久设置这些值,请将这三个 export 命令追加到您喜欢的 shell 所使用的 *rc*profile 文件中。这会类似于以下内容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

此过程需要使用您的终端。

  1. 在终端中打开一个新窗口,准备运行脚本。

  2. PUB_HOSTED_URL 设置为您的镜像站点。

    export PUB_HOSTED_URL="https://pub.flutter-io.cn"
  3. FLUTTER_STORAGE_BASE_URL 设置为您的镜像站点。

    export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
  4. 从您的镜像站点下载 Flutter 归档文件。在您喜欢的浏览器中,访问 Flutter SDK 归档

  5. 创建一个文件夹来安装 Flutter,然后进入该文件夹。

    可以考虑使用 ~/dev 这样的路径。

    mkdir ~/dev; cd `~/dev`
  6. 从 tar.xz 归档文件中提取 SDK。

    本示例假定您下载了 ChromeOS 版 Flutter SDK。

    tar -xf flutter_linux_3.13.0-stable.tar.xz
  7. 将 Flutter 添加到您的 PATH 环境变量中。

    export PATH="$PWD/flutter/bin:$PATH"
  8. 运行 Flutter Doctor 来验证您的安装。

    flutter doctor

在此示例中,flutter pub get 将从 flutter-io.cn 获取包,在您设置了 PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL 的任何终端中。

在此过程中使用 export 设置的任何环境变量仅适用于当前窗口。

要永久设置这些值,请将这三个 export 命令追加到您喜欢的 shell 所使用的 *rc*profile 文件中。这会类似于以下内容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

基于镜像站点下载 Flutter 归档文件

#

要从 SDK 归档 中的镜像下载 Flutter,请将 storage.googleapis.com 替换为您信任的镜像的 URL。在浏览器或其他应用程序(如 IDM 或 Thunder)中使用您的镜像站点。这应该会提高下载速度。

以下示例显示了如何将 Flutter 下载站点从 Google 的归档更改为 CFUG 的镜像。

要下载 Flutter SDK 的 Windows 3.13 版本,您将把原始 URL 从

https://storage.googleapis.com/flutter_infra_release/releases/stable/windows/flutter_windows_3.13.0-stable.zip

更改为镜像 URL

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.13.0-stable.zip

要下载 Flutter SDK 的 macOS 3.13 版本,您将把原始 URL 从

https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.0-stable.zip

更改为镜像 URL

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.0-stable.zip

要下载 Flutter SDK 的 Linux 3.13 版本,您将把原始 URL 从

https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.13.0-stable.tar.xz

更改为镜像 URL

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/linux/flutter_linux_3.13.0-stable.tar.xz

要下载 Flutter SDK 的 ChromeOS 3.13 版本,您将把原始 URL 从

https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.13.0-stable.tar.xz

更改为镜像 URL

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/linux/flutter_linux_3.13.0-stable.tar.xz

配置您的机器以发布您的包

#

要将您的包发布到 pub.dev,您需要能够同时访问 Google Auth 和 pub.dev 站点。

启用对 pub.dev 的访问

  1. 配置代理。要配置代理,请查看 Dart 关于代理的文档

  2. 验证您的 PUB_HOSTED_URL 环境变量是否未设置或为空。

    echo $env:PUB_HOSTED_URL

    如果此命令返回任何值,请将其取消设置。

    Remove-Item $env:PUB_HOSTED_URL
  1. 配置代理。要配置代理,请查看 Dart 关于代理的文档

  2. 验证您的 PUB_HOSTED_URL 环境变量是否未设置或为空。

    echo $PUB_HOSTED_URL

    如果此命令返回任何值,请将其取消设置。

    unset $PUB_HOSTED_URL
  1. 配置代理。要配置代理,请查看 Dart 关于代理的文档

  2. 验证您的 PUB_HOSTED_URL 环境变量是否未设置或为空。

    echo $PUB_HOSTED_URL

    如果此命令返回任何值,请将其取消设置。

    unset $PUB_HOSTED_URL
  1. 配置代理。要配置代理,请查看 Dart 关于代理的文档

  2. 验证您的 PUB_HOSTED_URL 环境变量是否未设置或为空。

    echo $PUB_HOSTED_URL

    如果此命令返回任何值,请将其取消设置。

    unset $PUB_HOSTED_URL

要了解有关发布包的更多信息,请参阅 Dart 关于发布包的文档

已知、受信任的社区运行的镜像站点

#

Flutter 团队无法保证任何镜像的长期可用性。如果出现其他可用镜像,您可以使用它们。


China Flutter User Group

#

China Flutter User Group 维护着 flutter-io.cn 镜像。它包含 Flutter SDK 和 pub 包。

配置您的机器以使用此镜像

#

要配置您的机器以使用此镜像,请使用以下命令。

在 macOS、Linux 或 ChromeOS 上

export PUB_HOSTED_URL=https://pub.flutter-io.cn;
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

在 Windows 上

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn";
$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

获取此镜像的支持

#

如果您在使用 flutter-io.cn 镜像时遇到仅发生的问题,请在其 问题跟踪器 中报告该问题。


上海交通大学 *nix 用户组

#

上海交通大学 *nix 用户组 维护着 mirror.sjtu.edu.cn 镜像。它包含 Flutter SDK 和 pub 包。

配置您的机器以使用此镜像

#

要配置您的机器以使用此镜像,请使用以下命令。

在 macOS、Linux 或 ChromeOS 上

export PUB_HOSTED_URL=https://mirror.sjtu.edu.cn/dart-pub;
export FLUTTER_STORAGE_BASE_URL=https://mirror.sjtu.edu.cn

在 Windows 上

$env:PUB_HOSTED_URL="https://mirror.sjtu.edu.cn/dart-pub";
$env:FLUTTER_STORAGE_BASE_URL="https://mirror.sjtu.edu.cn"

获取此镜像的支持

#

如果您在使用 mirror.sjtu.edu.cn 镜像时遇到仅发生的问题,请在其 问题跟踪器 中报告该问题。


清华大学 TUNA 协会

#

清华大学 TUNA 协会 维护着 mirrors.tuna.tsinghua.edu.cn 镜像。它包含 Flutter SDK 和 pub 包。

配置您的机器以使用此镜像

#

要配置您的机器以使用此镜像,请使用以下命令。

在 macOS、Linux 或 ChromeOS 上

export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub;
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

在 Windows 上

$env:PUB_HOSTED_URL="https://mirrors.tuna.tsinghua.edu.cn/dart-pub";
$env:FLUTTER_STORAGE_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn/flutter"

获取此镜像的支持

#

如果您在使用 mirrors.tuna.tsinghua.edu.cn 镜像时遇到仅发生的问题,请在其 问题跟踪器 中报告该问题。

提供托管新的镜像站点

#

如果您有兴趣设置自己的镜像,请联系 flutter-dev@googlegroups.com 以获得帮助。