跳到主要內容

從 Web 開始,新增 macOS 作為 Flutter 的目標平台

若要將 macOS 桌面新增為 Flutter 應用程式的目標,請按照以下步驟進行。

此步驟假設您在 Flutter 入門路徑從 iOS 開始時已安裝 Xcode 16。

設定 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 3 categories.

疑難排解 Flutter doctor 問題

#

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

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

flutter doctor -v

檢查輸出,查看您可能需要安裝的其他軟體或要執行的其他工作。

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

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

#

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

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