从 Android 开始向 Flutter 添加 macOS devtools

要将 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 (Android SDK version 34.0.0)
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 15)
[✓] Android Studio (version 2023.1 (Hedgehog) or later)
[✓] VS Code (version 1.86)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 1 categories.

解决 Flutter doctor 问题

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

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

$ flutter doctor -v

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

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

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

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