Skip to main content

設定 Android 開發環境

設定您的開發環境，以便在 Android 裝置上執行、建置與部署 Flutter 應用程式。

學習如何設定您的開發環境， 以便在 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 Manager 設定對話框。

      1. 如果已開啟 Welcome to Android Studio 對話框， 請點擊 New Project 與 Open 按鈕後方的 More Actions 按鈕， 然後從下拉選單中選擇 SDK Manager。

      2. 如果您已開啟專案， 請前往 Tools > SDK Manager。

    3. 如果尚未開啟 SDK Platforms 分頁，請切換至該分頁。

    4. 確認第一個 API Level 為 36 的項目已被選取。

      如果 Status 欄顯示 Update available 或 Not installed：

      1. 勾選該項目的核取方塊。

      2. 點擊 Apply。

      3. 當出現 Confirm Change 對話框時，點擊 OK。

        這時會顯示 SDK Component Installer 對話框及進度指示器。

      4. 安裝完成後，點擊 Finish。

    5. 切換至 SDK Tools 分頁。

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

      • Android SDK Build-Tools
      • Android SDK Command-line Tools
      • Android Emulator
      • Android SDK Platform-Tools
      • CMake
      • NDK (Side by side)

    7. 如果上述任一工具的 Status 欄顯示 Update available 或 Not installed：

      1. 勾選所需工具的核取方塊。

      2. 點擊 Apply。

      3. 當出現 Confirm Change 對話框時，點擊 OK。

        這時會顯示 SDK Component Installer 對話框及進度指示器。

      4. 安裝完成後，點擊 Finish。

  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. 開啟 Device Manager 設定對話框。

      1. 如果已開啟 Welcome to Android Studio 對話框， 請點擊 New Project 和 Open 按鈕後方的 More Actions 按鈕， 然後從下拉選單中選擇 Virtual Device Manager。

      2. 如果您已經開啟專案， 前往 Tools > Device Manager。

    3. 點擊出現為 + 圖示的 Create Virtual Device 按鈕。

      這時會顯示 Virtual Device Configuration 對話框。

    4. 在 Form Factor 下選擇 Phone 或 Tablet。

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

    6. 點擊 Next。

    7. 如果有提供選項， 請根據您的開發電腦是 x64 還是 Arm64 裝置，選擇 x86 Images 或 ARM Images。

    8. 選擇您想要模擬的 Android 版本的系統映像檔。

      1. 如果所需映像檔名稱左側有 Download 圖示，請點擊它。

        這時會顯示 SDK Component Installer 對話框並顯示進度指示器。

      2. 下載完成後，點擊 Finish。

    9. 點擊上方標籤列的 Additional settings，並捲動到 Emulated Performance。

    10. 在 Graphics acceleration 下拉選單中， 選擇包含 Hardware 的選項。

      這將啟用硬體加速，提升渲染效能。

    11. 確認您的虛擬裝置設定。 如果正確，請點擊 Finish。

      想了解更多虛擬裝置資訊， 請參考 Create and manage virtual devices。

  3. 嘗試啟動模擬器

    在 Device Manager 對話框中， 點擊您想要的虛擬裝置右側的 Run 圖示。

    模擬器應會啟動，並顯示您所選 Android 作業系統版本與裝置的預設畫面。

若要設定開發環境以在實體 Android 裝置上執行 Flutter 應用程式，請依照以下步驟操作：

  1. 設定您的裝置

    如 Configure on-device developer options 所述， 在您的裝置上啟用開發人員選項與 USB 除錯。

  2. 啟用無線除錯

    若要使用無線除錯， 請依照 Connect to your device using Wi-Fi 的說明， 在您的裝置上啟用無線除錯。

  3. 安裝平台相依前置需求

    如果您是在 Windows 上開發，請先依照 Install OEM USB drivers 的說明， 為您的裝置安裝必要的 USB 驅動程式。

  4. 連接您的裝置

    將您的裝置插入電腦。 若裝置出現提示， 請授權您的電腦存取 Android 裝置。

  5. 確認裝置連線

    若要確認 Flutter 是否辨識到您已連接的 Android 裝置， 請在您偏好的終端機執行 flutter devices：

    flutter devices

    您的裝置應該會被偵測到，並顯示為已連接的裝置。

驗證您的設定

#

  1. 檢查工具鏈問題

    若要檢查您的 Android 開發環境是否有任何問題， 請在您偏好的終端機中執行 flutter doctor 指令：

    flutter doctor

    如果您在 Android toolchain 或 Android Studio 區塊下看到任何錯誤或待完成的事項，

    請完成所有提及的任務，然後再次執行 flutter doctor 來驗證變更。

  2. 檢查 Android 裝置

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

    flutter emulators && flutter devices

    根據您是設定模擬器還是實體裝置， 至少應該會有一個項目，其平台標記為 android。

  3. 疑難排解安裝問題

    如果您需要協助解決任何安裝問題， 請參考安裝與設定疑難排解。

    如果您仍然遇到問題或有其他疑問， 歡迎在 Flutter 的社群頻道上尋求協助。

開始為 Android 開發

#

恭喜您！ 現在您已經完成 Flutter 的 Android 開發環境設定， 您可以繼續學習 Flutter 並在 Android 上進行測試， 或是開始加強與 Android 的整合。

繼續學習 Flutter
為 Android 建置

Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-14. View source or report an issue.