description bug_report

在中国使用 Flutter

内容

使用 Flutter 镜像站点
- 配置你的机器以使用镜像站点
- 根据镜像站点下载 Flutter 存档
配置你的机器以发布你的软件包
已知的、受信任的社区运营镜像站点
提供新的镜像网站

为了加速在中国的 Flutter 下载和安装，请考虑使用镜像网站或镜像。

使用 Flutter 镜像网站

中国 Flutter 用户组 (CFUG) 维护了一个简体中文 Flutter 网站 https://flutter.cn 和一个镜像。可以在本指南的末尾找到其他镜像。

配置您的计算机以使用镜像网站

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

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

将您的计算机设置为使用镜像网站

此过程需要使用 Powershell。

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

将 PUB_HOSTED_URL 设置为您的镜像网站。

C:\> $env:PUB_HOSTED_URL="https://pub.flutter-io.cn"

将 FLUTTER_STORAGE_BASE_URL 设置为您的镜像网站。

C:\> $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

从您的镜像网站下载 Flutter 存档。在您喜欢的浏览器中，转到 Flutter SDK 存档。
创建一个可以安装 Flutter 的文件夹，然后切换到该文件夹。

考虑类似 %USERPROFILE%\dev 的路径。
```
C:\> New-Item -Path '`%USERPROFILE%\dev`' -ItemType Directory; cd `%USERPROFILE%\dev`
```
从 zip 存档文件中提取 SDK。

此示例假定您下载了 Windows 版本的 Flutter SDK。
```
C:\> Extract-Archive: flutter_windows_v3.13.0-stable.zip
```

将 Flutter 添加到您的 PATH 环境变量。

C:\> $env:PATH = $pwd.PATH + "/flutter/bin",$env:PATH -join ";"

运行 Flutter Doctor 以验证您的安装。
```
C:\> flutter doctor
```
返回到设置 Flutter 指南并从该过程继续。

从这个示例中，flutter pub get 从 flutter-io.cn 获取包，在您设置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何终端中。

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

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

$newPath = $pwd.PATH + "/flutter/bin",$env:PATH -join ";"
[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)
    

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

在您的终端中打开一个新窗口以准备运行脚本。

将 PUB_HOSTED_URL 设置为您的镜像网站。

$ export PUB_HOSTED_URL="https://pub.flutter-io.cn"

将 FLUTTER_STORAGE_BASE_URL 设置为您的镜像网站。

$ export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

从您的镜像网站下载 Flutter 归档文件。在您首选的浏览器中，转到 Flutter SDK 归档文件。
创建一个可以安装 Flutter 的文件夹，然后切换到该文件夹。

考虑类似 ~/dev 的路径。
```
$ mkdir ~/dev; cd `~/dev`
```
从 zip 存档文件中提取 SDK。

此示例假定您下载了 macOS 版本的 Flutter SDK。
```
$ unzip flutter_macos_v3.13.0-stable.zip
```
将 Flutter 添加到您的 PATH 环境变量。
```
$ export PATH="$PWD/flutter/bin:$PATH"
```
运行 Flutter Doctor 以验证您的安装。
```
$ flutter doctor
```
返回到设置 Flutter 指南并从该过程继续。

从这个示例中，flutter pub get 从 flutter-io.cn 获取包，在您设置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何终端中。

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

要永久设置这些值，请将这三个 export 命令附加到您首选的 shell 使用的 *rc 或 *profile 文件中。这类似于以下内容

cat <<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
    

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

在您的终端中打开一个新窗口以准备运行脚本。

将 PUB_HOSTED_URL 设置为您的镜像网站。

$ export PUB_HOSTED_URL="https://pub.flutter-io.cn"

将 FLUTTER_STORAGE_BASE_URL 设置为您的镜像网站。

$ export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

从您的镜像网站下载 Flutter 归档文件。在您首选的浏览器中，转到 Flutter SDK 归档文件。
创建一个可以安装 Flutter 的文件夹，然后切换到该文件夹。

考虑类似 ~/dev 的路径。
```
$ mkdir ~/dev; cd `~/dev`
```
从 tar.xz 归档文件中提取 SDK。

