# iOS Simulator 路径

## 硬边界

Apple 官方 Simulator 随 Xcode 提供并运行在 Mac 上。Linux/Debian 不能本地安装官方
iOS Simulator，因此 Linux 本机只能转发到远程 Mac、macOS CI 或云设备。

## macOS 环境检查

```bash
xcode-select -p
xcodebuild -version
xcrun simctl list runtimes
xcrun simctl list devices available
```

必须存在：

- Xcode。
- 与项目兼容的 iOS Simulator runtime。
- 用户指定的设备类型和系统版本。
- 可用的 workspace/project、scheme 和 destination。

若 runtime 缺失，可在用户明确要求安装时使用 Xcode 的 Components 设置或
`xcodebuild -downloadPlatform iOS` 下载。该安装只能发生在 macOS，不属于 Debian 安装
能力。

## 执行与收尾

- 启动并等待指定 Simulator 完成 boot。
- 只执行目标 scheme 的测试，不将 Simulator 结果外推为真实设备硬件结论。
- 失败时保留 xcodebuild 输出、Simulator 日志和截图/测试产物。
- 只关闭本轮由 skill 启动且配置为临时会话的 Simulator。