Skip to main content
Contents

在中国使用 Flutter

Contents

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

使用 Flutter 镜像站点

#

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

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

#

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

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

要将您的机器设置为使用镜像站点：

此过程需要使用。

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

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

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

  3. 将FLUTTER_STORAGE_BASE_URL设置为您的镜像站点。

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

  4. 从您的镜像站点下载 Flutter 归档文件。 在您首选的浏览器中，访问 Flutter SDK 归档。

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

    考虑使用类似的路径。

    ; cd

  6. 从归档文件中解压 SDK。

    此示例假设您下载了 Flutter SDK 的Windows版本。

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

  8. 运行 Flutter Doctor 以验证您的安装。

     flutter doctor

  9. 返回设置 Flutter指南并继续该过程。

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

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

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

此过程需要使用。

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

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

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

  3. 将FLUTTER_STORAGE_BASE_URL设置为您的镜像站点。

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

  4. 从您的镜像站点下载 Flutter 归档文件。 在您首选的浏览器中，访问 Flutter SDK 归档。

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

    考虑使用类似的路径。

    ; cd

  6. 从归档文件中解压 SDK。

    此示例假设您下载了 Flutter SDK 的macOS版本。

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

  8. 运行 Flutter Doctor 以验证您的安装。

     flutter doctor

  9. 返回设置 Flutter指南并继续该过程。

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

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

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

此过程需要使用。

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

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

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

  3. 将FLUTTER_STORAGE_BASE_URL设置为您的镜像站点。

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

  4. 从您的镜像站点下载 Flutter 归档文件。 在您首选的浏览器中，访问 Flutter SDK 归档。

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

    考虑使用类似的路径。

    ; cd

  6. 从归档文件中解压 SDK。

    此示例假设您下载了 Flutter SDK 的Linux版本。

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

  8. 运行 Flutter Doctor 以验证您的安装。

     flutter doctor

  9. 返回设置 Flutter指南并继续该过程。

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

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

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

此过程需要使用。

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

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

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

  3. 将FLUTTER_STORAGE_BASE_URL设置为您的镜像站点。

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

  4. 从您的镜像站点下载 Flutter 归档文件。 在您首选的浏览器中，访问 Flutter SDK 归档。

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

    考虑使用类似的路径。

    ; cd

  6. 从归档文件中解压 SDK。

    此示例假设您下载了 Flutter SDK 的ChromeOS版本。

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

  8. 运行 Flutter Doctor 以验证您的安装。

     flutter doctor

  9. 返回设置 Flutter指南并继续该过程。

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

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

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

基于镜像站点下载 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

要下载 Linux 3.13 版本的 Flutter SDK，您需要将原始 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

要下载 ChromeOS 3.13 版本的 Flutter SDK，您需要将原始 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 的访问：

  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 镜像时才会出现的问题，请向其 问题跟踪器 报告问题。

Shanghai Jiao Tong University *nix User Group

#

Shanghai Jiao Tong University *nix User Group 维护 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 镜像时才会出现的问题，请向其 问题跟踪器 报告问题。

Tsinghua University TUNA Association

#

Tsinghua University TUNA Association 维护 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] 以获取帮助。

除非另有说明，否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。