介绍
# Xcodebuildmcp
## 概述
使用 xcodebuildmcp 工具集来构建/运行/测试应用程序，管理模拟器/设备，自动化 UI，以及捕获日志/屏幕媒体。默认采用安全、可重复的流程：发现 → 设置默认值 → 执行 → 验证。
## 前置条件与 MCP 设置
此技能假设 XcodeBuildMCP 服务器已安装并向您的 MCP 客户端暴露，以便工具显示（例如，`mcp__xcodebuildmcp__build_run_sim`）。如果工具缺失，请遵循以下设置步骤：
- `references/mcp-setup.md` （要求 + MCP 客户端配置示例）
## 示例请求
- “在最新的模拟器上构建并运行 iOS 应用程序，并截取屏幕截图。” - “在模拟器上运行单元测试，并分享失败的测试日志。” - “打开模拟器，导航至设置，并切换深色模式。” - “在我已连接的 iPhone 上安装并启动应用程序。”
## 快速入门（常用流程）
1) 发现项目/工作空间和方案： - `mcp__xcodebuildmcp__discover_projs` - `mcp__xcodebuildmcp__list_schemes`
2) 设置会话默认值（以便后续工具无需重复参数）： - `mcp__xcodebuildmcp__session-set-defaults` （workspacePath/projectPath, scheme, simulatorId/deviceId）
3) 运行任务： - 构建/运行：`mcp__xcodebuildmcp__build_run_sim` 或 `mcp__xcodebuildmcp__build_run_macos` - 测试：`mcp__xcodebuildmcp__test_sim` / `mcp__xcodebuildmcp__test_macos` / `mcp__xcodebuildmcp__test_device`
4) 验证并收集证据： - `mcp__xcodebuildmcp__screenshot` （模拟器） - `mcp__xcodebuildmcp__start_sim_log_cap` → `mcp__xcodebuildmcp__stop_sim_log_cap`
## 任务索引
- **构建/运行**：iOS 模拟器、macOS、设备安装 - **测试**：模拟器/macOS/设备 - **模拟器管理**：列表/启动/擦除/外观/位置/手势 - **UI 自动化**：描述 UI → 点击/输入/滑动/手势 - **日志与调试**：模拟器日志、设备日志、LLDB 附加/断点 - **媒体**：屏幕截图、屏幕录制
加载 `references/workflows.md` 以获取详细的分步序列和命令模式。
## 操作规则
- 在基于坐标的点击/滑动/长按之前，始终调用 `mcp__xcodebuildmcp__describe_ui`。 - 优先尽早调用 `mcp__xcodebuildmcp__session-set-defaults` 以减少参数干扰。 - 如果用户未指定目标设备/模拟器，请列出选项并询问（或者通过 `useLatestOS` 选择一个合理的默认值）。 - 避免破坏性操作（擦除模拟器、清理），除非用户要求。