Agente de Debug do iOS

Visão Geral

Use o XcodeBuildMCP para compilar e executar o esquema de projeto atual em um simulador iOS em execução, interagir com a interface do usuário e capturar logs. Prefira as ferramentas MCP para controle do simulador, logs e inspeção de visualizações.

Quando Usar

• Quando o usuário pedir para executar, depurar ou inspecionar um aplicativo iOS em um simulador.
• Quando você precisar de interação com a interface do usuário do simulador, capturas de tela ou logs de tempo de execução via XcodeBuildMCP.

Fluxo de Trabalho Principal

Siga esta sequência, a menos que o usuário peça uma ação mais específica.

1) Descobrir o simulador em execução

• Chame mcp__XcodeBuildMCP__list_sims e selecione o simulador com o estado Booted.
• Se nenhum estiver em execução, peça ao usuário para iniciar um (não inicie automaticamente, a menos que solicitado).

2) Definir padrões da sessão

• Chame mcp__XcodeBuildMCP__session-set-defaults com:
  • projectPath ou workspacePath (o que o repositório usar)
  • scheme para o aplicativo atual
  • simulatorId do dispositivo em execução
  • Opcional: configuration: "Debug", useLatestOS: true

3) Compilar + executar (quando solicitado)

• Chame mcp__XcodeBuildMCP__build_run_sim.
• Se a compilação falhar, verifique a saída do erro e tente novamente (opcionalmente com preferXcodebuild: true) ou escale para o usuário antes de tentar qualquer interação com a interface do usuário.
• Após uma compilação bem-sucedida, verifique se o aplicativo foi iniciado chamando mcp__XcodeBuildMCP__describe_ui ou mcp__XcodeBuildMCP__screenshot antes de prosseguir para a interação com a interface do usuário.
• Se o aplicativo já estiver compilado e apenas o lançamento for solicitado, use mcp__XcodeBuildMCP__launch_app_sim.
• Se o ID do pacote for desconhecido:
  1. mcp__XcodeBuildMCP__get_sim_app_path
  2. mcp__XcodeBuildMCP__get_app_bundle_id

Interação com a Interface do Usuário e Depuração

Use estas opções quando solicitado a inspecionar ou interagir com o aplicativo em execução.

• Descrever UI: mcp__XcodeBuildMCP__describe_ui antes de tocar ou deslizar.
• Tocar: mcp__XcodeBuildMCP__tap (prefira id ou label; use coordenadas apenas se necessário).
• Digitar: mcp__XcodeBuildMCP__type_text após focar em um campo.
• Gestos: mcp__XcodeBuildMCP__gesture para rolagens comuns e deslizes de borda.
• Captura de tela: mcp__XcodeBuildMCP__screenshot para confirmação visual.

Logs e Saída do Console

• Iniciar logs: mcp__XcodeBuildMCP__start_sim_log_cap com o ID do pacote do aplicativo.
• Parar logs: mcp__XcodeBuildMCP__stop_sim_log_cap e resuma as linhas importantes.
• Para saída do console, defina captureConsole: true e reinicie, se necessário.

Solução de Problemas

• Se a compilação falhar, pergunte se deseja tentar novamente com preferXcodebuild: true.
• Se o aplicativo errado for iniciado, confirme o esquema e o ID do pacote.
• Se os elementos da interface do usuário não puderem ser tocados, execute novamente describe_ui após as alterações de layout.

Exemplo

Solicitação do usuário:

Execute, depure ou inspecione um aplicativo iOS em um simulador.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.