For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale
Codex

Codex use case

Débogage dans le simulateur iOS

Utilisez Codex et XcodeBuildMCP pour piloter votre application dans le simulateur iOS, recueillir des éléments de diagnostic et itérer jusqu’à obtenir un correctif.

Difficulty Avancé
Time horizon 1 h

Utilisez Codex pour identifier le schéma Xcode et le simulateur appropriés, lancer l’application, inspecter l’arborescence de l’interface, toucher des éléments, saisir du texte, effectuer des balayages, prendre des captures d’écran, collecter les journaux, attacher LLDB si nécessaire et transformer un signalement de bug imprécis en un correctif limité et vérifié.

Idéal pour

  • Bugs d’interface qui n’apparaissent qu’après un parcours précis comprenant un appui, un défilement ou une saisie dans un formulaire dans le simulateur
  • Plantages, blocages ou navigation défaillante pour lesquels Codex a besoin des journaux, de captures d’écran, de l’état de la hiérarchie des vues et d’une trace de pile du débogueur avant de modifier le code
  • Équipes qui souhaitent confier à Codex toute la boucle de reproduction, correction et vérification, plutôt que de demander à une personne de parcourir manuellement chaque état de l’interface

Contents

    ← Tous les cas d’utilisation

    Débogage dans le simulateur iOS

    Utilisez Codex et XcodeBuildMCP pour piloter votre application dans le simulateur iOS, recueillir des éléments de diagnostic et itérer jusqu’à obtenir un correctif.

    Utilisez Codex pour identifier le schéma Xcode et le simulateur appropriés, lancer l’application, inspecter l’arborescence de l’interface, toucher des éléments, saisir du texte, effectuer des balayages, prendre des captures d’écran, collecter les journaux, attacher LLDB si nécessaire et transformer un signalement de bug imprécis en un correctif limité et vérifié.

    Avancé
    1 h

    Utilisez Codex pour identifier le schéma Xcode et le simulateur appropriés, lancer l’application, inspecter l’arborescence de l’interface, toucher des éléments, saisir du texte, effectuer des balayages, prendre des captures d’écran, collecter les journaux, attacher LLDB si nécessaire et transformer un signalement de bug imprécis en un correctif limité et vérifié.

    Avancé
    1 h

    Idéal pour

    • Bugs d’interface qui n’apparaissent qu’après un parcours précis comprenant un appui, un défilement ou une saisie dans un formulaire dans le simulateur
    • Plantages, blocages ou navigation défaillante pour lesquels Codex a besoin des journaux, de captures d’écran, de l’état de la hiérarchie des vues et d’une trace de pile du débogueur avant de modifier le code
    • Équipes qui souhaitent confier à Codex toute la boucle de reproduction, correction et vérification, plutôt que de demander à une personne de parcourir manuellement chaque état de l’interface

    Skills et plugins

    • Utilisez l’agent de débogage iOS pour compiler, lancer, inspecter et piloter une application dans un simulateur avec XcodeBuildMCP, puis recueillir des journaux, des captures d’écran et des traces de pile pendant que Codex isole le bug.
    Skill Why use it
    Build iOS Apps Utilisez l’agent de débogage iOS pour compiler, lancer, inspecter et piloter une application dans un simulateur avec XcodeBuildMCP, puis recueillir des journaux, des captures d’écran et des traces de pile pendant que Codex isole le bug.

    Prompt de démarrage

    Utilisez le plugin Build iOS Apps et XcodeBuildMCP pour reproduire ce bug directement dans le simulateur, en diagnostiquer la cause racine et mettre en œuvre un correctif limité. Signalement du bug : [Describe the expected behavior, the actual bug, and any known screen or account setup.] Contraintes : - Vérifiez d’abord si un projet, un schéma et un simulateur sont déjà sélectionnés. Sinon, identifiez le projet ou l’espace de travail Xcode approprié, choisissez le schéma de l’application et un simulateur, puis réutilisez cette configuration pendant le reste de la session. - Compilez et lancez l’application dans le simulateur, puis vérifiez que le bon écran est affiché à l’aide d’un instantané de l’interface ou d’une capture d’écran avant de commencer à interagir avec elle. - Reproduisez vous-même le parcours exact en touchant les éléments, en saisissant du texte, en faisant défiler l’écran et en effectuant des balayages dans le simulateur. Privilégiez les libellés ou identifiants d’accessibilité aux coordonnées brutes et relisez la hiérarchie de l’interface avant l’action suivante lorsque la disposition change. - Recueillez des éléments de diagnostic pendant le débogage : des captures d’écran pour l’état visuel, les journaux du simulateur au moment de l’échec et les frames de pile ou les variables dans LLDB si le bug semble provoquer un plantage ou un blocage. - Si le simulateur n’est pas déjà démarré, démarrez-en un et dites-moi quel appareil et quel système d’exploitation vous avez choisis. Si des identifiants ou une fixture particulière sont nécessaires, arrêtez-vous et demandez-moi uniquement l’information manquante. - Effectuez la plus petite modification de code permettant de corriger le bug, puis relancez le parcours dans le simulateur et indiquez-moi précisément comment vous avez vérifié le correctif. Fournissez : - les étapes de reproduction exécutées par Codex - les principales captures d’écran, les principaux journaux ou les détails de la pile qui ont permis d’expliquer le bug - le correctif du code et la raison pour laquelle il fonctionne - le simulateur et le schéma utilisés pour la vérification finale
    Utilisez le plugin Build iOS Apps et XcodeBuildMCP pour reproduire ce bug directement dans le simulateur, en diagnostiquer la cause racine et mettre en œuvre un correctif limité. Signalement du bug : [Describe the expected behavior, the actual bug, and any known screen or account setup.] Contraintes : - Vérifiez d’abord si un projet, un schéma et un simulateur sont déjà sélectionnés. Sinon, identifiez le projet ou l’espace de travail Xcode approprié, choisissez le schéma de l’application et un simulateur, puis réutilisez cette configuration pendant le reste de la session. - Compilez et lancez l’application dans le simulateur, puis vérifiez que le bon écran est affiché à l’aide d’un instantané de l’interface ou d’une capture d’écran avant de commencer à interagir avec elle. - Reproduisez vous-même le parcours exact en touchant les éléments, en saisissant du texte, en faisant défiler l’écran et en effectuant des balayages dans le simulateur. Privilégiez les libellés ou identifiants d’accessibilité aux coordonnées brutes et relisez la hiérarchie de l’interface avant l’action suivante lorsque la disposition change. - Recueillez des éléments de diagnostic pendant le débogage : des captures d’écran pour l’état visuel, les journaux du simulateur au moment de l’échec et les frames de pile ou les variables dans LLDB si le bug semble provoquer un plantage ou un blocage. - Si le simulateur n’est pas déjà démarré, démarrez-en un et dites-moi quel appareil et quel système d’exploitation vous avez choisis. Si des identifiants ou une fixture particulière sont nécessaires, arrêtez-vous et demandez-moi uniquement l’information manquante. - Effectuez la plus petite modification de code permettant de corriger le bug, puis relancez le parcours dans le simulateur et indiquez-moi précisément comment vous avez vérifié le correctif. Fournissez : - les étapes de reproduction exécutées par Codex - les principales captures d’écran, les principaux journaux ou les détails de la pile qui ont permis d’expliquer le bug - le correctif du code et la raison pour laquelle il fonctionne - le simulateur et le schéma utilisés pour la vérification finale

    Confiez à Codex l’ensemble du cycle dans le simulateur

    Ce cas d’usage est particulièrement efficace lorsque Codex prend en charge l’ensemble du cycle : choisir la bonne cible de l’application, lancer celle-ci dans le simulateur, inspecter l’écran actuel, exécuter les étapes de reproduction, recueillir les journaux et les captures d’écran, examiner une trace de pile si nécessaire, appliquer un correctif au code, puis reproduire le même parcours afin de vérifier que le bug a disparu.

    Utilisez le plugin Build iOS Apps lorsque vous souhaitez que ce cycle reste agentique. Son flux de travail de débogage iOS repose sur XcodeBuildMCP, ce qui permet à Codex d’interagir avec un simulateur déjà démarré et de recueillir les mêmes éléments qu’une personne collecterait normalement à la main.

    Lorsque XcodeBuildMCP est configuré avec des flux de travail pour l’automatisation du simulateur et de l’interface, le débogage et la journalisation, Codex peut prendre en charge tout le cycle de reproduction, débogage et vérification. Si Codex n’a pas encore choisi de projet, de schéma et de simulateur, demandez-lui de déterminer d’abord ces trois éléments, puis de réutiliser cette configuration pendant le reste de la session.

    Tirez parti des possibilités de XcodeBuildMCP

    Dans la pratique, demandez à Codex d’utiliser les groupes de fonctionnalités suivants :

    • Identification du projet et du simulateur : vérifiez si Codex connaît déjà la cible de l’application et le simulateur à utiliser, identifiez le projet ou l’espace de travail Xcode, recensez les schémas, trouvez ou démarrez un simulateur et conservez cette configuration pour les prochaines étapes de compilation et d’exécution.
    • Contrôle de la compilation et du lancement : compilez la cible active de l’application, installez et lancez la version compilée dans le simulateur, relancez-la en capturant les journaux si nécessaire et déterminez l’identifiant du bundle de l’application si Codex doit inspecter ses journaux d’exécution spécifiques.
    • Inspection de l’interface et interactions : lisez la hiérarchie d’accessibilité affichée à l’écran, prenez des captures d’écran, touchez les éléments de contrôle, saisissez du texte dans les champs, faites défiler les listes et effectuez des balayages depuis le bord ou d’autres gestes dans le simulateur.
    • Journaux et état du débogueur : consultez en continu les journaux du simulateur, attachez LLDB à l’application en cours d’exécution, définissez des points d’arrêt, inspectez les frames de pile et les variables locales, puis exécutez des commandes du débogueur lorsqu’un plantage ou un blocage exige une analyse plus approfondie.

    L’habitude essentielle consiste à demander à Codex d’inspecter l’arborescence des vues avant qu’il ne touche un élément. XcodeBuildMCP expose la hiérarchie d’accessibilité ainsi que les coordonnées, ce qui permet à Codex de privilégier des libellés stables ou des identifiants d’élément plutôt que de deviner des positions brutes à l’écran.

    Transformez un bug imprécis en script reproductible

    Le skill de débogage iOS est particulièrement efficace lorsque votre prompt présente un bug précis et un résultat attendu, puis laisse Codex piloter l’application et recueillir des éléments de diagnostic de manière autonome. Si une authentification, un deep link ou une fixture de test est nécessaire, indiquez-le une seule fois et demandez à Codex de ne s’interrompre que lorsque cet élément manquant bloque sa progression.

    Conseils pratiques

    Demandez des preuves, pas seulement un correctif

    Demandez le simulateur et le schéma exacts, ainsi que les captures d’écran, les extraits de journaux et les détails de la pile que Codex a utilisés pour expliquer le bug. Le patch final sera ainsi beaucoup plus facile à réviser qu’avec une simple affirmation comme « Je pense que cela devrait corriger le problème. »

    Privilégiez les libellés d’accessibilité aux coordonnées

    Si Codex doit toucher un élément à partir de ses coordonnées parce qu’un contrôle ne possède aucun libellé stable ni identifiant d’accessibilité, demandez-lui de le signaler. Cela indique souvent que le correctif du bug devrait également apporter une petite amélioration à la testabilité de l’interface.

    Traitez un seul bug par exécution

    Une boucle de débogage pilotée dans le simulateur est puissante, mais il est plus facile de lui faire confiance lorsque chaque prompt cible un seul mode de défaillance. Demandez à Codex de terminer un cycle de reproduction, correction et vérification avant d’étendre l’analyse aux problèmes connexes.

    Tech stack

    Need

    Automatisation du simulateur

    Default options

    XcodeBuildMCP

    Why it's needed

    L’ensemble d’outils actuel couvre la configuration du simulateur, la compilation et le lancement, les instantanés de l’interface, les appuis, la saisie, les gestes, les captures d’écran, la collecte des journaux et l’attachement du débogueur.

    Need

    Flux de travail de l’agent

    Default options

    Plugin Build iOS Apps

    Why it's needed

    L’agent de débogage iOS du plugin fournit à Codex une boucle claire centrée sur le simulateur pour reproduire un bug, recueillir des éléments de diagnostic et valider le correctif après chaque modification.

    Need

    Observabilité de l’application

    Default options

    Logger, OSLog, LLDB et captures d’écran du simulateur

    Why it's needed

    Codex peut utiliser les journaux et l’état du débogueur pour expliquer l’origine du problème, puis enregistrer des captures d’écran afin d’attester l’état exact de l’interface avant et après le correctif.

    Need Default options Why it's needed
    Automatisation du simulateur XcodeBuildMCP L’ensemble d’outils actuel couvre la configuration du simulateur, la compilation et le lancement, les instantanés de l’interface, les appuis, la saisie, les gestes, les captures d’écran, la collecte des journaux et l’attachement du débogueur.
    Flux de travail de l’agent Plugin Build iOS Apps L’agent de débogage iOS du plugin fournit à Codex une boucle claire centrée sur le simulateur pour reproduire un bug, recueillir des éléments de diagnostic et valider le correctif après chaque modification.
    Observabilité de l’application Logger , OSLog , LLDB et captures d’écran du simulateur Codex peut utiliser les journaux et l’état du débogueur pour expliquer l’origine du problème, puis enregistrer des captures d’écran afin d’attester l’état exact de l’interface avant et après le correctif.

    Cas d’utilisation associés