开始在 macOS 上构建 Flutter iOS 应用

要使用这些说明安装 Flutter，请验证您是否已安装Visual Studio Code 1.77 或更高版本，以及VS Code 的 Flutter 扩展。

1. 启动 VS Code。

2. 要打开**命令面板**，请按Command + Shift + P。

3. 在**命令面板**中，键入 flutter。

4. 选择**Flutter：新建项目**。

5. VS Code 会提示您在计算机上找到 Flutter SDK。

   1. 如果您已安装 Flutter SDK，请单击**查找 SDK**。

   2. 如果您尚未安装 Flutter SDK，请单击**下载 SDK**。

      如果您尚未按照开发工具先决条件中的说明安装 Git，此选项将带您进入 Flutter 安装页面。

6. 当系统提示**哪个 Flutter 模板？**时，请忽略它。按Esc。在检查开发环境设置后，您可以创建一个测试项目。

1. 显示**选择 Flutter SDK 的文件夹**对话框时，选择要安装 Flutter 的位置。

   VS Code 会将您置于用户配置文件中以开始。选择其他位置。

   考虑 ~/development/

2. 单击**克隆 Flutter**。

   下载 Flutter 期间，VS Code 会显示此弹出通知

   Downloading the Flutter SDK. This may take a few minutes.

   此下载需要几分钟。如果您怀疑下载已挂起，请单击**取消**，然后重新开始安装。

3. 下载完成后，**输出**面板会显示。

   Checking Dart SDK version...
   Downloading Dart SDK from the Flutter engine ...
   Expanding downloaded archive...

   成功后，VS Code 会显示此弹出通知

   Initializing the Flutter SDK. This may take a few minutes.

   初始化期间，**输出**面板会显示以下内容

   Building flutter tool...
   Running pub upgrade...
   Resolving dependencies...
   Got dependencies.
   Downloading Material fonts...
   Downloading Gradle Wrapper...
   Downloading package sky_engine...
   Downloading flutter_patched_sdk tools...
   Downloading flutter_patched_sdk_product tools...
   Downloading windows-x64 tools...
   Downloading windows-x64/font-subset tools...

   此过程还会运行 flutter doctor -v。在此过程中的这一点，请*忽略此输出*。Flutter Doctor 可能会显示不适用于此快速入门指南的错误。

   Flutter 安装成功后，VS Code 会显示此弹出通知

   Do you want to add the Flutter SDK to PATH so it's accessible
   in external terminals?

4. VS Code 可能会显示 Google Analytics 通知。

   如果您同意，请单击**确定**。

5. 要在所有终端窗口中启用 flutter

   1. 关闭然后重新打开所有终端窗口。
   2. 重新启动 VS Code。

要准备在 iOS 模拟器上运行和测试您的 Flutter 应用，请按照以下步骤操作。

1. 要安装 iOS 模拟器，请运行以下命令。

   xcodebuild -downloadPlatform iOS

2. 要启动模拟器，请运行以下命令

   open -a Simulator

3. 将模拟器设置为使用 64 位设备。这涵盖了 iPhone 5s 或更高版本。

   • 从**Xcode**中，选择一个模拟器设备类型。

     1. 转到**窗口** > **设备和模拟器**。

        您也可以按Cmd + Shift + 2。

     2. 打开**设备和模拟器**对话框后，单击**模拟器**。

     3. 从左侧列表中选择一个**模拟器**，或按**+**创建新的模拟器。

   • 在**模拟器**应用中，转到**文件** > **打开模拟器** > 选择您的目标 iOS 设备。

   • 要检查模拟器中的设备版本，请打开**设置**应用 > **常规** > **关于**。

4. 模拟的高屏幕密度 iOS 设备可能会超出您的屏幕。如果在您的 Mac 上看起来确实如此，请更改**模拟器**应用中的显示大小。

   显示尺寸	菜单命令	键盘快捷键
   小	**窗口** > **物理尺寸**	Cmd + 1
   中等	窗口 > 点精确	Cmd + 2
   高清精确	窗口 > 像素精确	Cmd + 3
   适应屏幕	窗口 > 适应屏幕	Cmd + 4

要将您的 Flutter 应用部署到物理 iPhone 或 iPad，您需要执行以下操作

