跳到主内容

了解如何设置您的开发环境，以便为 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。 查看源代码 或 报告问题。