此示例假定您下载了 Linux 版本的 Flutter SDK。
```
$ tar -xf flutter_linux_v3.13.0-stable.tar.xz
```
将 Flutter 添加到您的 PATH 环境变量。
```
$ export PATH="$PWD/flutter/bin:$PATH"
```
运行 Flutter Doctor 以验证您的安装。
```
$ flutter doctor
```
返回到设置 Flutter 指南并从该过程继续。

从这个示例中，flutter pub get 从 flutter-io.cn 获取包，在您设置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何终端中。

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

要永久设置这些值，请将这三个 export 命令附加到您首选的 shell 使用的 *rc 或 *profile 文件中。这类似于以下内容

cat <<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
    

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

在您的终端中打开一个新窗口以准备运行脚本。

将 PUB_HOSTED_URL 设置为您的镜像网站。

$ export PUB_HOSTED_URL="https://pub.flutter-io.cn"

将 FLUTTER_STORAGE_BASE_URL 设置为您的镜像网站。

$ export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

从您的镜像网站下载 Flutter 归档文件。在您首选的浏览器中，转到 Flutter SDK 归档文件。
创建一个可以安装 Flutter 的文件夹，然后切换到该文件夹。

考虑类似 ~/dev 的路径。
```
$ mkdir ~/dev; cd `~/dev`
```
从 tar.xz 归档文件中提取 SDK。

此示例假定您下载了 ChromeOS 版本的 Flutter SDK。
```
$ tar -xf flutter_linux_v3.13.0-stable.tar.xz
```
将 Flutter 添加到您的 PATH 环境变量。
```
$ export PATH="$PWD/flutter/bin:$PATH"
```
运行 Flutter Doctor 以验证您的安装。
```
$ flutter doctor
```
返回到设置 Flutter 指南并从该过程继续。

从这个示例中，flutter pub get 从 flutter-io.cn 获取包，在您设置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何终端中。

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

要永久设置这些值，请将这三个 export 命令附加到您首选的 shell 使用的 *rc 或 *profile 文件中。这类似于以下内容

cat <<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 下载网站的 URL 从 Google 的归档文件更改为 CFUG 的镜像。

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

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

更改为镜像 URL

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

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

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

更改为镜像 URL

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

要下载 Flutter SDK 的 Linux 3.13 版本，你需要将原始 URL 从

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

更改为镜像 URL

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

要下载 Flutter SDK 的 ChromeOS 3.13 版本，你需要将原始 URL 从

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

更改为镜像 URL

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

配置你的机器以发布你的软件包

要将你的软件包发布到 pub.dev，你需要能够同时访问 Google Auth 和 pub.dev 网站。

要启用对 pub.dev 的访问

配置代理。要配置代理，请查看 Dart 文档中的代理。
验证你的 PUB_HOSTED_URL 环境变量未设置或为空。
```
$ echo $env:PUB_HOSTED_URL
```
如果此命令返回任何值，请取消设置。
```
$ Remove-Item $env:PUB_HOSTED_URL
```

配置代理。要配置代理，请查看 Dart 文档中的代理。
验证你的 PUB_HOSTED_URL 环境变量未设置或为空。
```
$ echo $PUB_HOSTED_URL
```
如果此命令返回任何值，请取消设置。
```
$ unset $PUB_HOSTED_URL
```

配置代理。要配置代理，请查看 Dart 文档中的代理。
验证你的 PUB_HOSTED_URL 环境变量未设置或为空。
```
$ echo $PUB_HOSTED_URL
```
如果此命令返回任何值，请取消设置。
```
$ unset $PUB_HOSTED_URL
```

配置代理。要配置代理，请查看 Dart 文档中的代理。
验证你的 PUB_HOSTED_URL 环境变量未设置或为空。
```
$ echo $PUB_HOSTED_URL
```
如果此命令返回任何值，请取消设置。
```
$ unset $PUB_HOSTED_URL
```

要了解有关发布软件包的更多信息，请查看 Dart 文档中的发布软件包。

已知受信任的社区运营镜像网站

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

中国 Flutter 用户组

中国 Flutter 用户组维护 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 镜像时遇到仅在此镜像使用时才会出现的问题，请向其问题跟踪器报告问题。

清华大学开源协会

清华大学开源协会维护 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 镜像时遇到问题，请向其问题跟踪器报告问题。

提供托管新镜像网站

如果你有兴趣设置自己的镜像，请联系 [email protected] 以获得帮助。