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

Vorschläge
API Dashboard
ChatGPT ausprobieren
Codex

Codex use case

Debuggen im iOS-Simulator

Nutze Codex und XcodeBuildMCP, um deine App im iOS-Simulator zu steuern, Belege zu erfassen und schrittweise eine Korrektur zu erarbeiten.

Difficulty Fortgeschritten
Time horizon 1 h

Nutze Codex, um das richtige Xcode-Schema und den passenden Simulator zu ermitteln, die App zu starten, den UI-Baum zu prüfen, zu tippen, Text einzugeben und zu wischen, Screenshots und Protokolle zu erfassen, LLDB bei Bedarf an den App-Prozess anzuhängen und aus einer unklaren Fehlerbeschreibung eine kleine, verifizierte Korrektur zu entwickeln.

Am besten geeignet für

  • UI-Fehler, die im Simulator erst nach einem bestimmten Ablauf mit Tippen, Scrollen oder Formulareingaben auftreten
  • Abstürze, Hänger oder fehlerhafte Navigation, bei denen Codex vor einer Codeänderung Protokolle, Screenshots, den Zustand der View-Hierarchie und einen Debugger-Backtrace benötigt
  • Teams, die möchten, dass Codex den Zyklus aus Reproduktion, Fehlerbehebung und Verifizierung vollständig übernimmt, statt dass jemand jeden UI-Zustand manuell durchklicken muss

