跳至主要内容

从 Web 开始将 macOS 添加为 Flutter 的目标平台

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

此步骤假定您在 Flutter 入门路径以 iOS 开始时安装了 Xcode 16。

配置 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 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 应用了。

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