瞭解如何設定您的開發環境, 以在 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 安裝並設定其命令列工具(Command Line Tools)後,請同意 Xcode 的授權條款。

    1. 開啟你偏好的終端機。

    2. 執行以下指令以檢閱並簽署 Xcode 授權條款。

      sudo xcodebuild -license
    3. 閱讀並同意所有必要的授權條款。

      在同意每份授權條款之前, 請仔細閱讀每一份內容。

      當你成功接受所有必要的授權條款後, 指令會輸出如何檢視這些授權條款的說明。

  4. 安裝 CocoaPods

    若要支援使用原生 macOS 程式碼的 Flutter 外掛, 請安裝最新版的 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 桌面開發環境設定, 可以一邊在 macOS 上測試,一邊持續你的 Flutter 學習之旅, 或開始擴展與 macOS 的整合。