# ios-tester

检查并执行 iOS 真机或 Xcode Simulator 测试；在 Linux 上明确报告官方 Simulator 不可本地运行，并支持远程 Mac/云设备入口。

## 什么时候使用

- 「检查 iOS 测试环境」
- 「用 iPhone 真机跑测试」
- 「用 iOS Simulator 跑 smoke」
- 「在远程 Mac 上跑 iOS 测试」
- 「报告本次 iOS 测试结果」

## 使用前准备

- 本地 Simulator 或真机测试需要 macOS、Xcode 和对应平台组件。
- 真机还需要设备配对、Developer Mode、签名和 Provisioning Profile。
- Linux 上不能安装 Apple 官方 Simulator；需要提供远程 Mac、macOS CI 或云真机入口。
- 项目需要提供 Xcode scheme、workspace/project、destination 和测试命令。

## 使用示例

```text
检查当前机器是否可以跑 iOS Simulator
```

```text
用 iPhone 15 真机跑 iOS smoke，并保留 xcodebuild 日志
```

```text
在远程 Mac 上运行 iOS 测试，最后给出 pass/fail/environment-fail 结果
```

## Agent 会做什么

1. 先判断当前是 macOS、本地 Linux、远程 Mac 还是云设备路径。
2. 检查 Xcode、Simulator runtime、设备配对、签名和测试命令。
3. 环境完整后执行测试；环境不完整时停止，不将阻塞误报为产品失败。
4. 采集测试日志、失败诊断和可用的截图或测试产物。
5. 生成包含目标、环境、用例结果和证据路径的运行报告。

## 如何判断完成

- 有明确的目标路径和环境检查结论。
- 每条测试都有标准结果状态。
- macOS/远程执行有日志和产物；Linux 本地不可行时有清晰的修复建议。