从网络启动添加 macOS devtools 到 Flutter

若要将 macOS 桌面作为 Flutter 应用目标添加,请遵循此过程。

此过程假定你在 Flutter 入门路径从 iOS 开始时安装了 Xcode 15。

配置 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 3 categories.

解决 Flutter doctor 问题

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

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

$ flutter doctor -v

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

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

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

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