跳至主要内容
内容

在中国使用 Flutter

内容

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

使用 Flutter 镜像站点

#

中国Flutter用户组（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。

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

    C:> Expand-Archive .\flutter_windows_v3.13.0-stable.zip

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

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

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

    C:> flutter doctor

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

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

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

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

$newPath = "$pwd\flutter\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')

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

  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。

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

    unzip flutter_macos_v3.13.0-stable.zip

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

    export PATH="$PWD/flutter/bin:$PATH"

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

    flutter doctor

  9. 返回到 设置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

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

  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。

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

    tar -xf flutter_linux_v3.13.0-stable.tar.xz

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

    export PATH="$PWD/flutter/bin:$PATH"

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

    flutter doctor

  9. 返回到 设置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

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

  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。

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

    tar -xf flutter_linux_v3.13.0-stable.tar.xz

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

    export PATH="$PWD/flutter/bin:$PATH"

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

    flutter doctor

  9. 返回到 设置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或迅雷）中使用您的镜像站点。这应该可以提高下载速度。

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

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

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

  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团队无法保证任何镜像的长期可用性。如果其他镜像可用，您可以使用它们。

中国 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镜像时才会出现的错误，请将其报告到他们的 问题跟踪器。

清华大学 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镜像时才会出现的错误，请将其报告到他们的 问题跟踪器。

提供托管新镜像站点

#

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

除非另有说明，否则本网站上的文档反映了Flutter的最新稳定版本。页面上次更新于2024-06-26。 查看源代码 或 报告问题.