軟體要求

#

要編寫和編譯適用於桌面的 Flutter 程式碼,您必須擁有以下版本的 Windows 和列出的軟體程式包。

作業系統

#

Flutter 支援在 64 位 Windows 10 和 11 上進行開發。

開發工具

#

下載並安裝以下軟體包的 Windows 版本

  • Git for Windows 用於管理 Flutter 版本和你的原始碼版本。

  • Visual Studio 2022 用於除錯和編譯原生 C++ Windows 程式碼。請確保安裝了“**使用 C++ 進行桌面開發**”工作負載。這使您可以構建 Windows 應用,包括其所有預設元件。“**Visual Studio**”是獨立於“**Visual Studio Code**”的 IDE。

上述軟體的開發者提供這些產品的支援。要解決安裝問題,請查閱該產品的文件。

配置文字編輯器或 IDE

#

你可以使用任何文字編輯器或整合開發環境 (IDE) 結合 Flutter 的命令列工具來構建應用。

使用帶有 Flutter 擴充套件或外掛的 IDE 可提供程式碼補全、語法高亮、小部件編輯輔助、除錯及其他功能。

流行的選項包括

安裝 Flutter SDK

#

要安裝 Flutter SDK,你可以使用 VS Code Flutter 擴充套件,或自行下載並安裝 Flutter 包。

使用 VS Code 安裝 Flutter

#

要按照這些說明安裝 Flutter,請驗證您已安裝 Visual Studio CodeVS 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.
    Initializing the Flutter SDK. This may take a few minutes.

    下載和安裝需要幾分鐘。如果你懷疑下載已卡住,請點選取消,然後重新開始安裝。

    Flutter 安裝成功後,VS Code 會顯示此彈窗通知:

    Do you want to add the Flutter SDK to PATH so it's accessible
    in external terminals?
  3. 點選新增 SDK 到 PATH

    成功時,會顯示通知

    The Flutter SDK was added to your PATH
  4. VS Code 可能會顯示 Google Analytics 通知。

    如果你同意,點選確定

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

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

下載然後安裝 Flutter

#

要安裝 Flutter,請從其存檔下載 Flutter SDK 包,將該包移動到你希望儲存的位置,然後解壓 SDK。

  1. 下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。

    (載入中...)

    對於其他釋出渠道和舊版本,請查閱 SDK 存檔

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

    如果您更改了 Downloads 目錄的位置,請將此路徑替換為您更改後的路徑。要查詢您的 Downloads 目錄位置,請檢視此 Microsoft Community 帖子

  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 變數

#

幫助

要在 PowerShell 中執行 Flutter 命令,請將 Flutter 新增到 PATH 環境變數。本節假定你已將 Flutter SDK 安裝在 %USERPROFILE%\dev\flutter 中。

  1. 按下 Windows + Pause

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

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

  2. 點選高階系統設定 > 高階 > 環境變數...

    顯示環境變數對話方塊。

  3. 使用者變數 (username) 部分,查詢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 例項。

檢查開發環境設定

#

幫助

執行 Flutter doctor

#

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

  1. 開啟 PowerShell。

  2. 要驗證所有元件的安裝,請執行以下命令。

    PS C:> flutter doctor

由於你選擇進行桌面開發,所以不需要所有元件。如果你按照本指南進行操作,該命令應該會為你設定的工具和平臺輸出 [✓]

Flutter doctor 問題排查

#

flutter doctor 命令返回錯誤時,可能是 Flutter、VS Code、Visual Studio、連線的裝置或網路資源出現問題。

如果 flutter doctor 命令針對這些元件中的任何一個返回錯誤,請使用詳細模式標誌再次執行它。

PS C:> flutter doctor -v

檢查輸出,看是否需要安裝其他軟體或執行其他任務。

如果你更改了 Flutter SDK 或其相關元件的配置,請再次執行 flutter doctor 來驗證安裝。

使用 Flutter 開發 Windows 桌面應用

#

恭喜。 在安裝了所有先決條件和 Flutter SDK 後,您就可以開始為 Windows 桌面開發 Flutter 應用了。

要繼續你的學習之旅,請查閱以下指南:

管理 Flutter SDK

#

要了解更多關於管理 Flutter SDK 安裝的資訊,請查閱以下資源: