跳至主要內容
目錄

在中國使用 Flutter

目錄

為了加快在中國下載和安裝 Flutter 的速度，請考慮使用鏡像站點或鏡像。

使用 Flutter 鏡像站點

#

中國 Flutter 使用者群組 (CFUG) 維護了一個簡體中文 Flutter 網站 https://flutter.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。

    此範例假設您下載了 Windows 版本的 Flutter SDK。

    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。

    此範例假設您下載了 macOS 版本的 Flutter SDK。

    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。

    此範例假設您下載了 Linux 版本的 Flutter SDK。

    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。

    此範例假設您下載了 ChromeOS 版本的 Flutter SDK。

    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 或 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. 設定 Proxy。若要設定 Proxy，請參閱關於 Proxy 的 Dart 文件。

  2. 確認您的 PUB_HOSTED_URL 環境變數未設定或為空。

    echo $env:PUB_HOSTED_URL

    如果此命令傳回任何值，請取消設定。

    Remove-Item $env:PUB_HOSTED_URL

  1. 設定 Proxy。若要設定 Proxy，請參閱關於 Proxy 的 Dart 文件。

  2. 確認您的 PUB_HOSTED_URL 環境變數未設定或為空。

    echo $PUB_HOSTED_URL

    如果此命令傳回任何值，請取消設定。

    unset $PUB_HOSTED_URL

  1. 設定 Proxy。若要設定 Proxy，請參閱關於 Proxy 的 Dart 文件。

  2. 確認您的 PUB_HOSTED_URL 環境變數未設定或為空。

    echo $PUB_HOSTED_URL

    如果此命令傳回任何值，請取消設定。

    unset $PUB_HOSTED_URL

  1. 設定 Proxy。若要設定 Proxy，請參閱關於 Proxy 的 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 鏡像時遇到才會發生的問題，請將問題回報至他們的問題追蹤器。

提供託管新的鏡像站點

#

如果您有興趣設定自己的鏡像，請聯絡 flutter-dev@googlegroups.com 以尋求協助。

除非另有說明，否則本網站上的文件均反映 Flutter 的最新穩定版本。頁面最後更新時間為 2024-06-26。 檢視來源 或 回報問題。