跳至主要内容

从网页启动,将 macOS 添加为 Flutter 的目标平台

要将 macOS 添加为 Flutter 应用的目标平台,请按照以下步骤操作。

安装 Xcode

#
  1. 为 Xcode 分配至少 26 GB 的存储空间。建议分配 42 GB 的存储空间以获得最佳配置。
  2. 安装 Xcode 16 以调试和编译原生 Swift 或 ObjectiveC 代码。

配置 iOS 开发环境

#

安装和配置 Xcode

#

要为 macOS 开发 Flutter 应用,请安装 Xcode 以编译为原生字节码。

  1. 打开**App Store** 并登录。

  2. 搜索Xcode

  3. 点击**安装**。

    Xcode 安装程序占用 6 GB 以上的存储空间。下载可能需要一些时间。

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

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

    此路径适用于最新版本的 Xcode。如果您需要使用其他版本,请指定该路径。

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

    bash
    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.24.5, 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 16)
[!] Android Studio (not installed)
[✓] VS Code (version 1.95)
[✓] 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 应用了。

要继续您的学习之旅,请查阅以下指南