Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design
Codex

Anwendungsfall für Codex

Apps im iOS-Simulator debuggen

Steuere deine App mit Codex und XcodeBuildMCP im iOS-Simulator, dokumentiere den Fehler und arbeite Schritt für Schritt an einer Lösung.

Schwierigkeitsgrad Advanced
Zeithorizont 1h

Finde mit Codex das passende Xcode-Schema und den passenden Simulator. Starte die App, untersuche die UI-Hierarchie, tippe auf Elemente, gib Text ein und wische über den Bildschirm. Halte den Fehler mit Screenshots und Logs fest und hänge bei Bedarf LLDB an den App-Prozess an. So kommst du von einem vagen Fehlerbericht zu einer kleinen Codeänderung, deren Wirkung du im Simulator überprüfst.

Besonders geeignet für

  • UI-Fehler, die im Simulator erst nach einer bestimmten Abfolge von Tippgesten, Scrollbewegungen oder Formulareingaben auftreten
  • Abstürze, Hänger oder Navigationsfehler, bei denen Codex vor der Codeänderung Logs, Screenshots, den aktuellen Zustand der Ansichtshierarchie und einen Backtrace aus dem Debugger benötigt
  • Teams, die Codex den Fehler reproduzieren und beheben sowie die Korrektur überprüfen lassen möchten, damit niemand jeden App-Zustand von Hand aufrufen muss

