驗證系統需求
- 硬體需求
- 軟體需求
設定文字編輯器或 IDE
安裝 Flutter SDK
設定 Android 開發環境
檢查您的開發環境設定
- 執行 Flutter doctor
- 疑難排解 Flutter doctor 問題
開始使用 Flutter 在 Linux 上開發 Android 應用程式
管理您的 Flutter SDK

開始在 Linux 上建置 Flutter Android 應用程式

驗證系統需求
- 硬體需求
- 軟體需求
設定文字編輯器或 IDE
安裝 Flutter SDK
設定 Android 開發環境
檢查您的開發環境設定
- 執行 Flutter doctor
- 疑難排解 Flutter doctor 問題
開始使用 Flutter 在 Linux 上開發 Android 應用程式
管理您的 Flutter SDK

若要安裝並執行 Flutter，您的 Linux 環境必須符合下列硬體和軟體需求。

您的 Linux Flutter 開發環境必須符合下列最低硬體需求。

需求	最低	建議
CPU 核心	4	8
記憶體 (GB)	8	16
顯示解析度 (像素)	WXGA (1366 x 768)	FHD (1920 x 1080)
可用磁碟空間 (GB)	11.0	60.0

若要撰寫並編譯適用於 Android 的 Flutter 程式碼，您必須擁有下列 Linux 版本和列出的軟體套件。

Flutter 支援 Debian Linux 11 或更新版本，以及 Ubuntu Linux 20.04 LTS 或更新版本。

若要在 Linux 上開發 Flutter

安裝下列套件：curl、git、unzip、xz-utils、zip、libglu1-mesa

sudo apt-get update -y && sudo apt-get upgrade -y;
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

若要開發 Android 應用程式
1. 安裝 Android Studio 的下列必要套件
```
sudo apt-get install libc6:amd64 libstdc++6:amd64 lib32z1 libbz2-1.0:amd64
```
2. 安裝 Android Studio 2023.3.1 (Jellyfish) 或更新版本，以偵錯和編譯適用於 Android 的 Java 或 Kotlin 程式碼。Flutter 需要完整版本的 Android Studio。

當您執行目前版本的 flutter doctor 時，它可能會列出其中一個套件的不同版本。如果有的話，請安裝它建議的版本。

上述軟體的開發人員會為這些產品提供支援。若要針對安裝問題進行疑難排解，請參閱該產品的說明文件。

您可以使用任何文字編輯器或整合開發環境 (IDE) 搭配 Flutter 的命令列工具，來建置應用程式。

使用具有 Flutter 擴充功能或外掛程式的 IDE 可提供程式碼完成、語法醒目提示、Widget 編輯輔助、偵錯和其他功能。

熱門選項包括

Visual Studio Code 1.77 或更新版本，搭配適用於 VS Code 的 Flutter 擴充功能。
Android Studio 2023.3.1 (Jellyfish) 或更新版本，搭配適用於 IntelliJ 的 Flutter 外掛程式。
IntelliJ IDEA 2023.3 或更新版本，搭配適用於 IntelliJ 的 Flutter 外掛程式。

若要安裝 Flutter SDK，您可以使用 VS Code Flutter 擴充功能，或自行下載並安裝 Flutter 套件。

使用 VS Code 安裝
下載並安裝

若要使用這些指示安裝 Flutter，請確認您已安裝 Visual Studio Code 1.77 或更新版本，以及適用於 VS Code 的 Flutter 擴充功能。

啟動 VS Code。
若要開啟「命令選擇區」，請按下 Control + Shift + P。
在「命令選擇區」中，輸入 flutter。
選取「Flutter: 新專案」。
VS Code 會提示您找出電腦上的 Flutter SDK。
1. 如果您已安裝 Flutter SDK，請按一下「找出 SDK」。
2. 如果您尚未安裝 Flutter SDK，請按一下「下載 SDK」。
  如果您尚未按照開發工具先決條件中的指示安裝 Git，則此選項會將您傳送到 Flutter 安裝頁面。
當系統提示「您要使用哪個 Flutter 範本？」時，請忽略它。按下 Esc。您可以在檢查您的開發環境設定後建立測試專案。

當「選取 Flutter SDK 的資料夾」對話方塊出現時，請選擇要安裝 Flutter 的位置。
VS Code 會將您放在使用者設定檔中以開始。請選擇其他位置。
考慮使用 ~/development/
按一下「複製 Flutter」。
下載 Flutter 時，VS Code 會顯示此快顯通知
```
Downloading the Flutter SDK. This may take a few minutes.
```
此下載需要幾分鐘的時間。如果您懷疑下載已停止，請按一下「取消」，然後再次開始安裝。

