For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Sugestões
Painel da API
Experimente o ChatGPT
Codex

Codex use case

Depure no simulador de iOS

Use o Codex e o XcodeBuildMCP para interagir com seu aplicativo no Simulator do iOS, registrar evidências e testar ajustes até corrigir o bug.

Difficulty Advanced
Time horizon 1h

Use o Codex para identificar o esquema do Xcode e o simulador adequados, abrir o aplicativo e inspecionar a árvore da interface. O Codex pode simular toques, digitação e gestos de deslizar, capturar telas, coletar logs e conectar o LLDB ao aplicativo quando necessário. Assim, mesmo com um relato vago do bug, é possível implementar e verificar uma pequena correção.

Best for

  • Bugs de interface que só aparecem no Simulator após um toque específico, uma determinada rolagem ou uma sequência específica de preenchimento de um formulário
  • Encerramentos inesperados, travamentos ou falhas de navegação que exigem que o Codex examine logs, capturas de tela, o estado da hierarquia de visualizações e a pilha de chamadas no depurador antes de editar o código
  • Equipes que querem que o Codex reproduza o bug, faça a correção e verifique o resultado, sem que alguém precise percorrer manualmente cada estado da interface

Contents

    ← All use cases

    Depure no simulador de iOS

    Use o Codex e o XcodeBuildMCP para interagir com seu aplicativo no Simulator do iOS, registrar evidências e testar ajustes até corrigir o bug.

    Use o Codex para identificar o esquema do Xcode e o simulador adequados, abrir o aplicativo e inspecionar a árvore da interface. O Codex pode simular toques, digitação e gestos de deslizar, capturar telas, coletar logs e conectar o LLDB ao aplicativo quando necessário. Assim, mesmo com um relato vago do bug, é possível implementar e verificar uma pequena correção.

    Advanced
    1h

    Use o Codex para identificar o esquema do Xcode e o simulador adequados, abrir o aplicativo e inspecionar a árvore da interface. O Codex pode simular toques, digitação e gestos de deslizar, capturar telas, coletar logs e conectar o LLDB ao aplicativo quando necessário. Assim, mesmo com um relato vago do bug, é possível implementar e verificar uma pequena correção.

    Advanced
    1h

    Related links

    Plugin Build iOS Apps Model Context Protocol Habilidades de agentes

    Best for

    • Bugs de interface que só aparecem no Simulator após um toque específico, uma determinada rolagem ou uma sequência específica de preenchimento de um formulário
    • Encerramentos inesperados, travamentos ou falhas de navegação que exigem que o Codex examine logs, capturas de tela, o estado da hierarquia de visualizações e a pilha de chamadas no depurador antes de editar o código
    • Equipes que querem que o Codex reproduza o bug, faça a correção e verifique o resultado, sem que alguém precise percorrer manualmente cada estado da interface

    Skills & Plugins

    • Build iOS Apps
      Use o agente de depuração de iOS para compilar, abrir e inspecionar um aplicativo e interagir com ele no simulador usando o XcodeBuildMCP. Depois, colete logs, capturas de tela e rastreamentos da pilha de chamadas enquanto o Codex investiga a causa do bug.
    Skill Why use it
    Build iOS Apps Use o agente de depuração de iOS para compilar, abrir e inspecionar um aplicativo e interagir com ele no simulador usando o XcodeBuildMCP. Depois, colete logs, capturas de tela e rastreamentos da pilha de chamadas enquanto o Codex investiga a causa do bug.

    Starter prompt

    Use o plugin Build iOS Apps e o XcodeBuildMCP para reproduzir este bug diretamente no Simulator, identificar a causa raiz e implementar uma pequena correção. Relato do bug: [Descreva o comportamento esperado, o que acontece de fato e qualquer configuração conhecida da tela ou da conta.] Restrições: - Primeiro, verifique se já há um projeto, um esquema e um simulador selecionados. Caso contrário, identifique qual projeto ou espaço de trabalho do Xcode deve usar, selecione o esquema do aplicativo, escolha um simulador e use essa configuração até o fim da sessão. - Compile e abra o aplicativo no Simulator. Antes de interagir com ele, confirme que a tela correta está visível usando um registro da estrutura da interface ou uma captura de tela. - Execute por conta própria a sequência exata que reproduz o bug no simulador, com os mesmos toques, entradas de texto, rolagens e gestos de deslizar. Prefira rótulos ou IDs de acessibilidade a coordenadas da tela. Quando o layout mudar, consulte novamente a hierarquia da interface antes da próxima ação. - Durante a depuração, registre o estado visual com capturas de tela e colete os logs do simulador referentes ao período da falha. Se houver indícios de encerramento inesperado ou travamento, registre também os quadros da pilha de chamadas ou as variáveis no LLDB. - Se o simulador ainda não estiver em execução, inicie um e me diga qual dispositivo e qual sistema operacional você escolheu. Se precisar de credenciais ou de uma fixture específica, pare e peça apenas o que falta. - Faça a menor alteração de código que corrija o bug. Depois, repita a sequência no simulador e me diga exatamente como verificou a correção. Entregue: - as etapas que o Codex executou para reproduzir o bug - as principais capturas de tela, os logs ou os detalhes da pilha de chamadas que explicam o bug - a correção no código e a explicação de por que ela funciona - o simulador e o esquema usados na verificação final
    Use o plugin Build iOS Apps e o XcodeBuildMCP para reproduzir este bug diretamente no Simulator, identificar a causa raiz e implementar uma pequena correção. Relato do bug: [Descreva o comportamento esperado, o que acontece de fato e qualquer configuração conhecida da tela ou da conta.] Restrições: - Primeiro, verifique se já há um projeto, um esquema e um simulador selecionados. Caso contrário, identifique qual projeto ou espaço de trabalho do Xcode deve usar, selecione o esquema do aplicativo, escolha um simulador e use essa configuração até o fim da sessão. - Compile e abra o aplicativo no Simulator. Antes de interagir com ele, confirme que a tela correta está visível usando um registro da estrutura da interface ou uma captura de tela. - Execute por conta própria a sequência exata que reproduz o bug no simulador, com os mesmos toques, entradas de texto, rolagens e gestos de deslizar. Prefira rótulos ou IDs de acessibilidade a coordenadas da tela. Quando o layout mudar, consulte novamente a hierarquia da interface antes da próxima ação. - Durante a depuração, registre o estado visual com capturas de tela e colete os logs do simulador referentes ao período da falha. Se houver indícios de encerramento inesperado ou travamento, registre também os quadros da pilha de chamadas ou as variáveis no LLDB. - Se o simulador ainda não estiver em execução, inicie um e me diga qual dispositivo e qual sistema operacional você escolheu. Se precisar de credenciais ou de uma fixture específica, pare e peça apenas o que falta. - Faça a menor alteração de código que corrija o bug. Depois, repita a sequência no simulador e me diga exatamente como verificou a correção. Entregue: - as etapas que o Codex executou para reproduzir o bug - as principais capturas de tela, os logs ou os detalhes da pilha de chamadas que explicam o bug - a correção no código e a explicação de por que ela funciona - o simulador e o esquema usados na verificação final

    Deixe o Codex conduzir todo o ciclo no simulador

    Este caso de uso funciona melhor quando o Codex conduz o ciclo do início ao fim. Ele escolhe o alvo de compilação correto para o aplicativo, abre o aplicativo no Simulator, inspeciona a tela atual, executa os passos para reproduzir o bug e coleta logs e capturas de tela. Se necessário, examina o rastreamento da pilha. Em seguida, corrige o código e repete os mesmos passos para confirmar que o bug foi resolvido.

    Use o plugin Build iOS Apps quando quiser conduzir todo esse ciclo com agentes de IA. O fluxo de depuração para iOS do plugin usa o XcodeBuildMCP, o que permite ao Codex interagir com um simulador em execução e reunir as mesmas evidências que uma pessoa normalmente coletaria à mão.

    Quando o XcodeBuildMCP está configurado com fluxos de automação do simulador e da interface, depuração e coleta de logs, o Codex pode reproduzir o bug, depurá-lo e verificar a correção por conta própria. Se o Codex ainda não tiver escolhido um projeto, um esquema e um simulador, peça que identifique os três primeiro e use a mesma configuração no restante da sessão.

    Aproveite os recursos do XcodeBuildMCP

    Você pode pedir ao Codex que use os recursos a seguir.

    • Identificação do projeto e do simulador. Verifique se o Codex já sabe qual alvo do aplicativo e qual simulador usar. Peça que localize o projeto ou workspace do Xcode, liste os esquemas, encontre ou inicie um simulador e mantenha essa configuração nas próximas etapas de compilação e execução.
    • Compilação e inicialização. Peça que compile o alvo ativo do aplicativo, instale e execute a versão compilada para o simulador e, quando necessário, reinicie o aplicativo com a captura de logs ativada. Se o Codex precisar examinar os logs de execução específicos do aplicativo, peça que identifique o bundle ID.
    • Inspeção e interação com a interface. Peça que examine a hierarquia de acessibilidade da tela, faça capturas de tela, toque nos controles, digite nos campos, percorra listas e execute gestos no simulador, como deslizar o dedo a partir da borda da tela.
    • Logs e estado do depurador. Peça que acompanhe os logs do simulador em tempo real, conecte o LLDB ao aplicativo em execução, defina pontos de interrupção e examine os quadros da pilha e as variáveis locais. Se o aplicativo fechar inesperadamente ou parar de responder e for preciso investigar a falha mais a fundo, peça que execute comandos do depurador.

    Crie o hábito de pedir ao Codex que inspecione a árvore de elementos da interface antes de tocar na tela. O XcodeBuildMCP fornece a hierarquia de acessibilidade e as coordenadas dos elementos. Assim, o Codex pode dar preferência a rótulos estáveis ou IDs de elementos, sem precisar adivinhar onde tocar.

    Transforme um relato vago de bug em um roteiro para reproduzi-lo

    A habilidade de depuração para iOS funciona melhor quando você descreve no prompt um bug específico e um resultado esperado e deixa o Codex operar o aplicativo e coletar evidências por conta própria. Se for necessário fazer login, usar um link direto para uma tela do aplicativo ou ter dados de teste preparados, informe isso uma vez e peça ao Codex que só pause quando a falta desse recurso impedir que prossiga.

    Dicas práticas

    Peça evidências junto com a correção

    Peça ao Codex que identifique exatamente o simulador e o esquema usados e mostre as capturas de tela, os trechos de log e os detalhes da pilha que serviram para explicar o bug. Com essas evidências, fica muito mais fácil revisar a correção do que com uma resposta como “Acho que isso deve resolver o problema.”

    Dê preferência aos rótulos de acessibilidade em vez das coordenadas

    Se o Codex precisar usar coordenadas para tocar em um controle porque ele não tem um rótulo estável nem um identificador de acessibilidade, peça que mencione isso. Muitas vezes, esse é um sinal de que a correção do bug também deve incluir um pequeno ajuste para facilitar os testes da interface.

    Trabalhe com um bug por execução

    A depuração com o simulador oferece muitos recursos, mas é mais fácil confiar no resultado quando cada prompt trata de um único tipo de falha. Peça ao Codex que reproduza o bug, faça a correção e verifique o resultado antes de investigar problemas relacionados.

    Tech stack

    Need

    Automação do simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    As ferramentas disponíveis permitem configurar o simulador, compilar e abrir o aplicativo, registrar a estrutura da interface, simular toques, digitação e gestos, capturar telas, coletar logs e conectar o depurador ao aplicativo.

    Need

    Fluxo de trabalho do agente

    Default options

    Plugin Build iOS Apps

    Why it's needed

    O agente de depuração de iOS do plugin orienta o Codex a reproduzir o bug no simulador, reunir evidências e voltar ao simulador após cada alteração para validar a correção.

    Need

    Observabilidade do aplicativo

    Default options

    Logger, OSLog, LLDB e capturas de tela do Simulator

    Why it's needed

    O Codex pode usar os logs e o estado do aplicativo no depurador para explicar a falha e salvar capturas de tela que mostram exatamente como estava a interface antes e depois da correção.

    Need Default options Why it's needed
    Automação do simulador XcodeBuildMCP As ferramentas disponíveis permitem configurar o simulador, compilar e abrir o aplicativo, registrar a estrutura da interface, simular toques, digitação e gestos, capturar telas, coletar logs e conectar o depurador ao aplicativo.
    Fluxo de trabalho do agente Plugin Build iOS Apps O agente de depuração de iOS do plugin orienta o Codex a reproduzir o bug no simulador, reunir evidências e voltar ao simulador após cada alteração para validar a correção.
    Observabilidade do aplicativo Logger , OSLog , LLDB e capturas de tela do Simulator O Codex pode usar os logs e o estado do aplicativo no depurador para explicar a falha e salvar capturas de tela que mostram exatamente como estava a interface antes e depois da correção.

    Related use cases

    Adicione App Intents ao seu aplicativo iOS

    Use o Codex e o plugin Build iOS Apps para identificar quais ações e entidades seu...

    iOS Code

    Adote o Liquid Glass

    Use o Codex e o plugin Build iOS Apps para revisar a interface atual do aplicativo no iPhone...

    iOS Code

    Desenvolva para iOS

    Use o Codex para criar a estrutura inicial de projetos SwiftUI para iOS

    iOS Code