配置 macOS 开发环境

了解如何配置开发环境，以便在 macOS 桌面平台上运行、构建和部署 Flutter 应用。

借助 Xcode，你可以在 macOS 上运行 Flutter 应用，并编译、调试原生 Swift 与 Objective-C 代码。

1. Install Xcode

   1. 安装 Xcode

   若尚未安装，请 安装并配置最新版 Xcode。

   若已安装 Xcode，请用当初的安装方式将其更新到最新版本。

2. Set up Xcode command-line tools

   1. 配置 Xcode 命令行工具

   将 Xcode 命令行工具配置为使用已安装的 Xcode 版本，在你常用的终端中运行：

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

   content_copy

   若 Xcode 安装在其他位置或需使用其他版本，请将 /Applications/Xcode.app 替换为对应路径。

3. Agree to the Xcode licenses

   1. 同意 Xcode 许可协议

   配置好 Xcode 及其命令行工具后，请同意 Xcode 许可协议。

   1. Open your preferred terminal.

   2. 打开你常用的终端。

   3. Run the following command to review and sign the Xcode licenses.

   4. 运行以下命令以查看并签署 Xcode 许可协议。

      $ sudo xcodebuild -license
      

      content_copy

   5. Read and agree to all necessary licenses.

   6. 阅读并同意所有必要的许可协议。

      同意每项许可前，请仔细阅读条款。

      成功接受所有必要许可后，命令会输出如何查看许可的说明。

4. Install CocoaPods

   1. 安装 CocoaPods

   为支持使用原生 macOS 代码的 Flutter 插件，请安装最新版 CocoaPods。

   按 CocoaPods 安装指南 安装 CocoaPods。

   若已安装 CocoaPods，请按 CocoaPods 更新指南 更新。

1. Check for toolchain issues

   1. 检查工具链问题

   检查 macOS 开发环境是否有问题，在你常用的终端中运行 flutter doctor：

   $ flutter doctor -v
   

   content_copy

   若 Xcode 部分有错误或待办项，请完成并解决后再次运行 flutter doctor -v 验证。

2. Check for macOS devices

   1. 检查 macOS 设备

   确保 Flutter 能正确发现 macOS 设备，在你常用的终端中运行 flutter devices：

   $ flutter devices
   

   content_copy

   若配置正确，应至少有一条平台的 macos 条目。

3. Troubleshoot setup issues

   1. 排查配置问题

   若需帮助解决配置问题，请参阅 安装与配置故障排除。

   若仍有问题或疑问，可通过 Flutter 社区 渠道联系。

恭喜！你已完成 Flutter 的 macOS 桌面开发配置，可在 macOS 上继续学习 Flutter，或开始扩展与 macOS 的集成。

Continue learning Flutter
继续学习 Flutter

• Learn the fundamentals
  学习基础知识
• Explore Flutter widgets
  探索 Flutter widget
• Check out samples
  查看示例

Build for macOS
为 macOS 构建

• Build and deploy to macOS
  构建并部署到 macOS
• Bind to native macOS code
  绑定原生 macOS 代码
• Embed native macOS views
  嵌入原生 macOS 视图
• Set up app flavors
  配置应用 flavor
• Use Swift Package Manager
  使用 Swift Package Manager