跳到主內容

手動安裝 Flutter

瞭解如何手動安裝和設定 Flutter SDK。

瞭解如何手動安裝和配置您的 Flutter 開發環境。

選擇你的開發平臺

#

本頁面上的說明適用於在 Windows 裝置上安裝 Flutter。

如果你想遵循其他作業系統的說明,請選擇以下之一。

下載先決軟體

#

在安裝 Flutter SDK 之前,請先完成以下設定。

  1. 安裝適用於 Windows 的 Git

    下載並安裝最新版適用於 Windows 的 Git

    有關安裝或故障排除 Git 的幫助,請參閱 Git 文件

  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE

  1. 安裝 Xcode 命令列工具

    下載 Xcode 命令列工具以訪問 Flutter 依賴的命令列工具,包括 Git。

    要下載這些工具,請在你喜歡的終端中執行以下命令

    xcode-select --install
    

    如果你尚未安裝這些工具,將彈出一個對話方塊,確認你是否要安裝它們。單擊 安裝,安裝完成後,單擊 完成

  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE

  1. 下載並安裝先決軟體包

    使用你偏好的包管理器或機制,安裝以下軟體包的最新版本

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    在基於 Debian 的發行版(如 Ubuntu)上,使用 apt-get,請使用以下命令安裝這些軟體包

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
    
  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE

  1. 設定 Linux 支援

    如果你之前未在 Chromebook 上設定 Linux 支援,請開啟 Linux 支援

    如果你已經開啟了 Linux 支援,請按照解決 Linux 問題的說明進行更新。

  2. 下載並安裝先決軟體包

    使用 apt-get 或你喜歡的安裝機制,安裝以下軟體包的最新版本

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    如果你想使用 apt-get,請使用以下命令安裝這些軟體包

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
    
  3. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE

安裝並設定 Flutter

#

要安裝 Flutter SDK,請從 SDK 存檔中下載最新的壓縮包,然後將其解壓到您希望存放的位置。

  1. 下載 Flutter SDK 壓縮包

    下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。

    (載入中...)
  2. 建立一個資料夾以存放 SDK

    建立或找一個資料夾來存放解壓後的 SDK。建議在 %USERPROFILE%\develop (C:\Users\{使用者名稱}\develop) 目錄下建立並使用該資料夾。

  3. 解壓 SDK

    將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為您下載的壓縮包路徑。
    3. <destination_directory_path> 替換為您希望存放解壓後 SDK 的資料夾路徑。
    4. 在您首選的終端中執行編輯後的命令。
    Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>
    

    例如,如果您將 Flutter 3.29.3 的壓縮包下載到了 %USERPROFILE%\Downloads 目錄,並希望將解壓後的 SDK 存放在 %USERPROFILE%\develop 目錄下

    Expand-Archive `
      -Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip `
      -Destination $env:USERPROFILE\develop\
    
  1. 下載 Flutter SDK 壓縮包

    根據您 macOS 裝置的 CPU 架構,下載以下安裝包之一以獲取 Flutter SDK 的最新穩定版本。

    Apple Silicon (ARM64)Intel
    (載入中...)(載入中...)
  2. 建立一個資料夾以存放 SDK

    建立或找一個資料夾來存放解壓後的 SDK。建議在 ~/develop/ 目錄下建立並使用該資料夾。

  3. 解壓 SDK

    將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為您下載的壓縮包路徑。
    3. <destination_directory_path> 替換為您希望存放解壓後 SDK 的資料夾路徑。
    4. 在您首選的終端中執行編輯後的命令。
    unzip <sdk_zip_path> -d <destination_directory_path>
    

    例如,如果您將 Flutter 3.29.3 的壓縮包下載到了 ~/Downloads 目錄,並希望將解壓後的 SDK 存放在 ~/develop 目錄下

    unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
    
  1. 下載 Flutter SDK 壓縮包

    下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。

    (載入中...)
  2. 建立一個資料夾以存放 SDK

    建立或找一個資料夾來存放解壓後的 SDK。建議在 ~/develop/ 目錄下建立並使用該資料夾。

  3. 解壓 SDK

    將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為您下載的壓縮包路徑。
    3. <destination_directory_path> 替換為您希望存放解壓後 SDK 的資料夾路徑。
    4. 在您首選的終端中執行編輯後的命令。
    tar -xf <sdk_zip_path> -C <destination_directory_path>
    

    例如,如果您將 Flutter 3.29.3 的壓縮包下載到了 ~/Downloads 目錄,並希望將解壓後的 SDK 存放在 ~/develop 目錄下

    tar -xf ~/Downloads/flutter_linux_3.29.3-stable.tar.xz -C ~/develop/
    

將 Flutter 新增到 PATH

#

