跳至主要內容
目錄

開始在 Windows 上建置 Flutter Android 應用程式

目錄

驗證系統需求

#

要安裝和執行 Flutter，您的 Windows 環境必須符合下列硬體和軟體需求。

硬體需求

#

您的 Windows Flutter 開發環境必須符合下列最低硬體需求。

需求最低建議
x86_64 CPU 核心48
記憶體 (GB)816
顯示器解析度 (像素)WXGA (1366 x 768)FHD (1920 x 1080)
可用磁碟空間 (GB)11.060.0

軟體需求

#

要為 Android 編寫和編譯 Flutter 程式碼，您必須擁有以下版本的 Windows 和所列的軟體套件。

作業系統

#

Flutter 支援 64 位元的 Microsoft Windows 10 或更高版本。這些 Windows 版本應包含所需的Windows PowerShell 5 或更高版本。

開發工具

#

下載並安裝以下套件的 Windows 版本

  • Git for Windows 2.27 或更高版本，用於管理原始碼。

  • Android Studio 2023.3.1 (Jellyfish) 或更高版本，用於偵錯和編譯 Android 的 Java 或 Kotlin 程式碼。Flutter 需要完整版本的 Android Studio。

上述軟體的開發人員為這些產品提供支援。若要疑難排解安裝問題，請參閱該產品的文件。

當您執行目前版本的 flutter doctor 時，它可能會列出其中一個套件的不同版本。如果有的話，請安裝它建議的版本。

設定文字編輯器或 IDE

#

您可以使用任何文字編輯器或整合開發環境 (IDE) 搭配 Flutter 的命令列工具來建置應用程式。

使用具有 Flutter 擴充功能或外掛程式的 IDE 可提供程式碼完成、語法醒目提示、Widget 編輯協助、偵錯和其他功能。

熱門選項包括

安裝 Flutter SDK

#

若要安裝 Flutter SDK，您可以使用 VS Code Flutter 擴充功能，或自行下載並安裝 Flutter 套件。

使用 VS Code 安裝 Flutter

#

若要使用這些指示安裝 Flutter，請確認您已安裝Visual Studio Code 1.77 或更高版本，以及適用於 VS Code 的 Flutter 擴充功能。

提示 VS Code 安裝 Flutter

#

  1. 啟動 VS Code。

  2. 若要開啟 命令選擇區，請按 Control + Shift + P。

  3. 在 命令選擇區 中，輸入 flutter。

  4. 選取 Flutter：新專案。

  5. VS Code 會提示您在電腦上尋找 Flutter SDK。

    1. 如果您已安裝 Flutter SDK，請按一下 尋找 SDK。

    2. 如果您尚未安裝 Flutter SDK，請按一下 下載 SDK。

      如果您尚未依照開發工具先決條件中的指示安裝 Git for Windows，則此選項會將您傳送到 Flutter 安裝頁面。

  6. 當出現 要使用哪個 Flutter 範本？ 的提示時，請忽略它。按 Esc。您可以在檢查開發設定後建立測試專案。

下載 Flutter SDK

#

  1. 當顯示 選取 Flutter SDK 的資料夾 對話方塊時，請選擇您要安裝 Flutter 的位置。

    VS Code 會將您置於您的使用者設定檔中開始。請選擇其他位置。

    請考慮 %USERPROFILE% 或 C:\dev。

  2. 按一下 複製 Flutter。

    在下載 Flutter 時，VS Code 會顯示此快顯通知

    Downloading the Flutter SDK. This may take a few minutes.

    此下載需要幾分鐘。如果您懷疑下載已停止，請按一下 取消，然後重新開始安裝。

  3. 下載 Flutter 完成後，會顯示 輸出 面板。

    Checking Dart SDK version...
Downloading Dart SDK from the Flutter engine ...
Expanding downloaded archive...

    成功時，VS Code 會顯示此快顯通知

    Initializing the Flutter SDK. This may take a few minutes.

    在初始化時，輸出 面板會顯示以下內容

    Building flutter tool...
Running pub upgrade...
Resolving dependencies...
Got dependencies.
Downloading Material fonts...
Downloading Gradle Wrapper...
Downloading package sky_engine...
Downloading flutter_patched_sdk tools...
Downloading flutter_patched_sdk_product tools...
Downloading windows-x64 tools...
Downloading windows-x64/font-subset tools...

    此過程也會執行 flutter doctor -v。在此程序的此時，請忽略此輸出。 Flutter Doctor 可能會顯示不適用於此快速入門的錯誤。

    當 Flutter 安裝成功時，VS Code 會顯示此快顯通知

    Do you want to add the Flutter SDK to PATH so it's accessible
in external terminals?

  4. 按一下 將 SDK 新增至 PATH。

    成功時，會顯示通知

    The Flutter SDK was added to your PATH

  5. VS Code 可能會顯示 Google Analytics 通知。

    如果您同意，請按一下 確定。

  6. 若要在所有 PowerShell 視窗中啟用 flutter

    1. 關閉，然後重新開啟所有 PowerShell 視窗。
    2. 重新啟動 VS Code。

下載然後安裝 Flutter

#

