从 macOS 开始添加 iOS 作为目标平台

要准备在 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 时已启用了 Mac 在 iOS 设备上的信任。

启用证书在不同版本的 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