跳到主內容

瞭解如何設定您的開發環境，以便為 macOS 桌面平臺執行、構建和部署 Flutter 應用。

設定開發工具

#

使用 Xcode，您可以執行 macOS 上的 Flutter 應用，以及編譯和除錯原生的 Swift 和 Objective-C 程式碼。

  1. 安裝 Xcode

    安裝並設定最新版本的 Xcode。

    如果您已安裝 Xcode，請使用最初安裝它的方法將其更新到最新版本。

  2. 設定 Xcode 命令列工具

    要配置 Xcode 命令列工具以使用您安裝的 Xcode 版本，請在您常用的終端中執行以下命令：

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

    如果您在其他位置下載了 Xcode 或需要使用其他版本，請將 /Applications/Xcode.app 替換為相應的路徑。

  3. 同意 Xcode 許可協議

    設定好 Xcode 並配置好其命令列工具後，請同意 Xcode 的許可協議。

    1. 開啟您偏好的終端。

    2. 執行以下命令以檢視並簽署 Xcode 許可協議。

      sudo xcodebuild -license

    3. 閱讀並同意所有必要的許可協議。

      在同意每項許可協議的條款之前，請仔細閱讀。

      成功接受所有必要的許可協議後，該命令將輸出如何檢視許可協議。

  4. 安裝 CocoaPods

    要支援使用原生 macOS 程式碼的Flutter 外掛，請安裝最新版本的 CocoaPods。

    請遵循 CocoaPods 安裝指南 來安裝 CocoaPods。

    如果您已安裝 CocoaPods，請遵循 CocoaPods 更新指南 來更新它。

驗證您的設定

#

  1. 檢查工具鏈問題

    要檢查您的 macOS 開發設定是否存在任何問題，請在您常用的終端中執行 flutter doctor 命令。

    flutter doctor -v

    如果在 **Xcode** 部分看到任何錯誤或需要完成的任務，請完成並解決它們，然後再次執行 flutter doctor -v 來驗證任何更改。

  2. 檢查 macOS 裝置

    為確保 Flutter 可以正確查詢並連線到您的 macOS 裝置，請在您常用的終端中執行 flutter devices。

    flutter devices

    如果一切設定正確，應該至少有一個條目，其平臺標記為 **macos**。

  3. 排查設定問題

    如果您在解決任何設定問題時需要幫助，請檢視 安裝和設定故障排除。

    如果您仍然有問題或疑問，請透過 Flutter 的任一社群渠道聯絡我們。

開始 macOS 開發

#

恭喜！既然您已為 Flutter 設定了 macOS 桌面開發，您可以繼續您的 Flutter 學習之旅，在 macOS 上進行測試，或開始擴充套件與 macOS 的整合。

繼續學習 Flutter
構建 macOS 應用

除非另有說明，本網站上的文件反映的是 Flutter 的最新穩定版本。頁面最後更新於 2025-05-12。 檢視原始碼 或 報告問題。