跳至主要內容

從 Android 開始,將 macOS 新增為 Flutter 的目標平台

若要將 macOS 桌面新增為 Flutter 應用程式目標,請遵循此程序。

安裝 Xcode

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

設定 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 (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 16)
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 1 categories.

疑難排解 Flutter doctor 問題

#

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

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

flutter doctor -v

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

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

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

#

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

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