跳至主要內容
目錄

從 macOS 開始為 Flutter 新增 Android 作為目標平台

目錄

若要為 macOS 上的 Flutter 應用程式新增 Android 作為目標，請按照以下步驟操作。

安裝 Android Studio

#
  1. 為 Android Studio 分配至少 7.5 GB 的儲存空間。為了獲得最佳設定，請考慮分配 10 GB 的儲存空間。
  2. 安裝 Android Studio 2023.3.1 (Jellyfish) 或更新版本，以偵錯和編譯適用於 Android 的 Java 或 Kotlin 程式碼。Flutter 需要完整版的 Android Studio。

設定 Android 開發環境

#

在 Android Studio 中設定 Android 工具鏈

#

help 說明

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

  • Android SDK 平台，API 35.0.1
  • Android SDK 命令列工具
  • Android SDK 建置工具
  • Android SDK 平台工具
  • Android 模擬器

如果您尚未安裝這些元件，或不確定是否已安裝，請繼續執行以下步驟。

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

  1. 啟動 Android Studio。

    會顯示 歡迎使用 Android Studio 對話方塊。

  2. 依照 Android Studio 設定精靈 的指示操作。

  3. 安裝下列元件

    • Android SDK 平台，API 35.0.1
    • Android SDK 命令列工具
    • Android SDK 建置工具
    • Android SDK 平台工具
    • Android 模擬器

  1. 啟動 Android Studio。

  2. 前往 設定 對話方塊以檢視 SDK 管理員。

    1. 如果您已開啟專案，請前往 工具 > SDK 管理員。

    2. 如果顯示 歡迎使用 Android Studio 對話方塊，請按一下 開啟 按鈕後面的 更多選項 圖示，然後從下拉式選單中按一下 SDK 管理員。

  3. 按一下 SDK 平台。

  4. 確認已選取 Android API 35.0.1。

    如果 狀態 欄顯示 可更新 或 未安裝

    1. 選取 Android API 35.0.1。

    2. 按一下 套用。

    3. 當顯示 確認變更 對話方塊時，按一下 確定。

      會顯示 SDK 快速修復安裝 對話方塊，其中包含完成量表。

    4. 安裝完成時，按一下 完成。

      在您安裝最新的 SDK 之後，狀態 欄可能會顯示 可更新。這表示可能未安裝一些額外的系統映像。您可以忽略此訊息並繼續。

  5. 按一下 SDK 工具。

  6. 確認已選取下列 SDK 工具

    • Android SDK 命令列工具
    • Android SDK 建置工具
    • Android SDK 平台工具
    • Android 模擬器

  7. 如果任何先前工具的 狀態 欄顯示 可更新 或 未安裝

    1. 選取所需的工具。

    2. 按一下 套用。

    3. 當顯示 確認變更 對話方塊時，按一下 確定。

      會顯示 SDK 快速修復安裝 對話方塊，其中包含完成量表。

    4. 安裝完成時，按一下 完成。

設定您的目標 Android 裝置

#

設定 Android 模擬器

#

help 說明

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

  1. 在您的開發電腦上啟用虛擬機器加速。

  2. 啟動 Android Studio。

  3. 前往 設定 對話方塊以檢視 SDK 管理員。

    1. 如果您已開啟專案，請前往 工具 > 裝置管理員。

    2. 如果顯示 歡迎使用 Android Studio 對話方塊，請按一下 開啟 按鈕後面的 更多選項 圖示，然後從下拉式選單中按一下 裝置管理員。

  4. 按一下 虛擬。

  5. 按一下 建立裝置。

    會顯示 虛擬裝置設定 對話方塊。

  6. 在 類別 下方選取 手機 或 平板電腦。

  7. 選取裝置定義。您可以瀏覽或搜尋裝置。

  8. 按一下 下一步。

  9. 如果您的 Mac 在 Intel CPU 上執行，請按一下 x86 映像檔；如果您的 Mac 在 Apple CPU 上執行，請按一下 ARM 映像檔。

  10. 按一下您想要模擬的 Android 版本的一個系統映像檔。

    1. 如果所需映像檔的 版本名稱 右側有 下載 圖示，請按一下它。

      會顯示 SDK 快速修復安裝 對話方塊，其中包含完成量表。

    2. 下載完成時，按一下 完成。

  11. 按一下 下一步。

    虛擬裝置設定 會顯示其 驗證設定 步驟。

  12. 若要重新命名 Android 虛擬裝置 (AVD)，請變更 AVD 名稱 方塊中的值。

  13. 按一下 顯示進階設定 並捲動至 模擬效能。

  14. 從 圖形 下拉式選單中，選取 硬體 - GLES 2.0。

    這會啟用硬體加速並提升轉譯效能。

  15. 驗證您的 AVD 設定。如果正確，請按一下 完成。

    若要深入瞭解 AVD，請查看管理 AVD。

  16. 在 裝置管理員 對話方塊中，按一下所需 AVD 右側的 執行 圖示。模擬器會啟動，並顯示您選取的 Android OS 版本和裝置的預設畫布。

設定您的目標 Android 裝置

#

help 說明

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

  1. 依照 Android 文件 中的說明，在您的裝置上啟用 開發人員選項 和 USB 偵錯。

  2. [選用] 若要利用無線偵錯，請依照 Android 文件 中的說明，在您的裝置上啟用 無線偵錯。

  3. 將您的裝置插入 macOS 電腦。如果您的裝置提示您，請授權您的電腦存取您的裝置。

  4. 確認 Flutter 可辨識您連線的 Android 裝置。

    根據預設，Flutter 會使用您 adb 工具所基於的 Android SDK 版本。若要搭配 Flutter 使用不同的 Android SDK 安裝路徑，請將 ANDROID_SDK_ROOT 環境變數設定為該安裝目錄。

同意 Android 授權條款

#

help 說明

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

  1. 開啟提高權限的控制台視窗。

  2. 執行下列命令以啟用簽署授權。

    flutter doctor --android-licenses

    如果您先前已接受 Android Studio 授權，此命令會傳回

    [========================================] 100% Computing updates...
All SDK package licenses accepted.

    您可以跳過下一個步驟。

  3. 在同意每個授權條款之前，請仔細閱讀每個授權條款。

疑難排解授權問題

#
如何修正尋找 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 路徑。

將其從

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

變更為

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

不要在 Android 和 Studio 之間加上反斜線。

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

source ~/.zshrc

檢查您的開發設定

#

help 說明

執行 Flutter doctor

#

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

  1. 開啟您的終端機。

  2. 若要驗證所有元件的安裝，請執行下列命令。

    flutter doctor

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

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on macOS 14.4.0 23E214 darwin-arm64, locale en)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 16)
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 1 categories.

疑難排解 Flutter doctor 問題

#

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

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

flutter doctor -v

檢查輸出，看看是否有您可能需要安裝的其他軟體或要執行的其他工作。

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

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

#

恭喜。 在安裝所有先決條件和 Flutter SDK 之後，您可以在 macOS 上開始開發適用於 Android 的 Flutter 應用程式。

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

除非另有說明，否則本網站上的文件會反映 Flutter 的最新穩定版本。頁面上次更新於 2024-04-22。 檢視原始碼 或 回報問題。