• 创建一个 Apple 开发者 账户。
• 在 Xcode 中设置物理设备部署。
• 创建开发配置文件以自签名证书。
• 如果您的应用使用 Flutter 插件，请安装第三方 CocoaPods 依赖项管理器。

您现在可以跳过此步骤。在您准备好将应用分发到 App Store 之前，您实际上并不需要 Apple 开发者账户。

如果您只需要测试部署您的应用，请完成第一步并继续下一节。

1. 如果您没有 Apple ID，请创建一个。

2. 如果您尚未加入 Apple 开发者 计划，请立即加入。

   要了解有关会员类型的更多信息，请查看 选择会员资格。

配置您的物理 iOS 设备以连接到 Xcode。

1. 将您的 iOS 设备连接到 Mac 上的 USB 端口。

2. 首次将您的 iOS 设备连接到您的 Mac 时，您的 iOS 设备会显示信任此电脑？对话框。

3. 点击信任。

   

4. 出现提示时，解锁您的 iOS 设备。

从 iOS 16 开始，Apple 要求您启用开发者模式 以防止恶意软件。在部署到运行 iOS 16 或更高版本的设备之前，请启用开发者模式。

1. 点击设置 > 隐私与安全性 > 开发者模式。

2. 点击切换开发者模式到开启。

3. 点击重启。

4. iOS 设备重启后，解锁您的 iOS 设备。

5. 当打开开发者模式？对话框出现时，点击打开。

   该对话框解释说，开发者模式需要降低 iOS 设备的安全性。

6. 解锁您的 iOS 设备。

要部署到物理 iOS 设备，您需要与您的 Mac 和 iOS 设备建立信任关系。这要求您将签名的开发者证书加载到您的 iOS 设备上。要在 Xcode 中签名应用，您需要创建一个开发配置文件。

要预配您的项目，请遵循 Xcode 签名流程。

1. 启动 Xcode。

2. 转到Xcode > 设置...

   1. 转到Xcode > 设置...
   2. 点击账户。
   3. 点击+。
   4. 选择Apple ID 并点击继续。
   5. 出现提示时，输入您的Apple ID 和密码。
   6. 关闭设置对话框。

   开发和测试支持任何 Apple ID。

3. 转到文件 > 打开...

   您也可以按 Cmd + O。

4. 导航到您的 Flutter 项目目录。

5. 打开项目中的默认 Xcode 工作区：ios/Runner.xcworkspace。

6. 在运行按钮右侧的设备下拉菜单中选择您打算部署到的物理 iOS 设备。

   它应该出现在iOS 设备标题下。

7. 在左侧导航面板的目标下，选择Runner。

8. 在Runner设置窗格中，点击签名与功能。

9. 在顶部选择全部。

10. 选择自动管理签名。

11. 从团队下拉菜单中选择一个团队。

    团队是在 Apple 开发者账户 页面上的App Store Connect 部分创建的。如果您尚未创建团队，可以选择个人团队。

    团队下拉菜单将该选项显示为您的姓名（个人团队）。

    

    选择团队后，Xcode 会执行以下任务

    1. 创建并下载开发证书
    2. 将您的设备注册到您的账户，
    3. 根据需要创建并下载配置文件

如果 Xcode 中的自动签名失败，请验证项目的常规 > 标识 > 捆绑包标识符值是否唯一。

首次连接物理 iOS 设备时，请为您的 Mac 和 iOS 设备上的开发证书启用信任。

当您将设备连接到 Mac时，您应该已启用了 iOS 设备上对 Mac 的信任。

启用证书在不同版本的 iOS 中有所不同。

如果codesign 想要访问密钥...对话框显示

1. 输入您的 macOS 密码。

2. 点击始终允许。

要使用 Wi-Fi 连接调试您的设备，请按照以下步骤操作。

1. 将您的 iOS 设备连接到与您的 macOS 设备相同的网络。

2. 为您的 iOS 设备设置密码。

3. 打开Xcode。

4. 转到**窗口** > **设备和模拟器**。

   您也可以按 Shift + Cmd + 2。

5. 选择您的 iOS 设备。

6. 选择通过网络连接。

7. 设备名称旁边出现网络图标后，将您的 iOS 设备从 Mac 上拔下。

如果您在使用flutter run时未看到您的设备列出，请延长超时时间。超时时间默认为 10 秒。要延长超时时间，请将值更改为大于 10 的整数。

flutter run --device-timeout 60