跳至主要內容
目錄

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

目錄

驗證系統需求

#

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

硬體需求

#

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

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

軟體需求

#

若要為網頁撰寫和編譯 Flutter 程式碼，您必須具備下列版本的 Windows 和所列的軟體套件。

作業系統

#

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

開發工具

#

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

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

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

設定文字編輯器或 IDE

#

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

使用具備 Flutter 擴充功能或外掛程式的 IDE，可提供程式碼自動完成、語法醒目提示、小工具編輯輔助、偵錯和其他功能。

熱門選項包括

安裝 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。

      如果您尚未依照開發工具的先決條件中的指示安裝適用於 Windows 的 Git，此選項會將您傳送到 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 Community 貼文。

  2. 建立一個可以安裝 Flutter 的資料夾。

    請考慮在 %USERPROFILE% (C:\Users\{使用者名稱}) 或 %LOCALAPPDATA% (C:\Users\{使用者名稱}\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\{使用者名稱}\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 執行個體。

檢查您的開發設定

#

help 說明

執行 Flutter doctor

#

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

  1. 開啟 PowerShell。

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

    PS C:> flutter doctor

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

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
[✓] Chrome - develop for the web
[!] Visual Studio - develop Windows apps
[!] Android Studio (not installed)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 3 categories.

疑難排解 Flutter doctor 問題

#

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

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

PS C:> flutter doctor -v

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

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

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

#

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

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

管理您的 Flutter SDK

#

若要深入瞭解如何管理您的 Flutter SDK 安裝，請參閱下列資源。

除非另有說明，否則本網站上的文件反映 Flutter 的最新穩定版本。頁面最後更新於 2024-10-28。 檢視來源 或 回報問題。