Xcode构建测试

技能简介

xcodebuildmcp 提供完整的 Xcode 项目构建、测试与运行能力，覆盖 iOS 模拟器、macOS 及真机设备。支持 UI 自动化操作、截图录屏、日志采集与 LLDB 调试，帮助开发者快速验证代码变更。

业务背景

面向iOS/macOS开发团队，解决手动构建测试效率低、真机调试门槛高的问题。支持一键完成模拟器/真机构建、自动化测试与UI验证，无需频繁切换Xcode界面；配合截图录屏和日志采集，快速定位问题，缩短代码验证周期，让开发者专注功能迭代而非环境配置。

落地案例：某App团队每日需验证多个功能分支，开发人员通过工具自动发现项目scheme，在指定模拟器上并行执行构建与单元测试；测试人员编写UI自动化脚本完成登录、下单流程验证，自动捕获异常截图并导出系统日志，替代人工反复操作，实现持续集成环节的无人值守验证。

能做什么

• 自动发现项目/工作空间及可用 scheme
• 在模拟器或真机上构建、运行、测试应用
• 管理模拟器状态（启动、擦除、外观设置、定位模拟）
• 执行 UI 自动化（点击、输入、滑动、手势）
• 捕获截图、屏幕录像及系统日志
• LLDB 调试会话（附加进程、设置断点）

使用说明

前置条件：需先安装并配置 XcodeBuildMCP 服务器，确保 MCP 客户端可识别工具（如 mcp__xcodebuildmcp__build_run_sim）。

标准流程：

1. 发现项目结构：
   mcp__xcodebuildmcp__discover_projs → mcp__xcodebuildmcp__list_schemes
2. 设置会话默认值（避免重复传参）：
   mcp__xcodebuildmcp__session-set-defaults
3. 执行任务：构建运行、测试或 UI 自动化
4. 验证结果：截图、日志或录屏取证

关键规则：坐标类操作前必须先调用 describe_ui；优先使用会话默认值减少参数冗余；未指定设备时列出选项或选用最新系统版本。

输入与输出

见下方输入与输出表格。

风险提示

• 擦除模拟器、清理构建目录等破坏性操作需用户明确授权
• 真机调试需要有效签名证书与开发者账号
• UI 自动化依赖当前界面状态，页面变化可能导致脚本失败
• 日志采集可能包含敏感信息，注意数据脱敏

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ipavlidakis/xcodebuildmcp/SKILL.md
来源类型：GitHub 仓库