下載完成 Flutter 後，「輸出」面板會顯示。

Checking Dart SDK version...
Downloading Dart SDK from the Flutter engine ...
Expanding downloaded archive...

成功時，VS Code 會顯示此快顯通知

Initializing the Flutter SDK. This may take a few minutes.

在初始化時，「輸出」面板會顯示以下內容

Building flutter tool...
Running pub upgrade...
Resolving dependencies...
Got dependencies.
Downloading Material fonts...
Downloading Gradle Wrapper...
Downloading package sky_engine...
Downloading flutter_patched_sdk tools...
Downloading flutter_patched_sdk_product tools...
Downloading windows-x64 tools...
Downloading windows-x64/font-subset tools...

此程序也會執行 flutter doctor -v。在此程序中，請忽略此輸出。 Flutter Doctor 可能會顯示不適用於此快速入門的錯誤。

當 Flutter 安裝成功時，VS Code 會顯示此快顯通知

Do you want to add the Flutter SDK to PATH so it's accessible
in external terminals?

VS Code 可能會顯示 Google Analytics 通知。
如果您同意，請按一下「確定」。
若要在所有終端機視窗中啟用 flutter
1. 關閉，然後重新開啟所有終端機視窗。
2. 重新啟動 VS Code。

若要安裝 Flutter，請從封存下載 Flutter SDK 套件，將套件移至您要儲存的位置，然後解壓縮 SDK。

下載下列安裝套件以取得最新穩定版本的 Flutter SDK。
(載入中...)
若要瞭解其他發行管道和舊版組建，請查看 SDK 封存。
Flutter SDK 應下載到 Linux 預設下載目錄：~/Downloads/。
建立一個您可以安裝 Flutter 的資料夾。
考慮在 ~/development/ 建立目錄。
將檔案解壓縮到您要儲存 Flutter SDK 的目錄中。
```
tar -xf ~/Downloads/flutter_sdk_v1.0.0.zip -C ~/development/
```
完成時，Flutter SDK 應位於 ~/development/flutter 目錄中。

若要在 Shell 中執行 Flutter 命令，請將 Flutter 新增至 PATH 環境變數。

檢查當您開啟新的主控台視窗時啟動哪個 Shell。這會是您的預設 Shell。
```
echo $SHELL
```
這與另一個告訴您哪個 Shell 在目前主控台中執行的命令不同。
```
echo $0
```

若要將 Flutter 新增至您的 PATH，請展開預設 Shell 的項目，然後選擇命令。

顯示bashcommand

echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.bash_profile

顯示zshcommand

echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.zshenv

顯示fishcommand

fish_add_path -g -p ~/development/flutter/bin

顯示cshcommand

echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.cshrc

顯示tcshcommand

echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.tcshrc

顯示kshcommand

echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile

顯示shcommand

echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile

若要套用此變更，請重新啟動所有開啟的終端機工作階段。

help 說明

若要使用 Flutter 建立 Android 應用程式，請確認已安裝下列 Android 元件。

Android SDK Platform，API 35.0.1
Android SDK 命令列工具
Android SDK Build-Tools
Android SDK Platform-Tools
Android 模擬器

如果您尚未安裝這些元件，或您不知道，請繼續進行以下程序。

否則，您可以跳至下一節。

第一次使用 Android Studio
目前的 Android Studio 使用者

啟動「Android Studio」。
「歡迎使用 Android Studio」對話方塊會顯示。
依照「Android Studio 設定精靈」的指示操作。
安裝下列元件
- Android SDK Platform，API 35.0.1
- Android SDK 命令列工具
- Android SDK Build-Tools
- Android SDK Platform-Tools
- Android 模擬器

啟動「Android Studio」。
前往「設定」對話方塊以檢視「SDK 管理員」。
1. 如果您已開啟專案，請前往「工具」>「SDK 管理員」。
2. 如果「歡迎使用 Android Studio」對話方塊顯示，請按一下「開啟」按鈕後的「更多選項」圖示，然後從下拉式選單中按一下「SDK 管理員」。
按一下「SDK 平台」。
確認已選取「Android API 35.0.1」。
如果「狀態」欄顯示「有更新可用」或「尚未安裝」
1. 選取「Android API 35.0.1」。
2. 按一下「套用」。
3. 當「確認變更」對話方塊顯示時，按一下「確定」。
  「SDK 快速修正安裝」對話方塊會顯示，並附帶完成量表。
