用途:该技能通过 XcodeBuildMCP 在已启动的 iOS 模拟器上构建并运行当前项目 scheme,与界面交互并捕获日志。操作模拟器、日志和视图检查时优先使用 MCP 工具。
核心流程:先调用 mcp__XcodeBuildMCP__list_sims 找出状态为 Booted 的模拟器;若没有已启动的模拟器,应请用户启动,而非自动启动(除非用户要求)。随后调用 mcp__XcodeBuildMCP__session-set-defaults 设置 projectPath 或 workspacePath(按仓库实际情况选择)、当前应用的 scheme 和已启动设备的 simulatorId,可选 configuration: "Debug"、useLatestOS: true。需要构建运行时调用 mcp__XcodeBuildMCP__build_run_sim;若应用已构建只需启动,使用 mcp__XcodeBuildMCP__launch_app_sim。若不知道 bundle id,可调用 mcp__XcodeBuildMCP__get_sim_app_path 和 mcp__XcodeBuildMCP__get_app_bundle_id。
界面交互与调试:检查或操作运行中的应用时,先调用 mcp__XcodeBuildMCP__describe_ui 描述界面,再进行点击或滑动;点击用 mcp__XcodeBuildMCP__tap(优先使用 id 或 label,必要时才用坐标);在聚焦输入框后使用 mcp__XcodeBuildMCP__type_text 输入文本;用 mcp__XcodeBuildMCP__gesture 执行常见滚动和边缘滑动;用 mcp__XcodeBuildMCP__screenshot 做视觉确认。
日志与控制台:用 mcp__XcodeBuildMCP__start_sim_log_cap 配合应用 bundle id 启动日志,用 mcp__XcodeBuildMCP__stop_sim_log_cap 停止并总结关键行;如需控制台输出,设置 captureConsole: true,必要时重新启动应用。
故障排查:构建失败时,询问是否以 preferXcodebuild: true 重试;启动的应用不对时,确认 scheme 与 bundle id;界面元素无法点击时,在布局变化后重新运行 describe_ui。具体收费、价格、平台与效果等资料暂未提供。