瞭解如何設定您的開發環境,以便在 Android 裝置上執行、構建和部署 Flutter 應用。

選擇你的開發平臺

#

本頁面的說明配置為涵蓋在 Windows 裝置上設定 Android 開發。

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

設定 Android 工具

#

使用 Android Studio,您可以在實體 Android 裝置或 Android 模擬器上執行 Flutter 應用。

如果您尚未安裝,請安裝並設定最新穩定版本的 Android Studio

  1. 安裝先決條件庫

    如果您在 Linux 上開發,請先安裝 Android Studio 所需的 32 位庫的先決條件集合

  2. 安裝 Android Studio

    如果您尚未安裝,請安裝並設定最新穩定版本的 Android Studio

    如果您已有 Android Studio,請確保它是最新版本

  3. 安裝 Android SDK 和工具

    1. 啟動 Android Studio

    2. 前往 **設定** 頁面以檢視 **SDK 管理器**。

    3. 如果您已開啟專案,請轉到工具 > SDK 管理器

    4. 如果打開了 **歡迎使用 Android Studio** 對話方塊,請點選 **開啟** 按鈕旁邊的 **更多選項** 圖示,然後從下拉選單中點選 **SDK 管理器**。

    5. 如果未開啟 **SDK 平臺** 選項卡,請切換到它。

    6. 驗證是否已選中 **API 級別** 為 **35** 的第一項。

      如果“狀態”列顯示“有可用更新”或“未安裝

      1. 選中該項或行的複選框。

      2. 點選“應用”。

      3. 當“確認更改”對話方塊顯示時,點選“確定”。

        此時會顯示帶有進度指示器的 **SDK 元件安裝程式** 對話方塊。

      4. 安裝完成後,點選 **完成**。

    7. 切換到 **SDK 工具** 選項卡。

    8. 驗證是否已選擇以下 SDK 工具

      • Android SDK 構建工具
      • Android SDK 命令列工具
      • Android 模擬器
      • Android SDK 平臺工具
    9. 如果上述任何工具的“狀態”列顯示“有可用更新”或“未安裝

      1. 選中所需工具的複選框。

      2. 點選“應用”。

      3. 當“確認更改”對話方塊顯示時,點選“確定”。

        此時會顯示帶有進度指示器的 **SDK 元件安裝程式** 對話方塊。

      4. 安裝完成後,點選 **完成**。

  4. 同意 Android 許可

    在使用 Flutter 之前以及安裝所有先決條件之後,請同意 Android SDK 平臺的許可。

    1. 開啟您偏好的終端。

    2. 執行以下命令以檢視和簽名 SDK 許可。

      flutter doctor --android-licenses
    3. 閱讀並接受任何必要的許可。

      如果您之前未接受所有 SDK 許可,則在為 Android 開發之前,需要先閱讀並同意它們。

      在同意每項許可協議的條款之前,請仔細閱讀。

      成功接受所有必需的許可後,您應該會看到類似以下的輸出:

      All SDK package licenses accepted.

設定 Android 裝置

#

您可以在實體 Android 裝置上除錯 Flutter 應用,或在 Android 模擬器上執行它們。

要設定開發環境以便在 Android 模擬器上執行 Flutter 應用,請執行以下步驟:

  1. 設定您的開發裝置

    在您的開發計算機上啟用 VM 加速

  2. 設定新模擬器

    1. 啟動 Android Studio

    2. 前往 **設定** 對話方塊以檢視 **裝置管理器**。

      1. 如果您已開啟專案,請轉到工具 > 裝置管理器

      2. 如果打開了 **歡迎使用 Android Studio** 對話方塊,請點選 **開啟** 按鈕旁邊的 **更多選項** 圖示,然後從下拉選單中選擇 **裝置管理器**。

    3. 點選“虛擬”。

    4. 點選“建立裝置”。

      將顯示“虛擬裝置配置”對話方塊。

    5. 在“類別”下選擇“手機”或“平板電腦”。

    6. 選擇一個裝置定義。您可以瀏覽或搜尋裝置。

    7. 點選“下一步”。

    8. 根據您的開發計算機是 x64 還是 Arm64 裝置,點選 **x86 映象** 或 **ARM 映象**。

    9. 點選您要模擬的 Android 版本的系統映象。

      1. 如果所需的映象在“釋出名稱”右側有一個“下載”圖示,請點選它。

        此時會顯示帶有進度指示器的 **SDK 快速修復安裝** 對話方塊。

      2. 下載完成後,點選“完成”。

    10. 點選“下一步”。

      虛擬裝置配置”顯示其“驗證配置”步驟。

    11. 要重新命名 Android 虛擬裝置 (AVD),請更改“AVD 名稱”框中的值。

    12. 點選“顯示高階設定”並滾動到“模擬效能”。

    13. 從“圖形”下拉選單中,選擇“硬體 - GLES 2.0”。

      這將啟用 硬體加速,提高渲染效能。

    14. 驗證您的 AVD 配置。如果正確,點選“完成”。

      要了解有關 AVD 的更多資訊,請查閱管理 AVD

  3. 嘗試執行模擬器

    在 **裝置管理器** 對話方塊中,點選您所需 AVD 右側的 **執行** 圖示。

    模擬器應會啟動並顯示您所選 Android OS 版本和裝置的預設畫布。

  4. 驗證模擬器設定

    要驗證 Flutter 是否可以連線到您設定的模擬器,請在您偏好的終端中執行 flutter emulators

    flutter emulators

    您設定的模擬器應會被找到並顯示為可用模擬器之一。

要設定開發環境以便在實體 Android 裝置上執行 Flutter 應用,請執行以下步驟:

  1. 配置您的裝置

    在您的裝置上啟用 **開發者選項** 和 **USB 除錯**,如 配置裝置上的開發者選項 中所述。

  2. 啟用無線除錯

    要利用無線除錯,請在您的裝置上啟用 **無線除錯**,如 使用 Wi-Fi 連線到您的裝置 中所述。

  3. 安裝平臺先決條件

    如果您在 Windows 上開發,請先安裝特定裝置所需的 USB 驅動程式,如 安裝 OEM USB 驅動程式 中所述。

  4. 連線您的裝置

    將您的裝置插入計算機。如果您的裝置彈出提示,請授權您的計算機訪問您的 Android 裝置。

  5. 驗證裝置連線

    要驗證 Flutter 是否識別您連線的 Android 裝置,請在您偏好的終端中執行 flutter devices

    flutter devices

    您的裝置應會被找到並顯示為已連線裝置。

驗證您的設定

#
  1. 檢查工具鏈問題

    要檢查您的 Android 開發設定是否存在任何問題,請在您偏好的終端中執行 flutter doctor 命令。

    flutter doctor

    如果您在 **Android 工具鏈** 或 **Android Studio** 部分看到任何錯誤或需要完成的任務,

    完成任何提到的任務,然後再次執行 flutter doctor 以驗證任何更改。

  2. 檢查 Android 裝置

    為確保您正確設定了模擬器和/或實體 Android 裝置,請在您偏好的終端中執行 flutter emulatorsflutter devices

    flutter emulators && flutter devices

    根據您是設定了模擬器還是裝置,至少應有一個輸出條目,其平臺標記為 **android**。

  3. 排查設定問題

    如果您需要幫助解決任何設定問題,請參閱 安裝和設定故障排除

    如果您仍然有問題或疑問,請透過 Flutter 的任一社群渠道聯絡我們。

開始 Android 開發

#

恭喜!您現在已經為 Flutter 設定了 Android 開發,可以繼續您的 Flutter 學習之旅,同時在 Android 上進行測試,或者開始改進與 Android 的整合。