手動安裝 Flutter
瞭解如何手動安裝和設定 Flutter SDK。
瞭解如何手動安裝和配置您的 Flutter 開發環境。
選擇你的開發平臺
#本頁面上的說明適用於在 Windows 裝置上安裝 Flutter。
如果你想遵循其他作業系統的說明,請選擇以下之一。
下載先決軟體
#在安裝 Flutter SDK 之前,請先完成以下設定。
-
安裝適用於 Windows 的 Git
下載並安裝最新版適用於 Windows 的 Git。
有關安裝或故障排除 Git 的幫助,請參閱 Git 文件。
-
設定編輯器或 IDE
為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE。
-
安裝 Xcode 命令列工具
下載 Xcode 命令列工具以訪問 Flutter 依賴的命令列工具,包括 Git。
要下載這些工具,請在你喜歡的終端中執行以下命令
xcode-select --install如果你尚未安裝這些工具,將彈出一個對話方塊,確認你是否要安裝它們。單擊 安裝,安裝完成後,單擊 完成。
-
設定編輯器或 IDE
為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE。
-
下載並安裝先決軟體包
使用你偏好的包管理器或機制,安裝以下軟體包的最新版本
curlgitunzipxz-utilsziplibglu1-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 -
設定編輯器或 IDE
為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE。
-
設定 Linux 支援
如果你之前未在 Chromebook 上設定 Linux 支援,請開啟 Linux 支援。
如果你已經開啟了 Linux 支援,請按照解決 Linux 問題的說明進行更新。
-
下載並安裝先決軟體包
使用
apt-get或你喜歡的安裝機制,安裝以下軟體包的最新版本curlgitunzipxz-utilsziplibglu1-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 -
設定編輯器或 IDE
為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並配置一個支援 Flutter 的編輯器或 IDE。
安裝並設定 Flutter
#要安裝 Flutter SDK,請從 SDK 存檔中下載最新的壓縮包,然後將其解壓到您希望存放的位置。
-
下載 Flutter SDK 壓縮包
下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。
(載入中...) -
建立一個資料夾以存放 SDK
建立或找一個資料夾來存放解壓後的 SDK。建議在
%USERPROFILE%\develop(C:\Users\{使用者名稱}\develop) 目錄下建立並使用該資料夾。 -
解壓 SDK
將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。
- 複製以下命令。
- 將
<sdk_zip_path>替換為您下載的壓縮包路徑。 - 將
<destination_directory_path>替換為您希望存放解壓後 SDK 的資料夾路徑。 - 在您首選的終端中執行編輯後的命令。
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\
-
下載 Flutter SDK 壓縮包
根據您 macOS 裝置的 CPU 架構,下載以下安裝包之一以獲取 Flutter SDK 的最新穩定版本。
-
建立一個資料夾以存放 SDK
建立或找一個資料夾來存放解壓後的 SDK。建議在
~/develop/目錄下建立並使用該資料夾。 -
解壓 SDK
將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。
- 複製以下命令。
- 將
<sdk_zip_path>替換為您下載的壓縮包路徑。 - 將
<destination_directory_path>替換為您希望存放解壓後 SDK 的資料夾路徑。 - 在您首選的終端中執行編輯後的命令。
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/
-
下載 Flutter SDK 壓縮包
下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。
(載入中...) -
建立一個資料夾以存放 SDK
建立或找一個資料夾來存放解壓後的 SDK。建議在
~/develop/目錄下建立並使用該資料夾。 -
解壓 SDK
將您下載的 SDK 壓縮包解壓到您希望存放 Flutter SDK 的目錄中。
- 複製以下命令。
- 將
<sdk_zip_path>替換為您下載的壓縮包路徑。 - 將
<destination_directory_path>替換為您希望存放解壓後 SDK 的資料夾路徑。 - 在您首選的終端中執行編輯後的命令。
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 中使用 flutter 和 dart 命令列工具了。
-
確定您的 Flutter SDK 安裝位置
複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。
-
導航到環境變數設定
按下 Windows + Pause。
如果您的鍵盤沒有 Pause 鍵,請嘗試 Windows + Fn + B。
此時將開啟系統 > 關於對話方塊。
點選高階系統設定 > 高階 > 環境變數...。
此時將開啟環境變數對話方塊。
-
將 Flutter SDK bin 新增到您的路徑
在環境變數對話方塊的(使用者名稱)的使用者變數部分中,找到 Path 條目。
如果存在 Path 條目,請雙擊它。
此時應開啟編輯環境變數對話方塊。
雙擊空白行。
輸入您的 Flutter 安裝目錄中
bin資料夾的路徑。例如,如果您將 Flutter 下載到使用者目錄下的
develop\flutter資料夾中,則需要輸入以下內容%USERPROFILE%\develop\flutter\bin點選您新增的 Flutter 條目以選中它。
點選上移,直到 Flutter 條目位於列表頂部。
要確認更改,請連續點選三次確定。
如果該條目不存在,請點選新建...。
此時應開啟編輯環境變數對話方塊。
在“變數名”框中,輸入
Path。在變數值框中,輸入您的 Flutter 安裝目錄中
bin資料夾的路徑。例如,如果您將 Flutter 下載到使用者目錄下的
develop\flutter資料夾中,則需要輸入以下內容%USERPROFILE%\develop\flutter\bin要確認更改,請連續點選三次確定。
-
應用您的更改
要應用此更改並獲得對
flutter工具的訪問許可權,請關閉並重新開啟所有已開啟的命令提示符、終端應用會話以及 IDE。 -
驗證您的設定
要確保已成功將 SDK 新增到
PATH,請開啟命令提示符或您首選的終端應用,然後嘗試執行flutter和dart工具。flutter --version dart --version如果找不到任一命令,請檢視Flutter 安裝故障排除。
-
確定您的 Flutter SDK 安裝位置
複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。
-
開啟或建立 Zsh 環境變數檔案
如果存在,請在您首選的文字編輯器中開啟 Zsh 環境變數檔案
~/.zprofile。如果不存在,請建立~/.zprofile檔案。 -
將 Flutter SDK bin 新增到您的路徑
在
~/.zprofile檔案的末尾,使用內建的export命令更新PATH變數,以包含 Flutter 安裝目錄中的bin目錄。將
<path-to-sdk>替換為您 Flutter SDK 的安裝路徑。bashexport PATH="<path-to-sdk>/bin:$PATH"例如,如果您將 Flutter 下載到使用者目錄下的
develop/flutter資料夾中,則需要在檔案中新增以下內容bashexport PATH="$HOME/develop/flutter/bin:$PATH" 儲存更改
儲存並關閉您編輯的
~/.zprofile檔案。-
應用您的更改
要應用此更改並獲得對
flutter工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 Zsh 會話。 -
驗證您的設定
要確保已成功將 SDK 新增到
PATH,請在您首選的終端中開啟 Zsh 會話,然後嘗試執行flutter和dart工具。flutter --version dart --version如果找不到任一命令,請檢視Flutter 安裝故障排除。
-
確定您的 Flutter SDK 安裝位置
複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。
-
確定您的預設 shell
如果您不知道自己使用的 shell,請檢視開啟新的控制檯視窗時啟動的是哪個 shell。
echo $SHELL -
將 Flutter SDK bin 新增到您的路徑
要將 Flutter 安裝目錄的
bin目錄新增到PATH- 展開適用於您預設 shell 的說明。
- 複製提供的命令。
- 將
<path-to-sdk>替換為您 Flutter SDK 的安裝路徑。 - 在您使用該 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 -
應用您的更改
要應用此更改並獲得對
flutter工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 shell 會話。 -
驗證您的設定
要確保已成功將 SDK 新增到
PATH,請使用您的預設 shell 開啟您首選的終端,然後嘗試執行flutter和dart工具。flutter --version dart --version如果找不到任一命令,請檢視Flutter 安裝故障排除。
-
確定您的 Flutter SDK 安裝位置
複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。
-
將 Flutter SDK bin 新增到您的路徑
要將 Flutter 安裝目錄的
bin目錄新增到PATH- 複製以下命令。
- 將
<path-to-sdk>替換為您 Flutter SDK 的安裝路徑。 - 在您首選的終端中執行編輯後的命令。
echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile例如,如果您將 Flutter 下載到使用者目錄下的
develop/flutter資料夾中,則需要執行以下命令echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile -
應用您的更改
要應用此更改並獲得對
flutter工具的訪問許可權,請關閉並重新開啟終端應用和 IDE 中所有已開啟的 Zsh 會話。 -
驗證您的設定
要確保已成功將 SDK 新增到
PATH,請在您首選的終端中開啟 Zsh 會話,然後嘗試執行flutter和dart工具。flutter --version dart --version如果找不到任一命令,請檢視Flutter 安裝故障排除。
繼續你的 Flutter 之旅
#現在您已經成功安裝了 Flutter,請至少設定一個目標平臺的開發環境,以繼續您的 Flutter 之旅。