Ü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.