从 Web 开始向 Flutter 添加 macOS 开发工具

要将 macOS 添加为 macOS 的 Flutter 应用程序目标,请遵循此过程。

安装 Xcode

  1. 为 Xcode 分配至少 26 GB 的存储空间。考虑为最佳配置分配 42 GB 的存储空间。
  2. 安装 Xcode 15 以调试和编译本机 Swift 或 ObjectiveC 代码。

配置 iOS 开发

配置 Xcode

要为 macOS 开发 Flutter 应用程序,请安装 Xcode 以编译为本机字节码。

  1. 要配置命令行工具以使用已安装的 Xcode 版本,请运行以下命令。

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

    要使用最新版本的 Xcode,请使用此路径。如果你需要使用不同的版本,请改而指定该路径。

  2. 签署 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 文件的末尾。

    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.19.3, on macOS 14.4.0 23E214 darwin-arm64, locale en)
[!] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 15)
[!] Android Studio (not installed)
[✓] VS Code (version 1.86)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 2 categories.

解决 Flutter doctor 问题

flutter doctor 命令返回错误时,可能是由于 Flutter、VS Code、Xcode、连接的设备或网络资源。

如果 flutter doctor 命令针对任何这些组件返回错误,请使用详细标志再次运行它。

$ flutter doctor -v

检查输出以了解您可能需要安装的其他软件或要执行的进一步任务。

如果您更改了 Flutter SDK 或其相关组件的配置,请再次运行 flutter doctor 以验证安装。

使用 Flutter 开始开发 macOS 桌面应用

恭喜!现在您已经安装了所有先决条件和 Flutter SDK,您应该能够开始为 macOS 桌面开发 Flutter 应用。