# Xcode 测试命令使用 XcodeBuildMCP 在模拟器上构建、安装和测试 iOS 应用程序。捕获屏幕截图、日志并验证应用行为。 ## 简介 iOS QA 工程师，专门从事基于模拟器的测试此命令通过以下方式测试 iOS/macOS 应用程序： * 为模拟器构建 * 安装并启动应用程序 * 关键屏幕截图 * 捕获控制台日志以查找错误 * 支持外部流程人工验证 ## 先决条件 ## 主要任务 ### 0\.验证 XcodeBuildMCP 是否已安装 <检查_mcp_安装> **首先，检查 XcodeBuildMCP 工具是否可用。** 尝试致电： mcp__xcodebuildmcp__list_simulators({}) **如果该工具未找到或出现错误：** 告诉用户： **未安装 XcodeBuildMCP** 请先安装 XcodeBuildMCP 服务器： ``````bash claude mcp 添加 XcodeBuildMCP -- npx xcodebuildmcp@latest `````` 然后重新启动 Claude Code 并再次运行 `/xcode-test`。 **在确认 XcodeBuildMCP 正常工作之前，请勿继续**。 ### 1\.发现项目和方案 <发现项目> **查找可用项目：** mcp__xcodebuildmcp__discover_projs({}) **列出该项目的方案：** mcp__xcodebuildmcp__list_schemes({ project_path: "/path/to/Project.xcodeproj" }) **如果提供参数：** * 使用指定的方案名称 * 或“当前”使用默认/上次使用的方案 ### 2\.启动模拟器 <启动模拟器> **列出可用的模拟器：** mcp__xcodebuildmcp__list_simulators({}) **启动首选模拟器（推荐iPhone 15 Pro）：** mcp__xcodebuildmcp__boot_simulator({ Simulator_id: "[uuid]" }) **等待模拟器准备就绪：** 在继续安装之前检查模拟器状态。 ### 3\.构建应用程序 <构建应用程序> **为 iOS 模拟器构建：** mcp__xcodebuildmcp__build_ios_sim_app({ 项目路径：“/path/to/Project.xcodeproj”，方案：“[方案名称]” }) **处理构建失败：** * 捕获构建错误 * 为每个构建错误创建 P1 待办事项 * 向用户报告具体错误详细信息 **成功时：** * 注意构建的应用程序安装路径 * 继续安装步骤 ### 4\.安装和启动 <安装启动> **在模拟器上安装应用程序：** mcp__xcodebuildmcp__install_app_on_simulator({ app_path: "/path/to/built/App.app", Simulator_id：“[uuid]” }) **启动应用程序：** mcp__xcodebuildmcp__launch_app_on_simulator({ Bundle_id: "[app.bundle.id]", Simulator_id：“[uuid]” }) **开始捕获日志：** mcp__xcodebuildmcp__capture_sim_logs({ Simulator_id: "[uuid]", Bundle_id：“[应用程序.bundle.id]” }) ### 5\.测试按键屏幕 <测试屏幕> 对于应用程序中的每个关键屏幕： **截图：** mcp__xcodebuildmcp__take_screenshot({ Simulator_id: "[uuid]", 文件名：“屏幕-[名称].png” }) **查看屏幕截图：** * UI元素正确渲染 * 没有可见的错误消息 * 预期显示的内容 * 布局看起来正确 **检查日志是否有错误：** mcp__xcodebuildmcp__get_sim_logs({ Simulator_id: "[uuid]" }) 寻找： * 崩溃 * 例外情况 * 错误级别的日志消息 * 网络请求失败 ### 6\.人工验证（需要时） <人类验证> 测试触摸时暂停以等待人工输入：流量类型|问什么 ---|--- 使用 Apple 登录 | “请在模拟器上完成使用 Apple 登录” 推送通知 | “发送测试推送并确认其出现” 应用内购买 | “完成沙盒购买” 相机/照片| “授予权限并验证相机是否正常工作” 地点 | “允许位置访问并验证地图更新” 使用询问用户问题： **需要人工验证** 该测试需要[流类型]。请： 1. [在模拟器上采取的操作] 2.【验证内容】它工作正常吗？ 1. 是 - 继续测试 2. 否 - 描述问题 ### 7\.处理失败 <故障处理> 当测试失败时： 1. **记录失败：** * 错误状态截图 * 捕获控制台日志 * 注意复制步骤 2. **询问用户如何继续：** **测试失败：[屏幕/功能]** 问题：[描述] 日志：[相关错误消息] 如何进行？ 1. 立即修复 - 我将帮助调试和修复 2. 创建待办事项 - 添加到 todos/ 供以后使用 3. 跳过 - 继续测试其他屏幕 3. **如果“立即修复”：** * 调查代码中的问题 * 提出修复建议 * 重建并重新测试 4. **如果“创建待办事项”：** * 创建 `{id}-pending-p1-xcode-{description}.md` * 继续测试 ### 8\.测试总结 <测试摘要> 所有测试完成后，呈现总结： ## 📱 Xcode 测试结果 **项目：** [项目名称] **方案：** [方案名称] **模拟器：** [模拟器名称] ### 构建： ✅ 成功 / ❌ 失败 ### 测试屏幕：[count] |屏幕|状态 |笔记| |--------|--------|--------| |发布 | ✅ 通过 | | |首页 | ✅ 通过 | | |设置 | ❌ 失败 |点击崩溃 | |简介 | ⏭️ 跳过 |需要登录 | ### 控制台错误：[count] - [列出发现的任何错误] ### 人工验证：[计数] - 使用 Apple 登录： ✅ 已确认 - 推送通知：✅ 已确认 ### 失败：[计数] - 设置屏幕 - 导航崩溃 ### 已创建待办事项：[count] - `006-pending-p1-xcode-settings-crash.md` ### 结果：[通过/失败/部分] ### 9\.清理测试后： **停止日志捕获：** mcp__xcodebuildmcp__stop_log_capture({ Simulator_id: "[uuid]" }) **可选择关闭模拟器：** mcp__xcodebuildmcp__shutdown_simulator({ Simulator_id: "[uuid]" }) ## 快速使用示例 # 使用默认方案进行测试 /xcode-测试 # 测试具体方案 /xcode-测试 MyApp-调试 # 修改后测试 /xcode-测试当前 ## 与 /ce:review 集成当审查涉及 iOS 代码的 PR 时，“/ce:review”命令可以将其生成为子代理：通用任务（“针对方案 [名称] 运行 /xcode-test。在模拟器上构建、安装、测试关键屏幕、检查崩溃。”）

测试Xcode

包含技能