Using Flutter in China

Ian Hickson edited this page Nov 1, 2018 · 14 revisions

(This page will be deleted on November 5th 2018; see for more recent information. When deleting this page, update bin/internal/ and the flutter tool.)

There's now a localized website for Flutter in China, here:

If you’d like to install Flutter using an installation bundle, you can replace the domain of the original URL with a trusted mirror to speed it up. For example:

You will still need to set up two environment variables to upgrade Flutter and use the pub package repository in China. Please follow the instructions below.

If you’re installing or using Flutter in China, it may be helpful to use a trustworthy local mirror site that hosts Flutter’s dependencies. To instruct the Flutter tool to use an alternate storage location, you will need to set two environment variables, PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL, before running the flutter command.

Taking MacOS or Linux as an example, here are the first few steps in the setup process for using a mirror site. Run the following in a Bash shell from the directory where you wish to store your local Flutter clone:

git clone -b dev
export PATH="$PWD/flutter/bin:$PATH"
cd ./flutter
flutter doctor

After these steps, you should be able to continue setting up Flutter normally. From here on, packages fetched by flutter packages get will be downloaded from in any shell where PUB_HOSTED_URL and FLUTTER_STORAGE_BASE_URL are set.

The server is a provisional mirror for Flutter dependencies and packages maintained by GDG China. The Flutter team cannot guarantee long-term availability of this service. You’re free to use other mirrors if they become available. If you’re interested in setting up your own mirror in China, please contact for assistance.

Known issue:

  • Running the Flutter Gallery app from source requires assets hosted on a domain this workaround currently doesn't support. You can subscribe to this bug to receive updates. In the meantime, you can check out Flutter Gallery from Google Play or third-party app stores you trust.

Other community-run mirror sites:

Please use these community mirror sites only if you trust the provider. The Flutter team cannot verify their reliability nor security.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.