Contents
description bug_report

Using Flutter in China

Contents

To speed the download and installation of Flutter in China, consider using a mirror site or mirror.

Use a Flutter mirror site

The China Flutter User Group (CFUG) maintains a Simplified Chinese Flutter website https://flutter.cn and a mirror. Other mirrors can be found at the end of this guide.

Configure your machine to use a mirror site

To install or use Flutter in China, use a trustworthy Flutter mirror. This requires setting two environment variables on your machine.

All examples that follow presume that you are using the CFUG mirror.

To set your machine to use a mirror site:

This procedure requires using Powershell.

  1. Open a new window in Powershell to prepare running scripts.

  2. Set PUB_HOSTED_URL to your mirror site.

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

  3. Set FLUTTER_STORAGE_BASE_URL to your mirror site.

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

  4. Download the Flutter archive from your mirror site. In your preferred browser, go to Flutter SDK archive.

  5. Create a folder where you can install Flutter. then change into it.

    Consider a path like %USERPROFILE%\dev.

    C:\> New-Item -Path '`%USERPROFILE%\dev`' -ItemType Directory; cd `%USERPROFILE%\dev`

  6. Extract the the SDK from the zip archive file.

    This example assumes you downloaded the Windows version of the Flutter SDK.

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

  7. Add Flutter to your PATH environment variable.

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

  8. Run Flutter Doctor to verify your installation.

    C:\> flutter doctor

  9. Return to the setting up Flutter guide and continue from that procedure.

From this example, flutter pub get fetches packages from flutter-io.cn, in any terminal where you set PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL.

Any environment variables set using $env: in this procedure only apply to the current window.

To set these values on a permanent basis, set the enviroment variables as in the following example:

$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)

This procedure requires using your terminal.

  1. Open a new window in your terminal to prepare running scripts.

  2. Set PUB_HOSTED_URL to your mirror site.

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

  3. Set FLUTTER_STORAGE_BASE_URL to your mirror site.

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

  4. Download the Flutter archive from your mirror site. In your preferred browser, go to Flutter SDK archive.

  5. Create a folder where you can install Flutter. then change into it.

    Consider a path like ~/dev.

    $ mkdir ~/dev; cd `~/dev`

  6. Extract the the SDK from the zip archive file.

    This example assumes you downloaded the macOS version of the Flutter SDK.

    $ unzip flutter_macos_v3.13.0-stable.zip

  7. Add Flutter to your PATH environment variable.

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

  8. Run Flutter Doctor to verify your installation.

    $ flutter doctor

  9. Return to the setting up Flutter guide and continue from that procedure.

From this example, flutter pub get fetches packages from flutter-io.cn, in any terminal where you set PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL.

Any environment variables set using export in this procedure only apply to the current window.

To set these values on a permanent basis, append those three export commands to the *rc or *profile file that your preferred shell uses. This would resemble the following:

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

This procedure requires using your terminal.

  1. Open a new window in your terminal to prepare running scripts.

  2. Set PUB_HOSTED_URL to your mirror site.

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

  3. Set FLUTTER_STORAGE_BASE_URL to your mirror site.

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

  4. Download the Flutter archive from your mirror site. In your preferred browser, go to Flutter SDK archive.

  5. Create a folder where you can install Flutter. then change into it.

    Consider a path like ~/dev.

    $ mkdir ~/dev; cd `~/dev`

  6. Extract the the SDK from the tar.xz archive file.

    This example assumes you downloaded the Linux version of the Flutter SDK.

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

  7. Add Flutter to your PATH environment variable.

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

  8. Run Flutter Doctor to verify your installation.

    $ flutter doctor

  9. Return to the setting up Flutter guide and continue from that procedure.

From this example, flutter pub get fetches packages from flutter-io.cn, in any terminal where you set PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL.

Any environment variables set using export in this procedure only apply to the current window.

To set these values on a permanent basis, append those three export commands to the *rc or *profile file that your preferred shell uses. This would resemble the following:

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

This procedure requires using your terminal.

  1. Open a new window in your terminal to prepare running scripts.

  2. Set PUB_HOSTED_URL to your mirror site.

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

  3. Set FLUTTER_STORAGE_BASE_URL to your mirror site.

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

  4. Download the Flutter archive from your mirror site. In your preferred browser, go to Flutter SDK archive.

  5. Create a folder where you can install Flutter. then change into it.

    Consider a path like ~/dev.

    $ mkdir ~/dev; cd `~/dev`

  6. Extract the the SDK from the tar.xz archive file.

    This example assumes you downloaded the ChromeOS version of the Flutter SDK.

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

  7. Add Flutter to your PATH environment variable.

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

  8. Run Flutter Doctor to verify your installation.

    $ flutter doctor

  9. Return to the setting up Flutter guide and continue from that procedure.

