.pouch/skills/ios-tester/references/simulator.md

iOS Simulator 路径

硬边界

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

macOS 环境检查

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。