Contents

    ← Alle Anwendungsfälle

    Debuggen im iOS-Simulator

    Nutze Codex und XcodeBuildMCP, um deine App im iOS-Simulator zu steuern, Belege zu erfassen und schrittweise eine Korrektur zu erarbeiten.

    Nutze Codex, um das richtige Xcode-Schema und den passenden Simulator zu ermitteln, die App zu starten, den UI-Baum zu prüfen, zu tippen, Text einzugeben und zu wischen, Screenshots und Protokolle zu erfassen, LLDB bei Bedarf an den App-Prozess anzuhängen und aus einer unklaren Fehlerbeschreibung eine kleine, verifizierte Korrektur zu entwickeln.

    Fortgeschritten
    1 h

    Nutze Codex, um das richtige Xcode-Schema und den passenden Simulator zu ermitteln, die App zu starten, den UI-Baum zu prüfen, zu tippen, Text einzugeben und zu wischen, Screenshots und Protokolle zu erfassen, LLDB bei Bedarf an den App-Prozess anzuhängen und aus einer unklaren Fehlerbeschreibung eine kleine, verifizierte Korrektur zu entwickeln.

    Fortgeschritten
    1 h

    Weiterführende Links

    Build iOS Apps-Plug-in Model Context Protocol Agenten-Skills

    Am besten geeignet für

    • UI-Fehler, die im Simulator erst nach einem bestimmten Ablauf mit Tippen, Scrollen oder Formulareingaben auftreten
    • Abstürze, Hänger oder fehlerhafte Navigation, bei denen Codex vor einer Codeänderung Protokolle, Screenshots, den Zustand der View-Hierarchie und einen Debugger-Backtrace benötigt
    • Teams, die möchten, dass Codex den Zyklus aus Reproduktion, Fehlerbehebung und Verifizierung vollständig übernimmt, statt dass jemand jeden UI-Zustand manuell durchklicken muss

    Skills und Plug-ins

    • Build iOS Apps
      Nutze den iOS-Debugger-Agenten, um mit XcodeBuildMCP eine App zu bauen, im Simulator zu starten, zu prüfen und zu steuern. Erfasse dann Protokolle, Screenshots und Stacktraces, während Codex den Fehler eingrenzt.
    Skill Why use it
    Build iOS Apps Nutze den iOS-Debugger-Agenten, um mit XcodeBuildMCP eine App zu bauen, im Simulator zu starten, zu prüfen und zu steuern. Erfasse dann Protokolle, Screenshots und Stacktraces, während Codex den Fehler eingrenzt.

    Einstiegs-Prompt

    Verwende das Plug-in Build iOS Apps und XcodeBuildMCP, um diesen Fehler direkt im Simulator zu reproduzieren, die Ursache zu diagnostizieren und eine kleine Korrektur zu implementieren. Fehlerbericht: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Vorgaben: - Prüfe zuerst, ob bereits ein Projekt, ein Schema und ein Simulator ausgewählt sind. Falls nicht, ermittle in Xcode das richtige Projekt oder den richtigen Workspace, wähle das App-Schema und einen Simulator aus und verwende dieses Setup für den Rest der Sitzung weiter. - Erstelle einen Build der App und starte sie im Simulator. Vergewissere dich dann anhand eines UI-Snapshots oder Screenshots, dass der richtige Bildschirm angezeigt wird, bevor du mit der App interagierst. - Führe den genauen Reproduktionsablauf selbst aus: Tippe und wische im Simulator, gib Text ein und scrolle. Bevorzuge Accessibility-Labels oder -IDs gegenüber reinen Koordinaten und prüfe die UI-Hierarchie vor der nächsten Aktion erneut, wenn sich das Layout ändert. - Sammle während der Fehlersuche Belege: Screenshots, die den visuellen Zustand zeigen, Simulator-Protokolle rund um den Fehler sowie LLDB-Stackframes oder -Variablen, wenn es sich offenbar um einen Absturz oder Hänger handelt. - Falls der Simulator noch nicht gestartet ist, starte einen und teile mir mit, welches Gerät und Betriebssystem du ausgewählt hast. Falls Zugangsdaten oder eine spezielle Test-Fixture erforderlich sind, halte an und frage nur nach dieser fehlenden Angabe. - Nimm die kleinstmögliche Codeänderung vor, die den Fehler behebt. Führe anschließend den Simulator-Ablauf erneut aus und teile mir genau mit, wie du die Korrektur verifiziert hast. Liefere: - die Reproduktionsschritte, die Codex ausgeführt hat - die entscheidenden Screenshots, Protokolle oder Stackdetails, die zur Erklärung des Fehlers geführt haben - die Codekorrektur und eine Erklärung, warum sie funktioniert - den für die abschließende Verifizierung verwendeten Simulator und das verwendete Schema
    Verwende das Plug-in Build iOS Apps und XcodeBuildMCP, um diesen Fehler direkt im Simulator zu reproduzieren, die Ursache zu diagnostizieren und eine kleine Korrektur zu implementieren. Fehlerbericht: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Vorgaben: - Prüfe zuerst, ob bereits ein Projekt, ein Schema und ein Simulator ausgewählt sind. Falls nicht, ermittle in Xcode das richtige Projekt oder den richtigen Workspace, wähle das App-Schema und einen Simulator aus und verwende dieses Setup für den Rest der Sitzung weiter. - Erstelle einen Build der App und starte sie im Simulator. Vergewissere dich dann anhand eines UI-Snapshots oder Screenshots, dass der richtige Bildschirm angezeigt wird, bevor du mit der App interagierst. - Führe den genauen Reproduktionsablauf selbst aus: Tippe und wische im Simulator, gib Text ein und scrolle. Bevorzuge Accessibility-Labels oder -IDs gegenüber reinen Koordinaten und prüfe die UI-Hierarchie vor der nächsten Aktion erneut, wenn sich das Layout ändert. - Sammle während der Fehlersuche Belege: Screenshots, die den visuellen Zustand zeigen, Simulator-Protokolle rund um den Fehler sowie LLDB-Stackframes oder -Variablen, wenn es sich offenbar um einen Absturz oder Hänger handelt. - Falls der Simulator noch nicht gestartet ist, starte einen und teile mir mit, welches Gerät und Betriebssystem du ausgewählt hast. Falls Zugangsdaten oder eine spezielle Test-Fixture erforderlich sind, halte an und frage nur nach dieser fehlenden Angabe. - Nimm die kleinstmögliche Codeänderung vor, die den Fehler behebt. Führe anschließend den Simulator-Ablauf erneut aus und teile mir genau mit, wie du die Korrektur verifiziert hast. Liefere: - die Reproduktionsschritte, die Codex ausgeführt hat - die entscheidenden Screenshots, Protokolle oder Stackdetails, die zur Erklärung des Fehlers geführt haben - die Codekorrektur und eine Erklärung, warum sie funktioniert - den für die abschließende Verifizierung verwendeten Simulator und das verwendete Schema

    Lass Codex den gesamten Simulator-Ablauf übernehmen

    Dieser Anwendungsfall funktioniert am besten, wenn Codex den gesamten Ablauf übernimmt: das richtige App-Target auswählen, die App im Simulator starten, den aktuellen Bildschirm prüfen, die Reproduktionsschritte ausführen, Protokolle und Screenshots erfassen, bei Bedarf einen Stacktrace untersuchen, den Code korrigieren und denselben Ablauf erneut ausführen, um nachzuweisen, dass der Fehler behoben ist.

    Wenn Codex diesen Ablauf weiterhin autonom ausführen soll, nutze das Build iOS Apps-Plug-in. Der iOS-Debugger-Arbeitsablauf des Plug-ins basiert auf XcodeBuildMCP. Dadurch kann Codex mit einem gestarteten Simulator interagieren und dieselben Belege sammeln, die sonst jemand manuell zusammentragen müsste.

    Wenn XcodeBuildMCP mit Arbeitsabläufen für Simulator- und UI-Automatisierung, Debugging und Protokollierung konfiguriert ist, kann Codex den gesamten Zyklus aus Reproduktion, Fehlersuche und Verifizierung übernehmen. Falls Codex Projekt, Schema und Simulator noch nicht ausgewählt hat, lass Codex sie zuerst ermitteln und dieses Setup für den Rest der Sitzung wiederverwenden.

    Nutze die Möglichkeiten von XcodeBuildMCP

    Fordere Codex auf, die folgenden praktischen Funktionsbereiche zu nutzen:

    • 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 ermitteln, die Schemata auflisten, einen Simulator finden oder starten und dieses Setup für spätere Build- und Ausführungsschritte unverändert beibehalten.
    • Build und Start steuern: einen Build für das aktive App-Target erstellen, den Simulator-Build installieren und starten, die App bei Bedarf mit Protokollerfassung neu starten und ihre Bundle-ID ermitteln, falls Codex app-spezifische Laufzeitprotokolle prüfen muss.
    • UI prüfen und bedienen: die Accessibility-Hierarchie des aktuellen Bildschirms einlesen, Screenshots aufnehmen, Bedienelemente antippen, Text in Felder eingeben, durch Listen scrollen und Wischgesten vom Bildschirmrand oder andere Simulatorgesten ausführen.
    • Protokolle und Debugger-Zustand: Simulator-Protokolle in Echtzeit abrufen, LLDB an den laufenden App-Prozess anhängen, Breakpoints setzen, Stackframes und lokale Variablen prüfen und Debugger-Befehle ausführen, wenn ein Absturz oder Hänger genauer untersucht werden muss.

    Wichtig ist vor allem, dass Codex vor dem Tippen den View-Baum prüft. XcodeBuildMCP stellt die Accessibility-Hierarchie samt Koordinaten bereit. Dadurch kann Codex stabile Labels oder Element-IDs bevorzugen, statt Bildschirmpositionen zu erraten.

    Eine unklare Fehlerbeschreibung in ein reproduzierbares Skript verwandeln

    Der iOS-Debugger-Skill liefert die besten Ergebnisse, wenn du in deinem Prompt einen konkreten Fehler und das erwartete Ergebnis nennst und Codex anschließend die App selbstständig steuern und Belege sammeln lässt. Falls eine Anmeldung, ein Deep Link oder eine Test-Fixture erforderlich ist, weise einmal darauf hin und bitte Codex, nur dann anzuhalten, wenn es ohne die fehlende Angabe nicht weitergehen kann.

    Praxistipps

    Fordere nicht nur eine Korrektur, sondern auch Belege an

    Bitte Codex um Angaben zum genauen Simulator und zum verwendeten Schema sowie um die Screenshots, Protokollauszüge und Stackdetails, anhand derer der Fehler erklärt wurde. So lässt sich der endgültige Patch wesentlich leichter prüfen als mit der bloßen Aussage: „Ich glaube, das sollte den Fehler beheben.“

    Accessibility-Labels statt Koordinaten bevorzugen

    Wenn Codex per Koordinaten tippen muss, weil ein Bedienelement weder ein stabiles Label noch eine Accessibility-ID hat, soll Codex darauf hinweisen. Das ist oft ein Hinweis darauf, dass die Fehlerbehebung auch eine kleine Verbesserung der UI-Testbarkeit umfassen sollte.

    Pro Durchlauf nur einen Fehler bearbeiten

    Ein simulatorgestützter Debugging-Zyklus ist leistungsfähig. Seine Ergebnisse sind jedoch leichter einzuschätzen, wenn ein Prompt auf genau eine Fehlerart ausgerichtet ist. Bitte Codex, erst einen Zyklus aus Reproduktion, Fehlerbehebung und Verifizierung abzuschließen, bevor du den Auftrag auf verwandte Probleme ausweitest.

    Tech stack

    Need

    Simulatorautomatisierung

    Default options

    XcodeBuildMCP

    Why it's needed

    Der aktuelle Funktionsumfang der Tools umfasst das Einrichten des Simulators, das Erstellen eines Builds und Starten der App, UI-Snapshots, Tippen, Texteingaben, Gesten, Screenshots, Protokollerfassung und das Anhängen eines Debuggers.

    Need

    Arbeitsablauf des Agenten

    Default options

    Build iOS Apps-Plug-in

    Why it's needed

    Der iOS-Debugger-Agent des Plug-ins bietet Codex einen klaren, auf den Simulator ausgerichteten Ablauf, mit dem sich Fehler reproduzieren, Belege sammeln und Korrekturen nach jeder Änderung verifizieren lassen.

    Need

    Beobachtbarkeit der App

    Default options

    Logger, OSLog, LLDB und Simulator-Screenshots

    Why it's needed

    Codex kann anhand von Protokollen und Debugger-Zustand erklären, was schiefgegangen ist, und anschließend Screenshots speichern, die den genauen UI-Zustand vor und nach der Korrektur belegen.

    Need Default options Why it's needed
    Simulatorautomatisierung XcodeBuildMCP Der aktuelle Funktionsumfang der Tools umfasst das Einrichten des Simulators, das Erstellen eines Builds und Starten der App, UI-Snapshots, Tippen, Texteingaben, Gesten, Screenshots, Protokollerfassung und das Anhängen eines Debuggers.
    Arbeitsablauf des Agenten Build iOS Apps-Plug-in Der iOS-Debugger-Agent des Plug-ins bietet Codex einen klaren, auf den Simulator ausgerichteten Ablauf, mit dem sich Fehler reproduzieren, Belege sammeln und Korrekturen nach jeder Änderung verifizieren lassen.
    Beobachtbarkeit der App Logger , OSLog , LLDB und Simulator-Screenshots Codex kann anhand von Protokollen und Debugger-Zustand erklären, was schiefgegangen ist, und anschließend Screenshots speichern, die den genauen UI-Zustand vor und nach der Korrektur belegen.

    Verwandte Anwendungsfälle

    App Intents zu einer iOS-App hinzufügen

    Nutze Codex und das Plug-in „Build iOS Apps“, um zu ermitteln, welche Aktionen und Entitäten...

    iOS Code

    Liquid Glass einführen

    Nutze Codex und das Plug-in Build iOS Apps, um bestehende Benutzeroberflächen für iPhone und...

    iOS Code

    Für iOS entwickeln

    Nutze Codex, um iOS-SwiftUI-Projekte aufzusetzen, die Build-Schleife mit `xcodebuild` oder...

    iOS Code