4. 當安裝完成時，按一下「完成」。
  在您安裝最新的 SDK 之後，「狀態」欄可能會顯示「有更新可用」。這表示某些額外的系統映像可能尚未安裝。您可以忽略此訊息並繼續。
按一下「SDK 工具」。
確認已選取下列 SDK 工具
- Android SDK 命令列工具
- Android SDK Build-Tools
- Android SDK Platform-Tools
- Android 模擬器
如果上述任何工具的「狀態」欄顯示「有更新可用」或「尚未安裝」
1. 選取所需的工具。
2. 按一下「套用」。
3. 當「確認變更」對話方塊顯示時，按一下「確定」。
  「SDK 快速修正安裝」對話方塊會顯示，並附帶完成量表。
4. 當安裝完成時，按一下「完成」。

虛擬裝置
實體裝置

help 說明

若要設定您的 Flutter 應用程式在 Android 模擬器中執行，請依照下列步驟建立並選取模擬器。

在您的開發電腦上啟用 VM 加速。
啟動「Android Studio」。
前往「設定」對話方塊以檢視「SDK 管理員」。
1. 如果您已開啟專案，請前往「工具」>「裝置管理員」。
2. 如果「歡迎使用 Android Studio」對話方塊顯示，請按一下「開啟」按鈕後的「更多選項」圖示，然後從下拉式選單中按一下「裝置管理員」。
按一下「虛擬」。
按一下「建立裝置」。
「虛擬裝置設定」對話方塊會顯示。
在「類別」下方選取「手機」或「平板電腦」。
選取裝置定義。您可以瀏覽或搜尋裝置。
按一下「下一步」。
按一下「x86 映像檔」。
按一下您要模擬的 Android 版本的一個系統映像檔。
1. 如果所需的映像檔在 Release Name (版本名稱) 的右側有 Download (下載) 圖示，請點擊它。
  「SDK 快速修正安裝」對話方塊會顯示，並附帶完成量表。
2. 下載完成後，請點擊 Finish (完成)。
按一下「下一步」。
Virtual Device Configuration (虛擬裝置設定) 會顯示 Verify Configuration (驗證設定) 步驟。
若要重新命名 Android 虛擬裝置 (AVD)，請變更 AVD Name (AVD 名稱) 方塊中的值。
點擊 Show Advanced Settings (顯示進階設定) 並捲動至 Emulated Performance (模擬效能)。
從 Graphics (圖形) 下拉式選單中，選取 Hardware - GLES 2.0 (硬體 - GLES 2.0)。
這會啟用硬體加速並改善渲染效能。
驗證您的 AVD 設定。如果正確無誤，請點擊 Finish (完成)。
若要瞭解更多關於 AVD 的資訊，請查看管理 AVD。
在 Device Manager (裝置管理員) 對話框中，點擊您所需 AVD 右側的 Run (執行) 圖示。模擬器將會啟動並顯示您所選 Android 作業系統版本和裝置的預設畫布。

help 說明

若要將您的 Flutter 應用程式設定為在實體 Android 裝置上執行，您需要一個執行 Android API 等級 21 或更新版本的 Android 裝置。

在您的裝置上啟用 開發人員選項 和 USB 偵錯，如 Android 文件中所述。
[選用] 若要利用無線偵錯，請在您的裝置上啟用 無線偵錯，如 Android 文件中所述。
將您的裝置插入您的 Linux 電腦。如果您的裝置提示您，請授權您的電腦存取您的裝置。
驗證 Flutter 是否能辨識您連接的 Android 裝置。
預設情況下，Flutter 會使用 adb 工具所基於的 Android SDK 版本。若要使用不同的 Android SDK 安裝路徑與 Flutter，請將 ANDROID_SDK_ROOT 環境變數設定為該安裝目錄。

help 說明

在您可以使用 Flutter 之前，以及在您安裝所有必要條件之後，請同意 Android SDK 平台的授權條款。

開啟一個提升權限的控制台視窗。
執行以下命令來啟用簽署授權。
```
flutter doctor --android-licenses
```
如果您在其他時間接受了 Android Studio 授權，此命令將會回傳
```
[========================================] 100% Computing updates...
All SDK package licenses accepted.
```
您可以跳過下一步。
在同意每個授權條款之前，請仔細閱讀每個條款。