下載 SDK 後,將 Flutter SDK 的 bin 目錄新增到您的 PATH 環境變數中。將 Flutter 新增到 PATH 後,您就可以在終端和 IDE 中使用 flutterdart 命令列工具了。

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 導航到環境變數設定

    1. 按下 Windows + Pause

      如果您的鍵盤沒有 Pause 鍵,請嘗試 Windows + Fn + B

      此時將開啟系統 > 關於對話方塊。

    2. 點選高階系統設定 > 高階 > 環境變數...

      此時將開啟環境變數對話方塊。

  3. 將 Flutter SDK bin 新增到您的路徑

    1. 環境變數對話方塊的(使用者名稱)的使用者變數部分中,找到 Path 條目。

    2. 如果存在 Path 條目,請雙擊它。

      此時應開啟編輯環境變數對話方塊。

      1. 雙擊空白行。

      2. 輸入您的 Flutter 安裝目錄中 bin 資料夾的路徑。

        例如,如果您將 Flutter 下載到使用者目錄下的 develop\flutter 資料夾中,則需要輸入以下內容

        %USERPROFILE%\develop\flutter\bin
        
      3. 點選您新增的 Flutter 條目以選中它。

      4. 點選上移,直到 Flutter 條目位於列表頂部。

      5. 要確認更改,請連續點選三次確定

    3. 如果該條目不存在,請點選新建...

      此時應開啟編輯環境變數對話方塊。

      1. 在“變數名”框中,輸入 Path

      2. 變數值框中,輸入您的 Flutter 安裝目錄中 bin 資料夾的路徑。

        例如,如果您將 Flutter 下載到使用者目錄下的 develop\flutter 資料夾中,則需要輸入以下內容

        %USERPROFILE%\develop\flutter\bin
        
      3. 要確認更改,請連續點選三次確定

  4. 應用您的更改

    要應用此更改並獲得對 flutter 工具的訪問許可權,請關閉並重新開啟所有已開啟的命令提示符、終端應用會話以及 IDE。

  5. 驗證您的設定

    要確保已成功將 SDK 新增到 PATH,請開啟命令提示符或您首選的終端應用,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version
    

    如果找不到任一命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 開啟或建立 Zsh 環境變數檔案

    如果存在,請在您首選的文字編輯器中開啟 Zsh 環境變數檔案 ~/.zprofile。如果不存在,請建立 ~/.zprofile 檔案。

  3. 將 Flutter SDK bin 新增到您的路徑

    ~/.zprofile 檔案的末尾,使用內建的 export 命令更新 PATH 變數,以包含 Flutter 安裝目錄中的 bin 目錄。

    <path-to-sdk> 替換為您 Flutter SDK 的安裝路徑。

    bash
    export PATH="<path-to-sdk>/bin:$PATH"
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要在檔案中新增以下內容

    bash
    export PATH="$HOME/develop/flutter/bin:$PATH"
    
  4. 儲存更改

    儲存並關閉您編輯的 ~/.zprofile 檔案。

  5. 應用您的更改

    要應用此更改並獲得對 flutter 工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 Zsh 會話。

  6. 驗證您的設定

    要確保已成功將 SDK 新增到 PATH,請在您首選的終端中開啟 Zsh 會話,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version
    

    如果找不到任一命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 確定您的預設 shell

    如果您不知道自己使用的 shell,請檢視開啟新的控制檯視窗時啟動的是哪個 shell。

    echo $SHELL
    
  3. 將 Flutter SDK bin 新增到您的路徑

    要將 Flutter 安裝目錄的 bin 目錄新增到 PATH

    1. 展開適用於您預設 shell 的說明。
    2. 複製提供的命令。
    3. <path-to-sdk> 替換為您 Flutter SDK 的安裝路徑。
    4. 在您使用該 shell 的首選終端中執行編輯後的命令。

    展開檢視 bash 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.bashrc
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
    
    展開檢視 zsh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv
    
    展開檢視 fish 說明
    fish_add_path -g -p <path-to-sdk>/bin
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    fish_add_path -g -p ~/develop/flutter/bin
    
    展開檢視 csh 說明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc
    
    展開檢視 tcsh 說明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc
    
    展開檢視 ksh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    
    展開檢視 sh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    
  4. 應用您的更改

    要應用此更改並獲得對 flutter 工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 shell 會話。

  5. 驗證您的設定

    要確保已成功將 SDK 新增到 PATH,請使用您的預設 shell 開啟您首選的終端,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version
    

    如果找不到任一命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 將 Flutter SDK bin 新增到您的路徑

    要將 Flutter 安裝目錄的 bin 目錄新增到 PATH

    1. 複製以下命令。
    2. <path-to-sdk> 替換為您 Flutter SDK 的安裝路徑。
    3. 在您首選的終端中執行編輯後的命令。
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
    

    例如,如果您將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾中,則需要執行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile
    
  3. 應用您的更改

    要應用此更改並獲得對 flutter 工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 Zsh 會話。

  4. 驗證您的設定

    要確保已成功將 SDK 新增到 PATH,請在您首選的終端中開啟 Zsh 會話,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version
    

    如果找不到任一命令,請檢視Flutter 安裝故障排除

繼續你的 Flutter 之旅

#

現在您已經成功安裝了 Flutter,請至少設定一個目標平臺的開發環境,以繼續您的 Flutter 之旅。