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

Sugestões
API Dashboard
Experimente o ChatGPT
Codex

Codex use case

Depure no simulador do iOS

Use o Codex e o XcodeBuildMCP para controlar seu aplicativo no simulador do iOS, coletar evidências e fazer iterações até chegar a uma correção.

Difficulty Avançado
Time horizon 1 h

Use o Codex para identificar o esquema correto do Xcode e o simulador adequado, iniciar o aplicativo, inspecionar a árvore da interface, tocar, digitar, deslizar, fazer capturas de tela, coletar logs, conectar o LLDB quando necessário e transformar um relatório de bug vago em uma pequena correção verificada.

Ideal para

  • Bugs de interface que só aparecem após uma sequência específica de interações no simulador, como tocar, rolar ou preencher um formulário
  • Falhas, travamentos ou problemas de navegação em que o Codex precisa analisar logs, capturas de tela, o estado da hierarquia de visualizações e um rastreamento de pilha do depurador antes de editar o código
  • Equipes que querem que o Codex seja responsável pelo ciclo de reproduzir, corrigir e verificar, em vez de pedir que uma pessoa percorra manualmente todos os estados da interface

Contents

    ← Todos os casos de uso

    Depure no simulador do iOS

    Use o Codex e o XcodeBuildMCP para controlar seu aplicativo no simulador do iOS, coletar evidências e fazer iterações até chegar a uma correção.

    Use o Codex para identificar o esquema correto do Xcode e o simulador adequado, iniciar o aplicativo, inspecionar a árvore da interface, tocar, digitar, deslizar, fazer capturas de tela, coletar logs, conectar o LLDB quando necessário e transformar um relatório de bug vago em uma pequena correção verificada.

    Avançado
    1 h

    Use o Codex para identificar o esquema correto do Xcode e o simulador adequado, iniciar o aplicativo, inspecionar a árvore da interface, tocar, digitar, deslizar, fazer capturas de tela, coletar logs, conectar o LLDB quando necessário e transformar um relatório de bug vago em uma pequena correção verificada.

    Avançado
    1 h

    Links relacionados

    Plug-in Build iOS Apps Model Context Protocol Habilidades de agentes

    Ideal para

    • Bugs de interface que só aparecem após uma sequência específica de interações no simulador, como tocar, rolar ou preencher um formulário
    • Falhas, travamentos ou problemas de navegação em que o Codex precisa analisar logs, capturas de tela, o estado da hierarquia de visualizações e um rastreamento de pilha do depurador antes de editar o código
    • Equipes que querem que o Codex seja responsável pelo ciclo de reproduzir, corrigir e verificar, em vez de pedir que uma pessoa percorra manualmente todos os estados da interface

    Habilidades e Plug-ins

    • Build iOS Apps
      Use o agente de depuração do iOS para compilar, iniciar, inspecionar e controlar um aplicativo em um simulador com o XcodeBuildMCP. Depois, colete logs, capturas de tela e rastreamentos de pilha enquanto o Codex isola a causa do bug.
    Skill Why use it
    Build iOS Apps Use o agente de depuração do iOS para compilar, iniciar, inspecionar e controlar um aplicativo em um simulador com o XcodeBuildMCP. Depois, colete logs, capturas de tela e rastreamentos de pilha enquanto o Codex isola a causa do bug.

    Prompt inicial

    Use o plug-in Build iOS Apps e o XcodeBuildMCP para reproduzir este bug diretamente no simulador, diagnosticar a causa raiz e implementar uma pequena correção. Relatório do bug: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Restrições: - Verifique primeiro se um projeto, um esquema e um simulador já estão selecionados. Caso contrário, identifique no Xcode o projeto ou workspace correto, selecione o esquema do aplicativo, escolha um simulador e reutilize essa configuração pelo restante da sessão. - Compile e inicie o aplicativo no simulador. Antes de começar a interagir com ele, confirme por meio de um snapshot da interface ou de uma captura de tela que a tela correta está visível. - Percorra por conta própria o caminho exato de reprodução, tocando, digitando, rolando e deslizando no simulador. Prefira rótulos ou IDs de acessibilidade a coordenadas absolutas e consulte novamente a hierarquia da interface antes da próxima ação quando o layout mudar. - Colete evidências durante a depuração: capturas de tela do estado visual, logs do simulador próximos ao momento da falha e frames da pilha ou variáveis do LLDB caso o bug pareça ser uma falha ou um travamento. - Se o simulador ainda não estiver inicializado, inicialize um e diga qual dispositivo e sistema operacional você escolheu. Se forem necessárias credenciais ou uma fixture especial, pause e peça apenas o dado que estiver faltando. - Faça a menor alteração de código que corrija o bug, repita o fluxo no simulador e diga exatamente como verificou a correção. Entregue: - as etapas de reprodução executadas pelo Codex - as principais capturas de tela, logs ou informações da pilha que explicaram o bug - a correção no código e por que ela funciona - o simulador e o esquema usados na verificação final
    Use o plug-in Build iOS Apps e o XcodeBuildMCP para reproduzir este bug diretamente no simulador, diagnosticar a causa raiz e implementar uma pequena correção. Relatório do bug: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Restrições: - Verifique primeiro se um projeto, um esquema e um simulador já estão selecionados. Caso contrário, identifique no Xcode o projeto ou workspace correto, selecione o esquema do aplicativo, escolha um simulador e reutilize essa configuração pelo restante da sessão. - Compile e inicie o aplicativo no simulador. Antes de começar a interagir com ele, confirme por meio de um snapshot da interface ou de uma captura de tela que a tela correta está visível. - Percorra por conta própria o caminho exato de reprodução, tocando, digitando, rolando e deslizando no simulador. Prefira rótulos ou IDs de acessibilidade a coordenadas absolutas e consulte novamente a hierarquia da interface antes da próxima ação quando o layout mudar. - Colete evidências durante a depuração: capturas de tela do estado visual, logs do simulador próximos ao momento da falha e frames da pilha ou variáveis do LLDB caso o bug pareça ser uma falha ou um travamento. - Se o simulador ainda não estiver inicializado, inicialize um e diga qual dispositivo e sistema operacional você escolheu. Se forem necessárias credenciais ou uma fixture especial, pause e peça apenas o dado que estiver faltando. - Faça a menor alteração de código que corrija o bug, repita o fluxo no simulador e diga exatamente como verificou a correção. Entregue: - as etapas de reprodução executadas pelo Codex - as principais capturas de tela, logs ou informações da pilha que explicaram o bug - a correção no código e 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 assume a responsabilidade por todo o ciclo: selecionar o target correto do aplicativo, iniciar o aplicativo no simulador, inspecionar a tela atual, executar as etapas de reprodução, coletar logs e capturas de tela, inspecionar um rastreamento de pilha se necessário, corrigir o código e repetir o mesmo fluxo para comprovar que o bug foi resolvido.

    Use o plug-in Build iOS Apps quando quiser que esse ciclo continue agêntico. O fluxo de trabalho de depuração do iOS usa o XcodeBuildMCP como base, o que permite ao Codex interagir com um simulador já inicializado e coletar as mesmas evidências que uma pessoa normalmente coletaria de forma manual.

    Quando o XcodeBuildMCP está configurado com fluxos de trabalho de automação do simulador, automação da interface, depuração e coleta de logs, o Codex pode assumir todo o ciclo de reprodução, depuração e verificação. Se o Codex ainda não tiver selecionado um projeto, um esquema e um simulador, peça que primeiro identifique esses itens e reutilize essa configuração pelo restante da sessão.

    Aproveite os recursos do XcodeBuildMCP

    Estes são os grupos de recursos práticos que você deve pedir ao Codex para usar:

    • Identificação do projeto e do simulador: verifique se o Codex já sabe qual target do aplicativo e qual simulador usar, localize o projeto ou workspace do Xcode, liste os esquemas, localize ou inicialize um simulador e mantenha essa configuração estável para as próximas etapas de compilação e execução.
    • Controle da compilação e inicialização: compile o target ativo do aplicativo, instale e inicie a versão compilada para o simulador, reinicie-a com captura de logs quando necessário e determine o ID do bundle do aplicativo se o Codex precisar inspecionar logs de execução específicos do aplicativo.
    • Inspeção e interação com a interface: leia a hierarquia de acessibilidade exibida na tela, faça capturas de tela, toque nos controles, digite nos campos, percorra listas e faça gestos de deslizar a partir das bordas ou outros gestos no simulador.
    • Logs e estado do depurador: acompanhe os logs do simulador em tempo real, conecte o LLDB ao aplicativo em execução, defina pontos de interrupção, inspecione frames da pilha e variáveis locais e execute comandos do depurador quando uma falha ou um travamento exigir uma análise mais aprofundada.

    O hábito mais importante é pedir ao Codex que inspecione a árvore de visualizações antes de realizar um toque. O XcodeBuildMCP disponibiliza a hierarquia de acessibilidade junto com as coordenadas, para que o Codex possa preferir rótulos estáveis ou IDs de elementos em vez de tentar adivinhar posições absolutas na tela.

    Transforme um bug vago em um script reproduzível

    A habilidade de depuração do iOS é mais eficaz quando seu prompt descreve um bug específico e um resultado esperado e, então, deixa que o Codex controle o aplicativo e colete evidências de forma autônoma. Se forem necessários um login, um deep link ou uma fixture de teste, mencione isso uma única vez e peça ao Codex que pause somente se a falta desse item impedir o progresso.

    Dicas práticas

    Peça evidências, não apenas uma correção

    Solicite o simulador e o esquema exatos, as capturas de tela, os trechos de logs e os detalhes da pilha que o Codex usou para explicar o bug. Isso torna o patch final muito mais fácil de revisar do que uma resposta como: "Acho que isso deve corrigir o problema."

    Prefira rótulos de acessibilidade a coordenadas

    Se o Codex precisar tocar usando coordenadas porque um controle não tem um rótulo estável nem um identificador de acessibilidade, peça que ele deixe isso explícito. Em geral, esse é um sinal de que a correção do bug também deve incluir uma pequena melhoria na testabilidade da interface.

    Trate um bug por execução

    Um ciclo de depuração baseado no simulador é poderoso, mas inspira mais confiança quando cada prompt se concentra em um único modo de falha. Peça ao Codex que conclua um ciclo de reprodução, correção e verificação antes de ampliar o escopo para issues relacionadas.

    Tech stack

    Need

    Automação do simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    O conjunto atual de ferramentas abrange a configuração do simulador, a compilação e a inicialização do aplicativo, snapshots da interface, toques, digitação, gestos, capturas de tela, coleta de logs e conexão do depurador.

    Need

    Fluxo de trabalho do agente

    Default options

    Plug-in Build iOS Apps

    Why it's needed

    O agente de depuração do iOS do plug-in oferece ao Codex um ciclo claro, centrado no simulador, para reproduzir um bug, coletar evidências e validar a correção após cada alteração.

    Need

    Observabilidade do aplicativo

    Default options

    Logger, OSLog, LLDB e capturas de tela do simulador

    Why it's needed

    O Codex pode usar logs e o estado do depurador para explicar o que falhou e, depois, salvar capturas de tela para comprovar o estado exato da interface antes e depois da correção.

    Need Default options Why it's needed
    Automação do simulador XcodeBuildMCP O conjunto atual de ferramentas abrange a configuração do simulador, a compilação e a inicialização do aplicativo, snapshots da interface, toques, digitação, gestos, capturas de tela, coleta de logs e conexão do depurador.
    Fluxo de trabalho do agente Plug-in Build iOS Apps O agente de depuração do iOS do plug-in oferece ao Codex um ciclo claro, centrado no simulador, para reproduzir um bug, coletar evidências e validar a correção após cada alteração.
    Observabilidade do aplicativo Logger , OSLog , LLDB e capturas de tela do simulador O Codex pode usar logs e o estado do depurador para explicar o que falhou e, depois, salvar capturas de tela para comprovar o estado exato da interface antes e depois da correção.

    Casos de uso relacionados

    Adicionar App Intents a um aplicativo iOS

    Use o Codex e o plug-in Build iOS Apps para identificar as ações e entidades que seu...

    iOS Código

    Adote o Liquid Glass

    Use o Codex e o plug-in Build iOS Apps para auditar a UI existente do iPhone e do iPad...

    iOS Código

    Desenvolva para iOS

    Use o Codex para criar a estrutura inicial de projetos SwiftUI para iOS, mantenha o ciclo de...

    iOS Código