跳到主內容

設定 Android 開發環境

配置您的開發環境，以便執行、構建和部署 Flutter 應用到 Android 裝置。

瞭解如何設定開發環境，以便執行、構建和部署 Flutter 應用到 Android 裝置。

選擇你的開發平臺

#

本頁面上的說明是針對在 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. 如果您已開啟專案，請轉到工具 > SDK 管理器。

    3. 如果 SDK Platforms 選項卡未開啟，請切換至該選項卡。

    4. 確認已選中 API Level 為 36 的第一個條目。

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

      1. 勾選該條目或行的複選框。

      2. 點選“應用”。

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

        SDK Component Installer 對話方塊會顯示安裝進度。

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

    5. 切換至 SDK Tools 選項卡。

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

      • Android SDK 構建工具
      • Android SDK 命令列工具
      • Android 模擬器
      • Android SDK 平臺工具
      • CMake
      • NDK (Side by side)

    7. 如果上述任何工具的“狀態”列顯示“有可用更新”或“未安裝”

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

      2. 點選“應用”。

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

        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. 如果您已開啟專案，請轉到工具 > 裝置管理器。

    3. 點選顯示為 + 圖示的 Create Virtual Device 按鈕。

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

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

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

    6. 點選“下一步”。

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

    8. 為您想要模擬的 Android 版本選擇一個系統映象。

      1. 如果所需的映象名稱左側有 Download 圖示，請點選它。

        SDK Component Installer 對話方塊會顯示安裝進度。

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

    9. 點選頂部選項卡欄中的 Additional settings，然後滾動到 Emulated Performance。

    10. 從 Graphics acceleration 下拉選單中，選擇提及 Hardware 的選項。

      這將啟用硬體加速，從而提高渲染效能。

    11. 驗證您的虛擬裝置配置。如果配置正確，點選 Finish。

      要了解有關虛擬裝置的更多資訊，請檢視建立和管理虛擬裝置。

  3. 嘗試執行模擬器

    在 Device Manager 對話方塊中，點選所需虛擬裝置右側的 Run 圖示。

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

要設定開發環境以在物理 Android 裝置上執行 Flutter 應用，請按照以下步驟操作

  1. 配置您的裝置

    按照在裝置上配置開發者選項中的說明，在您的裝置上啟用 Developer options 和 USB debugging。

  2. 啟用無線除錯

    要使用無線除錯，請按照使用 Wi-Fi 連線到您的裝置中的說明，在您的裝置上啟用 Wireless debugging。

  3. 安裝平臺必要元件

    如果您是在 Windows 上進行開發，請先安裝您特定裝置所需的 USB 驅動程式，具體請參考安裝 OEM 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 應用

除非另有說明，本網站的文件反映的是 Flutter 3.41.5 版本。頁面最後更新於 2026-05-05。 檢視原始碼 或 報告問題。