若要安裝 Flutter，請從其封存下載 Flutter SDK 套件、將套件移動到您想要儲存的位置，然後解壓縮 SDK。

  1. 下載以下安裝套件以取得 Flutter SDK 的最新穩定版本。

    (載入中...)

    如需其他發佈管道和較舊的版本，請查看SDK 封存。

    Flutter SDK 應下載到 Windows 的預設下載目錄：%USERPROFILE%\Downloads。

    如果您變更了下載目錄的位置，請將此路徑替換為該路徑。若要尋找您的下載目錄位置，請查看此Microsoft 社群文章。

  2. 建立一個資料夾，您可以在其中安裝 Flutter。

    請考慮在 %USERPROFILE% (C:\Users\{username}) 或 %LOCALAPPDATA% (C:\Users\{username}\AppData\Local) 中建立目錄。

  3. 將檔案解壓縮到您想要儲存 Flutter SDK 的目錄中。

    
  PS C:\> Expand-Archive `
      –Path $env:USERPROFILE\Downloads\flutter_sdk_v1.0.0.zip `
      -Destination $env:USERPROFILE\dev\

    完成後，Flutter SDK 應位於 C:\user\{username}\dev\flutter 目錄中。

更新您的 Windows PATH 變數

#

help 說明

若要在 PowerShell 中執行 Flutter 命令，請將 Flutter 新增至 PATH 環境變數。本節假設您已將 Flutter SDK 安裝在 %USERPROFILE%\dev\flutter 中。

  1. 按 Windows + Pause。

    如果您的鍵盤沒有 Pause 鍵，請嘗試 Windows + Fn + B。

    會顯示 系統 > 關於 對話方塊。

  2. 按一下 進階系統設定 > 進階 > 環境變數...

    會顯示 環境變數 對話方塊。

  3. 在 (使用者名稱) 的使用者變數 區段中，尋找 Path 項目。

    1. 如果該項目存在，請按兩下它。

      會顯示 編輯環境變數 對話方塊。

      1. 按兩下空白列。

      2. 輸入 %USERPROFILE%\dev\flutter\bin。

      3. 按一下 %USERPROFILE%\dev\flutter\bin 項目。

      4. 按一下 上移，直到 Flutter 項目位於清單頂端。

      5. 按一下 確定 三次。

    2. 如果項目不存在，請按一下 新增...。

      會顯示 編輯環境變數 對話方塊。

      1. 在 變數名稱 方塊中，輸入 Path。

      2. 在 變數值 方塊中，輸入 %USERPROFILE%\dev\flutter\bin

      3. 按一下 確定 三次。

  4. 若要啟用這些變更，請關閉並重新開啟任何現有的命令提示字元和 PowerShell 執行個體。

設定 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 Tools。

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

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

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

    1. 選取所需的工具。

    2. 按一下 套用。

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

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

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

設定您的目標 Android 裝置

#

設定 Android 模擬器

#

help 說明

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

  1. 在您的開發電腦上啟用 VM 加速。

  2. 啟動 Android Studio。

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

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

    2. 如果顯示Welcome to Android Studio 對話框，請點擊 Open 按鈕後方的 More Options 圖示，然後從下拉式選單中點擊 Device Manager。

  4. 點擊 Virtual。

  5. 點擊 Create Device。

    隨即顯示 Virtual Device Configuration 對話框。

  6. 在 Category 下選取 Phone 或 Tablet。

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

  8. 點擊 Next。

  9. 點擊 x86 Images。

  10. 點擊您要模擬的 Android 版本的一個系統映像。

    1. 如果所需的映像檔在發行版本名稱右側有下載圖示，請點擊它。

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

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

  11. 點擊 Next。

    Virtual Device Configuration 顯示其 Verify Configuration 步驟。

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

  13. 點擊 Show Advanced Settings 並捲動至 Emulated Performance。

  14. 從 Graphics 下拉式選單中，選取 Hardware - GLES 2.0。

    這會啟用硬體加速並提高渲染效能。

  15. 確認您的 AVD 設定。如果正確，請點擊 Finish。

    若要瞭解更多有關 AVD 的資訊，請查看管理 AVD。

  16. 在 Device Manager 對話框中，點擊您所需 AVD 右側的 Run 圖示。模擬器會啟動並顯示您所選 Android OS 版本和裝置的預設畫布。

設定您的目標 Android 裝置

#

help 說明

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

  1. 如Android 文件所述，在您的裝置上啟用開發人員選項和 USB 偵錯。

  2. 【選用】若要利用無線偵錯，請如Android 文件所述，在您的裝置上啟用無線偵錯。

  3. 安裝Google USB 驅動程式。

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

  5. 確認 Flutter 識別您的連線 Android 裝置。

    在 PowerShell 中，執行

    c:\> flutter devices

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

同意 Android 授權

#

help 說明

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

  1. 開啟提升權限的命令列視窗。

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

    C:> 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 命令會驗證 Windows 完整 Flutter 開發環境的所有元件。

  1. 開啟 PowerShell。

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

    PS C:> flutter doctor

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

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on Microsoft Windows 11 [Version 10.0.22621.3155], locale en)
[✓] Windows version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[!] Visual Studio - develop Windows apps
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 2 categories.

疑難排解 Flutter doctor 問題

#

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

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

PS C:> flutter doctor -v

檢查輸出，以尋找您可能需要安裝的其他軟體或要執行的其他工作。

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

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

#

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

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

管理您的 Flutter SDK

#

若要瞭解更多關於管理您的 Flutter SDK 安裝的資訊，請參閱下列資源。

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