在 Linux 上開始構建 Flutter Android 應用
軟體要求
#要為 Android 編寫和編譯 Flutter 程式碼,您必須擁有以下版本的 Linux 和列出的軟體包。
作業系統
#Flutter 支援 Debian 11 或更高版本以及 Ubuntu 22.04 或更高版本的 LTS。
開發工具
#在 Linux 上開發 Flutter
安裝以下軟體包:
curl、git、unzip、xz-utils、zip、libglu1-mesasudo apt-get update -y && sudo apt-get upgrade -y; sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa開發 Android 應用
安裝 Android Studio 的以下必備軟體包
sudo apt-get install libc6:amd64 libstdc++6:amd64 lib32z1 libbz2-1.0:amd64安裝 Android Studio 以便除錯和編譯 Android 的 Java 或 Kotlin 程式碼。Flutter 需要完整版的 Android Studio。
上述軟體的開發者提供這些產品的支援。要解決安裝問題,請查閱該產品的文件。
配置文字編輯器或 IDE
#你可以使用任何文字編輯器或整合開發環境 (IDE) 結合 Flutter 的命令列工具來構建應用。
使用帶有 Flutter 擴充套件或外掛的 IDE 可提供程式碼補全、語法高亮、小部件編輯輔助、除錯及其他功能。
流行的選項包括
- 安裝 Visual Studio Code 以及適用於 VS Code 的 Flutter 擴充套件外掛。
- 安裝包含 IntelliJ 版 Flutter 外掛的 Android Studio。
- IntelliJ IDEA 以及適用於 IntelliJ 的 Flutter 外掛。
安裝 Flutter SDK
#要安裝 Flutter SDK,你可以使用 VS Code Flutter 擴充套件,或自行下載並安裝 Flutter 包。
使用 VS Code 安裝 Flutter
#要按照這些說明安裝 Flutter,請驗證您已安裝 Visual Studio Code 和 VS Code 版 Flutter 擴充套件。
提示 VS Code 安裝 Flutter
#啟動 VS Code。
要開啟命令面板,請按 Control + Shift + P。
在命令面板中,輸入
flutter。選擇Flutter: 新建專案。
VS Code 會提示你定位電腦上的 Flutter SDK。
如果你已安裝 Flutter SDK,請點選定位 SDK。
如果你未安裝 Flutter SDK,請點選下載 SDK。
如果您尚未按照開發工具先決條件中的說明安裝 Git,此選項會將您帶到 Flutter 安裝頁面。
當提示哪個 Flutter 模板?時,請忽略。按 Esc。你可以在檢查開發環境設定後建立一個測試專案。
下載 Flutter SDK
#當顯示選擇 Flutter SDK 資料夾對話方塊時,選擇你想要安裝 Flutter 的位置。
VS Code 會首先將你定位到使用者配置檔案目錄。請選擇其他位置。
考慮使用
~/development/點選克隆 Flutter。
下載 Flutter 時,VS Code 會顯示以下彈窗通知:
Downloading the Flutter SDK. This may take a few minutes.Initializing the Flutter SDK. This may take a few minutes.下載和安裝需要幾分鐘。如果你懷疑下載已卡住,請點選取消,然後重新開始安裝。
Flutter 安裝成功後,VS Code 會顯示此彈窗通知:
Do you want to add the Flutter SDK to PATH so it's accessible in external terminals?點選新增 SDK 到 PATH。
成功時,會顯示通知
The Flutter SDK was added to your PATHVS Code 可能會顯示 Google Analytics 通知。
如果你同意,點選確定。
在所有終端視窗中啟用
flutter- 關閉,然後重新開啟所有終端視窗。
- 重新啟動 VS Code。
下載然後安裝 Flutter
#要安裝 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目錄中。
將 Flutter 新增到您的 PATH
#要在 Shell 中執行 Flutter 命令,請將 Flutter 新增到 PATH 環境變數中。
檢查當你開啟新的控制檯視窗時會啟動哪個 Shell。這將是你的預設 Shell。
echo $SHELL這與另一個命令不同,該命令會告訴你當前控制檯中正在執行哪個 Shell。
echo $0要將 Flutter 新增到你的
PATH中,請展開你的預設 Shell 條目,然後選擇命令。顯示
bash命令echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile顯示
zsh命令echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.zshenv顯示
fish命令fish_add_path -g -p ~/development/flutter/bin顯示
csh命令echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.cshrc顯示
tcsh命令echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.tcshrc顯示
ksh命令echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile顯示
sh命令echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile要應用此更改,請重新啟動所有開啟的終端會話。
配置 Android 開發環境
#在 Android Studio 中配置 Android 工具鏈
#要使用 Flutter 建立 Android 應用,請驗證是否已安裝以下 Android 元件。
- Android SDK Platform, API 35
- Android SDK 命令列工具
- Android SDK 構建工具
- Android SDK 平臺工具
- Android 模擬器
如果你尚未安裝這些元件,或不確定是否已安裝,請繼續執行以下步驟。
否則,你可以跳到下一部分。
啟動 Android Studio。
將顯示歡迎使用 Android Studio 對話方塊。
按照Android Studio 設定嚮導的指示操作。
安裝以下元件
- Android SDK Platform, API 35
- Android SDK 命令列工具
- Android SDK 構建工具
- Android SDK 平臺工具
- Android 模擬器
啟動 Android Studio。
轉到設定對話方塊以檢視 SDK 管理器。
如果您已開啟專案,請轉到工具 > SDK 管理器。
如果顯示歡迎使用 Android Studio 對話方塊,請點選開啟按鈕旁邊的更多選項圖示,然後從下拉選單中點選SDK 管理器。
點選SDK 平臺。
驗證是否已選擇 Android API 35。
如果“狀態”列顯示“有可用更新”或“未安裝”
選擇 Android API 35。
點選“應用”。
當“確認更改”對話方塊顯示時,點選“確定”。
將顯示帶進度條的SDK 快速修復安裝對話方塊。
安裝完成後,點選完成。
安裝最新 SDK 後,狀態列可能顯示有可用更新。這表示可能未安裝某些額外的系統映像。你可以忽略此提示並繼續。
點選SDK 工具。
驗證是否已選擇以下 SDK 工具
- Android SDK 命令列工具
- Android SDK 構建工具
- Android SDK 平臺工具
- Android 模擬器
如果上述任何工具的“狀態”列顯示“有可用更新”或“未安裝”
選擇所需的工具。
點選“應用”。
當“確認更改”對話方塊顯示時,點選“確定”。
將顯示帶進度條的SDK 快速修復安裝對話方塊。
安裝完成後,點選完成。
配置你的目標 Android 裝置
#設定 Android 模擬器
#要配置 Flutter 應用以在 Android 模擬器中執行,請按照以下步驟建立並選擇一個模擬器。
在您的開發計算機上啟用 VM 加速。
啟動 Android Studio。
前往 **設定** 對話方塊以檢視 **裝置管理器**。
如果您已開啟專案,請轉到工具 > 裝置管理器。
如果顯示歡迎使用 Android Studio 對話方塊,請點選開啟按鈕旁邊的更多選項圖示,然後從下拉選單中點選裝置管理器。
點選“虛擬”。
點選“建立裝置”。
將顯示“虛擬裝置配置”對話方塊。
在“類別”下選擇“手機”或“平板電腦”。
選擇一個裝置定義。您可以瀏覽或搜尋裝置。
點選“下一步”。
點選 x86 Images。
點選您要模擬的 Android 版本的系統映象。
如果所需的映象在“釋出名稱”右側有一個“下載”圖示,請點選它。
將顯示帶進度條的SDK 快速修復安裝對話方塊。
下載完成後,點選“完成”。
點選“下一步”。
“虛擬裝置配置”顯示其“驗證配置”步驟。
要重新命名 Android 虛擬裝置 (AVD),請更改“AVD 名稱”框中的值。
點選“顯示高階設定”並滾動到“模擬效能”。
從“圖形”下拉選單中,選擇“硬體 - GLES 2.0”。
這會啟用硬體加速並提升渲染效能。
驗證您的 AVD 配置。如果正確,點選“完成”。
要了解有關 AVD 的更多資訊,請查閱管理 AVD。
在裝置管理器對話方塊中,點選你所需 AVD 右側的執行圖示。模擬器會啟動並顯示你所選 Android 作業系統版本和裝置的預設畫布。
設定你的目標 Android 裝置
#要配置 Flutter 應用以在物理 Android 裝置上執行,你需要一個受支援的 Android 版本。
按照Android 文件中的說明,在你的裝置上啟用開發者選項和USB 除錯。
[可選] 要利用無線除錯,請按照Android 文件中的說明,在你的裝置上啟用無線除錯。
將您的裝置連線到您的 Linux 計算機。如果您的裝置提示,請授權您的計算機訪問您的裝置。
驗證 Flutter 是否識別你連線的 Android 裝置。
預設情況下,Flutter 使用你的
adb工具所基於的 Android SDK 版本。要將不同的 Android SDK 安裝路徑與 Flutter 配合使用,請將ANDROID_SDK_ROOT環境變數設定為該安裝目錄。
同意 Android 許可
#在使用 Flutter 之前以及安裝所有先決條件之後,請同意 Android SDK 平臺的許可。
開啟一個提升的控制檯視窗。
執行以下命令以啟用簽名許可。
flutter doctor --android-licenses如果你在其他時間接受過 Android Studio 許可,此命令將返回
[========================================] 100% Computing updates... All SDK package licenses accepted.你可以跳過下一步。
在同意每項許可協議的條款之前,請仔細閱讀。
檢查開發環境設定
#執行 Flutter doctor
#flutter doctor 命令會驗證 Linux 上完整 Flutter 開發環境的所有元件。
開啟 Shell。
要驗證所有元件的安裝,請執行以下命令。
flutter doctor
由於你選擇為 Android 開發,因此你不需要所有元件。如果你按照本指南操作,該命令應為你設定的工具和平臺輸出 [✓]。
Flutter doctor 問題排查
#當 flutter doctor 命令返回錯誤時,可能與 Flutter、VS Code、Android Studio、連線的裝置或網路資源有關。
如果 flutter doctor 命令針對這些元件中的任何一個返回錯誤,請使用詳細模式標誌再次執行它。
flutter doctor -v檢查輸出,看是否需要安裝其他軟體或執行其他任務。
如果你更改了 Flutter SDK 或其相關元件的配置,請再次執行 flutter doctor 來驗證安裝。
使用 Flutter 在 Linux 上開始開發 Android 應用
#恭喜。 在安裝了所有必備項和 Flutter SDK 後,您就可以開始在 Linux 上為 Android 開發 Flutter 應用了。
要繼續你的學習之旅,請查閱以下指南:
管理 Flutter SDK
#要了解更多關於管理 Flutter SDK 安裝的資訊,請查閱以下資源: