Was macht ios-debugger-agent?
Verwenden Sie XcodeBuildMCP, um das aktuelle iOS-Projekt auf einem gestarteten Simulator zu bauen, auszuführen, zu starten und zu debuggen. Wird ausgelöst, wenn eine iOS-App ausgeführt, die Simulator-Benutzeroberfläche bedient, der Bildschirmstatus untersucht, Protokolle/Konsolenausgabe erfasst oder das Laufzeitverhalten mit XcodeBuildMCP-Tools diagnostiziert werden soll.
Beschreibung
Dieser Skill ermöglicht es einem KI-Agenten, den vollständigen Entwicklungszyklus einer iOS-App im Simulator zu automatisieren: Bauen, Installieren, Starten und Debuggen – ohne manuelle Eingriffe in Xcode. Der Agent kann den Simulator steuern (Tippen, Wischen, Texteingabe), visuelle Zustände über Screenshots auswerten und Laufzeitlogs sowie Fehlermeldungen erfassen.
Hauptfunktionen
- Automatischer Build und Start – Projekt mit
xcodebuildbauen, installieren und im Simulator starten. - Simulator-Steuerung – Tippen, Wischen, Tastatureingaben und andere UI-Interaktionen ausführen.
- Bildschirm-Inspektion – Screenshots des Simulators erfassen und den UI-Zustand analysieren.
- Log-Erfassung – Konsolenlogs (
os_log,NSLog), Absturzberichte und Build-Fehler auslesen. - Fehlerdiagnose – Laufzeitfehler identifizieren und auf Basis von Logs und Screenshots beheben.
Verwendung
- Simulator starten – Der Agent startet bei Bedarf einen Simulator (z. B. iPhone 15 Pro).
- Build ausführen –
xcodebuildbaut das Projekt und installiert die App im Simulator. - App starten – Die App wird im Simulator geöffnet.
- UI bedienen – Der Agent führt gewünschte Aktionen aus (Navigation, Eingaben, Gesten).
- Auswertung – Screenshots und Logs werden analysiert, um Ergebnisse oder Fehler zu melden.
Voraussetzungen
- Xcode Command Line Tools installiert.
- XcodeBuildMCP konfiguriert und verfügbar.
- Ein iOS-Simulator (z. B. „iPhone 15 Pro“) als Zielplattform.
- Das iOS-Projekt muss über ein gültiges
.xcodeprojoder.xcworkspaceund Build-Konfiguration verfügen.
Beispiel-Interaktion
Benutzer: „Starte die App und tippe auf den Login-Button.“
Agent:
- Baut das Projekt (
xcodebuild -project ... -scheme ... -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build). - Installiert die App im Simulator (
xcrun simctl install booted ...). - Startet die App (
xcrun simctl launch booted ...). - Macht einen Screenshot und analysiert die Position des Login-Buttons.
- Tippt auf die entsprechende Koordinate (
xcrun simctl ...). - Macht einen weiteren Screenshot zur Bestätigung und gibt die Logs aus.
Plattformen
- Ziel: iOS Simulator (via Xcode Build System)
- Werkzeug: XcodeBuildMCP (als MCP-Server)
- Agent: Claude Code, Cursor, Codex oder andere MCP-kompatible KI-Agenten