如何修正尋找 Java 安裝的錯誤

您可能在 Android SDK 定位 Java SDK 時遇到問題。

flutter doctor --android-licenses

ERROR: JAVA_HOME is set to an invalid directory: /Applications/Android\ Studio.app/Contents/jre/Contents/Home

Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.

Android sdkmanager tool was found, but failed to run
(/Users/atsansone/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager): "exited code 1".
Try re-installing or updating your Android SDK,
visit https://flutter.dev/to/macos-android-setup for detailed instructions.

flutter doctor 命令會因為 JAVA_HOME 變數的設定方式而回傳此錯誤。當您將路徑新增至 JAVA_HOME 時，您可以在 Android 和 Studio 之間的空格新增一個反斜線，或將整個路徑以相符的引號括起來。您不能兩者都做。

在您適當的 shell 資源檔案中尋找您的 JAVA_HOME 路徑。

將其從

bashexport JAVA_HOME="/Applications/Android\ Studio.app/Contents/jre/Contents/Home"

變更為

bashexport JAVA_HOME="/Applications/Android Studio.app/Contents/jre/Contents/Home"

請勿在 Android 和 Studio 之間包含反斜線。

若要載入此更新的環境變數，請重新載入您的 shell。此範例使用 zsh 資源檔案。

source ~/.zshrc

help 說明

flutter doctor 命令會驗證完整的 Linux Flutter 開發環境的所有元件。

開啟一個 shell。
若要驗證所有元件的安裝，請執行以下命令。
```
flutter doctor
```

由於您選擇為 Android 開發，您不需要所有元件。如果您遵循本指南，您的命令結果應類似

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on Ubuntu 20.04 (LTS), locale en)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[✓] Android Studio (version 2024.2)
[!] Linux toolchain - develop for Linux desktop
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 2 categories.

當 flutter doctor 命令回傳錯誤時，可能是因為 Flutter、VS Code、Android Studio、已連線的裝置或網路資源。

如果 flutter doctor 命令針對任何這些元件回傳錯誤，請使用詳細旗標再次執行。

flutter doctor -v

檢查輸出中是否有您可能需要安裝的其他軟體或需要執行的其他任務。

如果您變更了 Flutter SDK 或其相關元件的設定，請再次執行 flutter doctor 來驗證安裝。

恭喜。 在安裝所有必要條件和 Flutter SDK 之後，您可以開始在 Linux 上為 Android 開發 Flutter 應用程式。

若要繼續您的學習旅程，請參考以下指南

若要瞭解更多關於管理您的 Flutter SDK 安裝的資訊，請參考以下資源。

除非另有說明，否則本網站上的文件反映了 Flutter 的最新穩定版本。頁面最後更新時間為 2024-10-28。檢視原始碼或回報問題。

開始在 Linux 上建置 Flutter Android 應用程式

驗證系統需求

硬體需求

軟體需求

作業系統

開發工具

設定文字編輯器或 IDE

安裝 Flutter SDK

使用 VS Code 安裝 Flutter

提示 VS Code 安裝 Flutter

下載 Flutter SDK

下載然後安裝 Flutter

將 Flutter 新增至您的 `PATH`

設定 Android 開發環境

在 Android Studio 中設定 Android 工具鏈

設定您的目標 Android 裝置

設定 Android 模擬器

設定您的目標 Android 裝置

同意 Android 授權條款

疑難排解授權問題

檢查您的開發環境設定

執行 Flutter doctor

疑難排解 Flutter doctor 問題

開始使用 Flutter 在 Linux 上開發 Android 應用程式

管理您的 Flutter SDK

驗證系統需求

硬體需求

軟體需求

作業系統

開發工具

設定文字編輯器或 IDE

安裝 Flutter SDK

使用 VS Code 安裝 Flutter

提示 VS Code 安裝 Flutter

下載 Flutter SDK

下載然後安裝 Flutter

將 Flutter 新增至您的 PATH

設定 Android 開發環境

在 Android Studio 中設定 Android 工具鏈

設定您的目標 Android 裝置

設定 Android 模擬器

設定您的目標 Android 裝置

同意 Android 授權條款

疑難排解授權問題

檢查您的開發環境設定

執行 Flutter doctor

疑難排解 Flutter doctor 問題

開始使用 Flutter 在 Linux 上開發 Android 應用程式

管理您的 Flutter SDK

將 Flutter 新增至您的 `PATH`