开始在 macOS 上构建 Flutter 原生桌面应用
软件要求
#要在桌面端编写和编译 Flutter 代码，请安装以下软件包。
操作系统
#Flutter 支持在 macOS 12 (Monterey) 或更高版本上开发。本指南假定您的 Mac 运行 zsh 作为您的 默认 Shell。
某些 Flutter 组件需要 Rosetta 2 转换过程。如果您在 Apple 芯片 (ARM) Mac 上开发，请安装 Rosetta 2
sudo softwareupdate --install-rosetta --agree-to-license开发工具
#下载并安装以下软件包。
- Xcode 用于调试和编译原生 Swift 或 Objective-C 代码。Xcode 安装还包括 Git，用于管理 Flutter 版本和您自己的源代码版本控制。
- CocoaPods 用于在您的原生应用中编译和启用 Flutter 插件。
上述软件的开发者提供这些产品的支持。要解决安装问题，请查阅该产品的文档。
文本编辑器或集成开发环境
#你可以使用任何文本编辑器或集成开发环境 (IDE) 结合 Flutter 的命令行工具来构建应用。
使用带有 Flutter 扩展或插件的 IDE 可提供代码补全、语法高亮、小部件编辑辅助、调试及其他功能。
流行的选项包括
- 安装 Visual Studio Code 并安装 VS Code 的 Flutter 扩展。
- 安装 Android Studio 并安装 IntelliJ 的 Flutter 插件。
- 安装 IntelliJ IDEA 并安装 IntelliJ 的 Flutter 插件 和 IntelliJ 的 Android 插件。
安装 Flutter SDK
#要安装 Flutter SDK，你可以使用 VS Code Flutter 扩展，或自行下载并安装 Flutter 包。
使用 VS Code 安装 Flutter
#要使用这些说明安装 Flutter，请确认您已安装 Visual Studio Code 和 VS Code 的 Flutter 扩展。
提示 VS Code 安装 Flutter
#启动 VS Code。
要打开命令面板，请按 Command + Shift + P。
在命令面板中，输入
flutter。选择Flutter: 新建项目。
VS Code 会提示你定位电脑上的 Flutter SDK。
如果你已安装 Flutter SDK，请点击定位 SDK。
如果你未安装 Flutter SDK，请点击下载 SDK。
如果您尚未按照开发工具先决条件中的说明安装 Git，此选项会将您带到 Flutter 安装页面。
当提示哪个 Flutter 模板？时，请忽略。按 Esc。你可以在检查开发环境设置后创建一个测试项目。
下载 Flutter SDK
#当显示选择 Flutter SDK 文件夹对话框时，选择你想要安装 Flutter 的位置。
VS Code 会首先将你定位到用户配置文件目录。请选择其他位置。
考虑使用
~/development/点击克隆 Flutter。
下载 Flutter 时，VS Code 会显示以下弹窗通知：
Downloading the Flutter SDK. This may take a few minutes.Initializing the Flutter SDK. This may take a few minutes.下载和安装需要几分钟。如果你怀疑下载已卡住，请点击取消，然后重新开始安装。
Flutter 安装成功后，VS Code 会显示此弹窗通知：
Do you want to add the Flutter SDK to PATH so it's accessible in external terminals?点击添加 SDK 到 PATH。
成功时，会显示通知
The Flutter SDK was added to your PATHVS Code 可能会显示 Google Analytics 通知。
如果你同意，点击确定。
在所有终端窗口中启用
flutter- 关闭，然后重新打开所有终端窗口。
- 重新启动 VS Code。
下载然后安装 Flutter
#要安装 Flutter，请从其存档下载 Flutter SDK 包，将该包移动到你希望存储的位置，然后解压 SDK。
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
对于其他发布渠道和旧版本，请查阅 SDK 存档。
Flutter SDK 应下载到 macOS 默认下载目录：
~/Downloads/。创建一个你可以安装 Flutter 的文件夹。
考虑在
~/development/创建一个目录。将文件解压到你希望存储 Flutter SDK 的目录中。
unzip ~/Downloads/flutter_sdk_v1.0.0.zip \ -d ~/development/完成后，Flutter SDK 应位于
~/development/flutter目录中。
将 Flutter 添加到您的 PATH
#要在终端中运行 Flutter 命令，请将 Flutter 添加到 PATH 环境变量中。本指南假定您的 Mac 运行最新的默认 Shell，即 zsh。Zsh 使用 .zshenv 文件来设置环境变量。
启动您偏好的文本编辑器。
如果存在，请在您的文本编辑器中打开 Zsh 环境变量文件
~/.zshenv。如果不存在，请创建~/.zshenv。复制以下行并将其粘贴到您的
~/.zshenv文件末尾。bashexport PATH=$HOME/development/flutter/bin:$PATH保存您的
~/.zshenv文件。要应用此更改，请重新启动所有打开的终端会话。
如果您使用其他 Shell，请查阅此关于设置 PATH 的教程。
配置 iOS 开发环境
#安装和配置 Xcode
#要为桌面端开发 Flutter 应用，请安装 Xcode 以编译为原生字节码。
打开 App Store 并登录。
搜索
Xcode。点击安装。
Xcode 安装程序占用 6GB 或更多的存储空间。下载可能需要一些时间。
要配置命令行工具以使用已安装的 Xcode 版本，请使用以下命令。
sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'此路径适用于最新版本的 Xcode。如果您需要使用不同版本，请指定该路径。
签署 Xcode 许可协议。
sudo xcodebuild -license
尽量保持使用当前版本的 Xcode。
安装 CocoaPods
#如果您的应用依赖于包含原生桌面代码的Flutter 插件，请安装 CocoaPods。此程序捆绑了 Flutter 和桌面代码的各种依赖项。
要安装和设置 CocoaPods，请运行以下命令
按照CocoaPods 安装指南安装
cocoapods。sudo gem install cocoapods启动您偏好的文本编辑器。
在您的文本编辑器中打开 Zsh 环境变量文件
~/.zshenv。复制以下行并将其粘贴到您的
~/.zshenv文件末尾。bashexport PATH=$HOME/.gem/bin:$PATH保存您的
~/.zshenv文件。要应用此更改，请重新启动所有打开的终端会话。
检查开发环境设置
#运行 Flutter doctor
#flutter doctor 命令验证 macOS 完整 Flutter 开发环境的所有组件。
打开您的终端。
要验证所有组件的安装，请运行以下命令。
flutter doctor
由于你选择进行桌面开发，所以不需要所有组件。如果你按照本指南进行操作，该命令应该会为你设置的工具和平台输出 [✓]。
Flutter doctor 问题排查
#当 flutter doctor 命令返回错误时，可能与 Flutter、VS Code、Xcode、已连接设备或网络资源有关。
如果 flutter doctor 命令针对这些组件中的任何一个返回错误，请使用详细模式标志再次运行它。
flutter doctor -v检查输出，看是否需要安装其他软件或执行其他任务。
如果你更改了 Flutter SDK 或其相关组件的配置，请再次运行 flutter doctor 来验证安装。
开始使用 Flutter 开发 macOS 桌面应用
#恭喜。在安装了所有先决条件和 Flutter SDK 后，您可以开始为 macOS 桌面开发 Flutter 应用了。
要继续你的学习之旅，请查阅以下指南：
管理 Flutter SDK
#要了解更多关于管理 Flutter SDK 安装的信息，请查阅以下资源：