用途:在 iOS 模拟器上构建、安装并测试 iOS 应用,通过 XcodeBuildMCP 完成构建、启动、截图与日志检查,用于修改 iOS 代码后、创建 PR 前或验证应用行为。
前提条件:已安装 Xcode 及命令行工具;已连接 XcodeBuildMCP MCP 服务器;存在有效的 Xcode 项目或工作区;至少有一个可用的 iOS 模拟器。
主要流程:先调用 list_simulators 确认 XcodeBuildMCP 可用(Claude Code 中为 mcp__xcodebuildmcp__list_simulators),未安装时可用 brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp 或 npx -y xcodebuildmcp@latest mcp 安装并配置;再用 discover_projs 与 list_schemes 发现项目与 scheme;用 boot_simulator 启动模拟器(推荐 iPhone 15 Pro);用 build_ios_sim_app 构建;用 install_app_on_simulator、launch_app_on_simulator 安装启动,并用 capture_sim_logs 开始抓日志;对关键界面用 take_screenshot 截图、用 get_sim_logs 检查崩溃、异常、错误日志与失败网络请求。
人工验证:涉及 Sign in with Apple、推送通知、内购、相机/相册、定位等需设备交互的流程时,需暂停并请用户手动完成;SwiftUI Text 内联链接的模拟点击无法触发手势识别器,需用户手动点击,或用 xcrun simctl openurl <device> <URL> 作为回退。
失败处理与收尾:失败时截图、抓日志、记录复现步骤,并询问用户是立即修复还是跳过;测试完成后用 stop_log_capture 停止日志,可选 shutdown_simulator 关闭模拟器,最后输出包含项目、scheme、模拟器、构建结果、各界面状态、控制台错误、人工验证与最终结果的测试摘要。
限制:依赖 XcodeBuildMCP 与模拟器环境;部分流程需人工介入;SwiftUI Text 内联链接自动化点击存在平台限制。