Inhalt

    ← Alle Anwendungsfälle

    Apps im iOS-Simulator debuggen

    Steuere deine App mit Codex und XcodeBuildMCP im iOS-Simulator, dokumentiere den Fehler und arbeite Schritt für Schritt an einer Lösung.

    Finde mit Codex das passende Xcode-Schema und den passenden Simulator. Starte die App, untersuche die UI-Hierarchie, tippe auf Elemente, gib Text ein und wische über den Bildschirm. Halte den Fehler mit Screenshots und Logs fest und hänge bei Bedarf LLDB an den App-Prozess an. So kommst du von einem vagen Fehlerbericht zu einer kleinen Codeänderung, deren Wirkung du im Simulator überprüfst.

    Advanced
    1h

    Finde mit Codex das passende Xcode-Schema und den passenden Simulator. Starte die App, untersuche die UI-Hierarchie, tippe auf Elemente, gib Text ein und wische über den Bildschirm. Halte den Fehler mit Screenshots und Logs fest und hänge bei Bedarf LLDB an den App-Prozess an. So kommst du von einem vagen Fehlerbericht zu einer kleinen Codeänderung, deren Wirkung du im Simulator überprüfst.

    Advanced
    1h

    Besonders geeignet für

    • UI-Fehler, die im Simulator erst nach einer bestimmten Abfolge von Tippgesten, Scrollbewegungen oder Formulareingaben auftreten
    • Abstürze, Hänger oder Navigationsfehler, bei denen Codex vor der Codeänderung Logs, Screenshots, den aktuellen Zustand der Ansichtshierarchie und einen Backtrace aus dem Debugger benötigt
    • Teams, die Codex den Fehler reproduzieren und beheben sowie die Korrektur überprüfen lassen möchten, damit niemand jeden App-Zustand von Hand aufrufen muss

    Skills und Plug-ins

    • Mit dem iOS-Debugger-Agenten und XcodeBuildMCP kannst du eine App kompilieren und sie im Simulator starten, untersuchen und bedienen. Erfasse anschließend Logs, Screenshots und Stacktraces, während Codex die Fehlerursache eingrenzt.
    Skill Nutzen
    Build iOS Apps Mit dem iOS-Debugger-Agenten und XcodeBuildMCP kannst du eine App kompilieren und sie im Simulator starten, untersuchen und bedienen. Erfasse anschließend Logs, Screenshots und Stacktraces, während Codex die Fehlerursache eingrenzt.

    Prompt für den Einstieg

    Nutze das Plugin „Build iOS Apps“ und XcodeBuildMCP, um diesen Fehler direkt im Simulator zu reproduzieren. Ermittle die Ursache und behebe den Fehler mit einer kleinen Codeänderung. Fehlerbericht: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Vorgaben: - Prüfe zuerst, ob Projekt, Schema und Simulator bereits ausgewählt sind. Falls die Auswahl unvollständig ist, ermittle das passende Xcode-Projekt oder den passenden Workspace. Wähle das Schema der App und einen Simulator aus. Verwende diese Konfiguration für den Rest der Sitzung. - Kompiliere die App und starte sie im Simulator. Prüfe anhand eines UI-Snapshots oder Screenshots, ob der richtige Bildschirm zu sehen ist, bevor du die App bedienst. - Führe die Schritte zum Reproduzieren des Fehlers selbst exakt aus: Tippe im Simulator auf Elemente, gib Text ein, scrolle und wische. Verwende bevorzugt Accessibility-Labels oder IDs statt Bildschirmkoordinaten. Wenn sich das Layout ändert, lies die UI-Hierarchie vor der nächsten Aktion erneut aus. - Dokumentiere den Fehler beim Debuggen. Halte den sichtbaren Zustand der App mit Screenshots fest und sichere die Simulator-Logs für den Zeitraum rund um den Fehler. Wenn die App offenbar abstürzt oder hängt, erfasse mit LLDB auch Stackframes oder Variablenwerte. - Wenn noch kein Simulator läuft, starte einen und nenne mir das gewählte Gerät und Betriebssystem. Falls du Zugangsdaten oder eine spezielle Test-Fixture brauchst, halte an und frage nur nach dem, was dir fehlt. - Behebe den Fehler mit der kleinstmöglichen Codeänderung. Wiederhole anschließend dieselben Schritte im Simulator und erkläre mir genau, wie du die Korrektur überprüft hast. Liefere zum Abschluss: - die Schritte, die Codex ausgeführt hat, um den Fehler zu reproduzieren - die Screenshots, Logeinträge oder Details aus dem Aufrufstapel, die für die Erklärung des Fehlers entscheidend waren - die Codeänderung und den Grund, warum sie den Fehler behebt - den Simulator und das Schema, die du für die abschließende Prüfung verwendet hast
    Nutze das Plugin „Build iOS Apps“ und XcodeBuildMCP, um diesen Fehler direkt im Simulator zu reproduzieren. Ermittle die Ursache und behebe den Fehler mit einer kleinen Codeänderung. Fehlerbericht: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Vorgaben: - Prüfe zuerst, ob Projekt, Schema und Simulator bereits ausgewählt sind. Falls die Auswahl unvollständig ist, ermittle das passende Xcode-Projekt oder den passenden Workspace. Wähle das Schema der App und einen Simulator aus. Verwende diese Konfiguration für den Rest der Sitzung. - Kompiliere die App und starte sie im Simulator. Prüfe anhand eines UI-Snapshots oder Screenshots, ob der richtige Bildschirm zu sehen ist, bevor du die App bedienst. - Führe die Schritte zum Reproduzieren des Fehlers selbst exakt aus: Tippe im Simulator auf Elemente, gib Text ein, scrolle und wische. Verwende bevorzugt Accessibility-Labels oder IDs statt Bildschirmkoordinaten. Wenn sich das Layout ändert, lies die UI-Hierarchie vor der nächsten Aktion erneut aus. - Dokumentiere den Fehler beim Debuggen. Halte den sichtbaren Zustand der App mit Screenshots fest und sichere die Simulator-Logs für den Zeitraum rund um den Fehler. Wenn die App offenbar abstürzt oder hängt, erfasse mit LLDB auch Stackframes oder Variablenwerte. - Wenn noch kein Simulator läuft, starte einen und nenne mir das gewählte Gerät und Betriebssystem. Falls du Zugangsdaten oder eine spezielle Test-Fixture brauchst, halte an und frage nur nach dem, was dir fehlt. - Behebe den Fehler mit der kleinstmöglichen Codeänderung. Wiederhole anschließend dieselben Schritte im Simulator und erkläre mir genau, wie du die Korrektur überprüft hast. Liefere zum Abschluss: - die Schritte, die Codex ausgeführt hat, um den Fehler zu reproduzieren - die Screenshots, Logeinträge oder Details aus dem Aufrufstapel, die für die Erklärung des Fehlers entscheidend waren - die Codeänderung und den Grund, warum sie den Fehler behebt - den Simulator und das Schema, die du für die abschließende Prüfung verwendet hast

    Überlass Codex den gesamten Ablauf im Simulator

    Die Fehlersuche funktioniert am besten, wenn Codex den gesamten Ablauf übernimmt. Codex wählt das passende App-Target, startet die App im Simulator, prüft die aktuelle Ansicht und führt die Schritte aus, mit denen sich der Fehler reproduzieren lässt. Anschließend sammelt Codex Logs und Screenshots, untersucht bei Bedarf einen Stacktrace und korrigiert den Code. Zum Schluss wiederholt Codex dieselben Schritte, um zu zeigen, dass der Fehler behoben ist.

    Verwende das Plugin „Build iOS Apps“, wenn Codex diesen Ablauf selbstständig steuern soll. Der Debugging-Workflow für iOS nutzt XcodeBuildMCP. Damit kann Codex einen laufenden Simulator bedienen und dieselben Informationen sammeln, die du sonst von Hand zusammentragen würdest.

    Wenn in XcodeBuildMCP die Workflows für Simulator- und UI-Automatisierung, Debugging und Logging eingerichtet sind, kann Codex den Fehler selbstständig reproduzieren, untersuchen und die Korrektur überprüfen. Falls die Auswahl von Projekt, Scheme und Simulator noch aussteht, lass Codex zuerst die verfügbaren Optionen ermitteln und eine Auswahl treffen. Dieses Setup soll Codex für den Rest der Sitzung beibehalten.

    Nutze die Funktionen von XcodeBuildMCP

    Mit deinem Prompt kannst du Codex gezielt um folgende Schritte bitten:

    • Projekt und Simulator ermitteln: Prüfen, ob Codex bereits weiß, welches App-Target und welchen Simulator es verwenden soll. Das Xcode-Projekt oder den Workspace suchen, die verfügbaren Schemes auflisten, einen Simulator finden oder starten und dieses Setup für spätere Builds und App-Starts beibehalten.
    • App kompilieren und starten: Das aktive App-Target kompilieren, den Simulator-Build installieren und starten. Die App bei Bedarf neu starten und dabei Logs aufzeichnen. Falls Codex die Laufzeitlogs der App untersuchen muss, die Bundle-ID der App ermitteln.
    • Benutzeroberfläche untersuchen und bedienen: Die Hierarchie der Bedienungshilfenelemente für die aktuelle Ansicht auslesen, Screenshots aufnehmen, Bedienelemente antippen, Text in Felder eingeben, durch Listen scrollen, vom Bildschirmrand aus wischen oder andere Gesten im Simulator ausführen.
    • Logs und Debugger-Zustand untersuchen: Simulator-Logs live verfolgen, LLDB mit der laufenden App verbinden, Haltepunkte setzen sowie Stackframes und lokale Variablen untersuchen. Wenn die App abstürzt oder hängt und eine genauere Untersuchung nötig ist, Debugger-Befehle ausführen.

    Bitte Codex grundsätzlich, die Ansichtshierarchie zu prüfen, bevor es ein Element antippt. XcodeBuildMCP liefert sowohl die Hierarchie der Bedienungshilfenelemente als auch deren Koordinaten. So kann Codex bevorzugt stabile Beschriftungen oder Element-IDs verwenden, statt Bildschirmpositionen zu erraten.

    Mach aus einer vagen Fehlerbeschreibung einen reproduzierbaren Ablauf

    Der Skill für das iOS-Debugging ist am effektivsten, wenn du in deinem Prompt einen konkreten Fehler und das erwartete Ergebnis beschreibst. Lass Codex anschließend die App selbstständig bedienen und Belege sammeln. Falls eine Anmeldung, ein Deep Link oder eine Test-Fixture erforderlich ist, erwähne das einmal im Prompt. Bitte Codex, erst dann zu pausieren, wenn es ohne diese Voraussetzung nicht weiterkommt.

    Praktische Tipps

    Lass dir die Korrektur belegen

    Lass dir genau nennen, welchen Simulator und welches Scheme Codex verwendet hat. Bitte auch um die Screenshots, Logauszüge und Details zum Aufrufstapel, auf die Codex seine Fehlererklärung stützt. Damit kannst du den Patch leichter prüfen als mit einer Einschätzung wie „Ich glaube, damit sollte der Fehler behoben sein.“

    Bevorzuge Beschriftungen für Bedienungshilfen gegenüber Koordinaten

    Bitte Codex, ausdrücklich darauf hinzuweisen, wenn es ein Bedienelement anhand von Koordinaten antippen muss, weil weder eine stabile Beschriftung noch eine Kennung für Bedienungshilfen vorhanden ist. Das ist oft ein Hinweis darauf, dass du im Zuge der Fehlerkorrektur mit einer kleinen Änderung auch die Benutzeroberfläche leichter testbar machen solltest.

    Untersuche pro Durchlauf einen Fehler

    Die Fehlersuche im Simulator bietet viele Möglichkeiten. Die Ergebnisse lassen sich aber leichter nachvollziehen, wenn sich jeder Prompt auf ein bestimmtes Fehlerbild konzentriert. Bitte Codex, zuerst einen Fehler zu reproduzieren, ihn zu beheben und die Korrektur zu überprüfen. Danach kannst du die Untersuchung auf verwandte Probleme ausweiten.

    Tech-Stack

    Was du brauchst

    Simulator automatisieren

    Standardoptionen

    XcodeBuildMCP

    Warum du es brauchst

    Mit den verfügbaren Werkzeugen kannst du den Simulator einrichten, die App kompilieren und starten und UI-Snapshots erstellen. Du kannst auf Elemente tippen, Text eingeben, weitere Gesten ausführen, Screenshots und Logs erfassen und einen Debugger an den App-Prozess anhängen.

    Was du brauchst

    Arbeitsablauf für den Agenten

    Warum du es brauchst

    Der iOS-Debugger-Agent des Plugins gibt Codex einen klaren Ablauf vor. Codex reproduziert den Fehler zunächst im Simulator, dokumentiert ihn und prüft nach jeder Änderung, ob sie den Fehler behebt.

    Was du brauchst

    App-Verhalten beobachten

    Standardoptionen

    Logger, OSLog, LLDB und Screenshots aus dem Simulator

    Warum du es brauchst

    Anhand der Logs und des im Debugger sichtbaren Programmzustands kann Codex erklären, was schiefgelaufen ist. Anschließend kann Codex Screenshots speichern, die genau zeigen, wie die Oberfläche vor und nach der Korrektur aussah.

    Was du brauchst Standardoptionen Warum du es brauchst
    Simulator automatisieren XcodeBuildMCP Mit den verfügbaren Werkzeugen kannst du den Simulator einrichten, die App kompilieren und starten und UI-Snapshots erstellen. Du kannst auf Elemente tippen, Text eingeben, weitere Gesten ausführen, Screenshots und Logs erfassen und einen Debugger an den App-Prozess anhängen.
    Arbeitsablauf für den Agenten Plugin „Build iOS Apps“ Der iOS-Debugger-Agent des Plugins gibt Codex einen klaren Ablauf vor. Codex reproduziert den Fehler zunächst im Simulator, dokumentiert ihn und prüft nach jeder Änderung, ob sie den Fehler behebt.
    App-Verhalten beobachten Logger , OSLog , LLDB und Screenshots aus dem Simulator Anhand der Logs und des im Debugger sichtbaren Programmzustands kann Codex erklären, was schiefgelaufen ist. Anschließend kann Codex Screenshots speichern, die genau zeigen, wie die Oberfläche vor und nach der Korrektur aussah.

    Verwandte Anwendungsfälle