跳至主要內容

從網頁開始為 Flutter 新增 macOS 作為目標平台

若要將 macOS 作為 Flutter 應用程式的目標平台,請按照以下步驟操作。

安裝 Xcode

#
  1. 為 Xcode 分配至少 26 GB 的儲存空間。建議分配 42 GB 的儲存空間以獲得最佳配置。
  2. 安裝 Xcode 16 以除錯和編譯原生 Swift 或 Objective-C 程式碼。

設定 iOS 開發

#

安裝並設定 Xcode

#

若要開發適用於 macOS 的 Flutter 應用程式,請安裝 Xcode 以編譯為原生位元組碼。

  1. 開啟 App Store 並登入。

  2. 搜尋 Xcode

  3. 點擊 安裝

    Xcode 安裝程式會佔用 6 GB 以上的儲存空間。下載可能需要一些時間。

  4. 若要設定命令列工具以使用已安裝的 Xcode 版本,請使用以下命令。

    sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

    針對最新版本的 Xcode 使用此路徑。如果您需要使用不同的版本,請指定該路徑。

  5. 簽署 Xcode 許可協議。

    sudo xcodebuild -license

盡量保持使用最新版本的 Xcode。

安裝 CocoaPods

#

如果您的應用程式依賴具有原生 macOS 程式碼的 Flutter 外掛程式,請安裝 CocoaPods。此程式會捆綁 Flutter 和 macOS 程式碼之間的各種相依性。

若要安裝和設定 CocoaPods,請執行以下命令

  1. 依照 CocoaPods 安裝指南安裝 cocoapods

    sudo gem install cocoapods
  2. 啟動您偏好的文字編輯器。

  3. 在文字編輯器中開啟 Zsh 環境變數檔案 ~/.zshenv

  4. 複製以下行並將其貼到您的 ~/.zshenv 檔案末尾。

    bash
    export PATH=$HOME/.gem/bin:$PATH
  5. 儲存您的 ~/.zshenv 檔案。

  6. 若要套用此變更,請重新啟動所有開啟的終端機工作階段。

檢查您的開發設定

#

help 說明

執行 Flutter doctor

#

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

  1. 開啟您的終端機。

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

    flutter doctor

由於您選擇為 macOS 進行開發,因此您不需要所有組件。如果您遵循本指南,您命令的結果應類似於

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on macOS 14.4.0 23E214 darwin-arm64, locale en)
[!] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 16)
[!] Android Studio (not installed)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 2 categories.

針對 Flutter doctor 問題進行疑難排解

#

flutter doctor 命令傳回錯誤時,可能是因為 Flutter、VS Code、Xcode、連線的裝置或網路資源所導致。

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

flutter doctor -v

檢查輸出是否有您可能需要安裝的其他軟體或需要執行的其他任務。

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

開始使用 Flutter 開發 macOS 桌面應用程式

#

恭喜。 在安裝所有先決條件和 Flutter SDK 後,您可以開始開發適用於 macOS 桌面的 Flutter 應用程式。

若要繼續您的學習旅程,請參考以下指南