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

iOS 真机路径

环境检查

在 macOS 上确认：

• 设备通过 USB 或网络连接。
• 设备已在 Xcode/Device Hub 中配对。
• Developer Mode 已开启。
• Xcode 能看到设备并将其作为 run destination。
• 项目签名、Team、Provisioning Profile 和设备支持版本完整。

Linux 上的 libimobiledevice 之类工具最多用于有限的设备识别或文件操作，不能替代 Xcode 的完整构建、签名、安装和 XCTest 链路。没有远程 Mac 时，不把有限识别结果报告为 完整 iOS 测试环境通过。

执行

• 使用项目明确提供的 xcodebuild test 或等价测试命令。
• destination 必须绑定已检查的设备，不在多台设备中猜目标。
• 安装、签名、修改设备设置属于有副作用的操作，必须明确授权。
• 测试失败时保留 xcodebuild 日志、测试报告和设备诊断信息。

收尾

• 不重启、抹掉或清除真机数据。
• 不移除配对、不修改钥匙串和签名配置。
• 报告设备型号、系统版本、destination 和签名状态。