From this example, flutter pub get fetches packages from flutter-io.cn, in any terminal where you set PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL.

Any environment variables set using export in this procedure only apply to the current window.

To set these values on a permanent basis, append those three export commands to the *rc or *profile file that your preferred shell uses. This would resemble the following:

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

Download Flutter archives based on a mirror site

To download Flutter from the SDK archive from a mirror, replace storage.googleapis.com with the URL of your trusted mirror. Use your mirror site in the browser or in other applications like IDM or Thunder. This should improve download speed.

The following example shows how to change the URL for Flutter’s download site from Google’s archive to CFUG’s mirror.

To download the Windows 3.13 version of the Flutter SDK, you would change the original URL from:

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

to the mirror URL:

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

To download the macOS 3.13 version of the Flutter SDK, you would change the original URL from:

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

to the mirror URL:

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

To download the Linux 3.13 version of the Flutter SDK, you would change the original URL from:

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

to the mirror URL:

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

To download the ChromeOS 3.13 version of the Flutter SDK, you would change the original URL from:

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

to the mirror URL:

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

Configure your machine to publish your package

To publish your packages to pub.dev, you need to be able to access both Google Auth and the pub.dev site.

To enable access to pub.dev:

  1. Configure a proxy. To configure a proxy, check out the Dart documentation on proxies.

  2. Verify that your PUB_HOSTED_URL environment variable is either unset or empty.

    $ echo $env:PUB_HOSTED_URL

    If this command returns any value, unset it.

    $ Remove-Item $env:PUB_HOSTED_URL

  1. Configure a proxy. To configure a proxy, check out the Dart documentation on proxies.

  2. Verify that your PUB_HOSTED_URL environment variable is either unset or empty.

    $ echo $PUB_HOSTED_URL

    If this command returns any value, unset it.

    $ unset $PUB_HOSTED_URL

  1. Configure a proxy. To configure a proxy, check out the Dart documentation on proxies.

  2. Verify that your PUB_HOSTED_URL environment variable is either unset or empty.

    $ echo $PUB_HOSTED_URL

    If this command returns any value, unset it.

    $ unset $PUB_HOSTED_URL

  1. Configure a proxy. To configure a proxy, check out the Dart documentation on proxies.

  2. Verify that your PUB_HOSTED_URL environment variable is either unset or empty.

    $ echo $PUB_HOSTED_URL

    If this command returns any value, unset it.

    $ unset $PUB_HOSTED_URL

To learn more about publishing packages, check out the Dart documentation on publishing packages.

Known, trusted community-run mirror sites

The Flutter team can’t guarantee long-term availability of any mirrors. You can use other mirrors if they become available.

China Flutter User Group

China Flutter User Group maintains the flutter-io.cn mirror. It includes the Flutter SDK and pub packages.

Configure your machine to use this mirror

To set your machine to use this mirror, use these commands.

On macOS, Linux, or ChromeOS:

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

On Windows:

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

Get support for this mirror

If you’re running into issues that only occur when using the flutter-io.cn mirror, report the issue to their issue tracker.

Shanghai Jiao Tong University *nix User Group

Shanghai Jiao Tong University *nix User Group maintains the mirror.sjtu.edu.cn mirror. It includes the Flutter SDK and pub packages.

Configure your machine to use this mirror

To set your machine to use this mirror, use these commands.

On macOS, Linux, or ChromeOS:

export PUB_HOSTED_URL=https://mirror.sjtu.edu.cn/flutter-infra;
export FLUTTER_STORAGE_BASE_URL=https://mirror.sjtu.edu.cn

On Windows:

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

Get support for this mirror

If you’re running into issues that only occur when using the mirror.sjtu.edu.cn mirror, report the issue to their issue tracker.

Tsinghua University TUNA Association

Tsinghua University TUNA Association maintains the mirrors.tuna.tsinghua.edu.cn mirror. It includes the Flutter SDK and pub packages.

Configure your machine to use this mirror

To set your machine to use this mirror, use these commands.

On macOS, Linux, or 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

On 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"

Get support for this mirror

If you’re running into issues that only occur when using the mirrors.tuna.tsinghua.edu.cn mirror, report the issue to their issue tracker.

Offer to host a new mirror site

If you’re interested in setting up your own mirror, contact flutter-dev@googlegroups.com for assistance.