通过

适用于 Windows 的远程 iOS 模拟器

  • 项目

通过适用于 Windows 的远程 iOS 模拟器，您可以在显示于 Windows 和 Visual Studio 2022 中的 iOS 模拟器上测试您的应用程序。

入门

适用于 Windows 的远程 iOS 模拟器作为 Visual Studio 2022 中 .NET 多平台应用 UI 开发工作负载的一部分自动安装。 若要使用它，请执行以下步骤：

  1. 启动 Visual Studio 2022 并创建或加载 .NET MAUI 应用项目。

  2. 如果以前未进行配对，请在 Visual Studio 2022 中将 IDE 与 Mac 构建主机配对。 有关详细信息，请参阅 与 Mac 配对进行 iOS 开发。

  3. 在 Visual Studio 工具栏中，使用 调试目标 下拉列表选择 iOS 模拟器，然后选择特定的 iOS 模拟器：

    Visual Studio iOS 模拟器调试目标。

  4. 在 Visual Studio 工具栏中，按所选 iOS 模拟器的绿色“开始”按钮：

    Visual Studio iOS 模拟器调试目标选择。

    Visual Studio 将生成应用，启动适用于 Windows 的远程 iOS 模拟器，并将应用部署到模拟器：

    Visual Studio iOS 远程模拟器正在运行一个应用。

为 Windows 启用远程 iOS 模拟器

默认情况下，Windows 的远程 iOS 模拟器处于启用状态。 但是，如果之前已禁用，可以通过在 Visual Studio 中导航到 工具 > 选项 > Xamarin > iOS 设置，并确保勾选 远程模拟器到 Windows 来启用它。

Visual Studio 复选框以启用 iOS 远程模拟器。

提示

在 Visual Studio 中禁用远程模拟器时，调试 .NET MAUI iOS 应用将在连接的 Mac 生成主机上打开 iOS 模拟器。

模拟器窗口工具栏

模拟器窗口顶部的工具栏显示五个按钮：

适用于 Windows 工具栏的 Visual Studio iOS 远程模拟器。

按钮如下所示：

  • 主页 – 模拟 iOS 设备上的主页按钮。
  • 锁定 – 锁定模拟器（轻扫以解锁）。
  • 拍摄屏幕截图 – 将模拟器的屏幕截图保存到 \Users\{User}\Pictures\Xamarin\iOS 模拟器。
  • 设置 – 显示键盘和其他设置。
  • 其他选项 – 显示各种模拟器选项，例如旋转和摇动手势。

单击工具栏的 设置 按钮（齿轮图标）将打开 设置 窗口：

iOS 远程模拟器设置。

通过这些设置，可以启用硬件键盘并重置模拟器的内容和设置。

单击工具栏 其他选项 按钮（省略号图标）会显示其他按钮，例如旋转、摇动手势和重新启动：

iOS 远程模拟器其他设置。

注意

右键单击远程 iOS 模拟器窗口中的任意位置将显示所有工具栏按钮作为上下文菜单。

触摸屏支持

许多 Windows 计算机都有触摸屏。 由于适用于 Windows 的远程 iOS 模拟器支持触摸交互，因此你可以使用与物理 iOS 设备一起使用的相同收缩、轻扫和多指触摸手势测试应用。

同样，适用于 Windows 的远程 iOS 模拟器将 Windows 触笔输入视为 Apple Pencil 输入。

声音处理

模拟器播放的声音将通过主机 Mac 的扬声器输出。 Windows 上未听到 iOS 声音。

故障排除

在某些情况下，Xcode 配置问题可能会导致 Windows 的远程 iOS 模拟器陷入连接到 Mac...检查服务器...已连接...的循环中。 发生这种情况时，需要在 Mac 生成主机上删除和重置模拟器：

  • 确保 Xamarin Mac 代理程序 (XMA) 和 Xcode 没有在运行。
  • 删除 ~/Library/Developer/CoreSimulator/Devices 文件夹。
  • 运行 killall -9 com.apple.CoreSimulator.CoreSimulatorService。
  • 运行 xcrun simctl list devices。

在某些情况下，Xcode 可能已生成模拟器设备，也可能导致 Windows 的远程 iOS 模拟器无法正确读取其属性，因为它尝试验证可以部署到哪些设备，从而导致启动循环。

可以通过删除并创建可以部署到的新模拟器来解决此问题：

  • 确保 Xamarin Mac 代理程序（XMA）和 Xcode 没有在运行。
  • 运行 xcrun simctl list | grep -w "Shutdown" | grep -o "([-A-Z0-9]*)" | sed 's/[\(\)]//g' | xargs -I uuid xcrun simctl delete uuid。
  • 运行 xcrun simctl list devices。 你不应该看到列出的任何设备。
  • 在连接的 Mac 上打开 Xcode。
  • 打开 Windows > 设备 & 模拟器。
  • 选择 模拟器。
  • 创建一个新的将要部署到的模拟器。

日志

如果在远程 iOS 模拟器时遇到问题，可以在以下位置查看日志：

  • Mac – ~/Library/Logs/Xamarin/Simulator.Server
  • Windows – %LOCALAPPDATA%\Xamarin\Logs\Xamarin.Simulator