ce-test-xcode

Über ce-test-xcode

Ce-test-xcode baut, installiert und testet iOS-Apps im Simulator unter Verwendung des XcodeBuildMCP-Servers, erfasst Screenshots und Protokolle sowie überprüft das App-Verhalten. Es akzeptiert ein optionales Argument für einen Schemanamen oder „current“, um das Standard- oder zuletzt verwendete Schema zu nutzen. Zu den Voraussetzungen gehören Xcode mit den Command-Line-Tools, ein verbundener XcodeBuildMCP-MCP-Server, ein gültiges Xcode-Projekt oder -Arbeitsbereich sowie mindestens ein verfügbarer iOS-Simulator. Die Modellausführung ist deaktiviert, sodass es als expliziter Befehl ausgeführt wird.

Der Workflow überprüft zunächst, ob XcodeBuildMCP verbunden ist, indem er dessen Tool list_simulators aufruft, und stoppt mit einer Installationsanleitung, falls dies nicht der Fall ist. Anschließend werden Projekte und Schemata entdeckt (discover_projs, list_schemes), ein bevorzugter Simulator wie iPhone 15 Pro per UUID gestartet und die App mit build_ios_sim_app erstellt, wobei im Fehlerfall spezifische Fehler gemeldet werden. Im Erfolgsfall wird die App installiert und gestartet (install_app_on_simulator, launch_app_on_simulator) und die Protokollerfassung beginnt. Für jeden wichtigen Bildschirm wird ein beschreibender Screenshot erstellt, Darstellung und Inhalt überprüft sowie Protokolle auf Abstürze, Ausnahmen, Fehlermeldungen auf Fehlerstufe und fehlgeschlagene Netzwerkanfragen geprüft.

Das Skill dokumentiert eine bekannte Plattformbeschränkung: Simulierte Tippen können keine Gesture Recognizer auf SwiftUI-Textansichten mit inline AttributedString-Links auslösen, daher wird zur manuellen Eingabe eines Tipps aufgefordert oder xcrun simctl openurl als Fallback angeboten. Es pausiert für die menschliche Überprüfung von Abläufen, die eine Geräteinteraktion erfordern, einschließlich „Mit Apple anmelden“, Push-Benachrichtigungen, In-App-Käufe, Kamera und Fotos sowie Standort, wobei das blockierende Frage-Tool der Plattform wie AskUserQuestion genutzt wird. Bei einem Testfehler wird der Fehler mit einem Screenshot und Protokollen dokumentiert und gefragt, ob er jetzt behoben oder übersprungen werden soll. Es schließt mit einer strukturierten Testzusammenfassungstabelle und einem Bereinigungsschritt ab, der die Protokollerfassung stoppt und optional den Simulator herunterfährt. Es integriert sich zudem in den ce-code-review-Workflow, der einen Agenten starten kann, um dieses Skill auf Pull Requests auszuführen, die iOS-Code berühren.

FAQ

Welchen MCP-Server erfordert dieses Skill?

Es erfordert, dass der XcodeBuildMCP-MCP-Server verbunden ist. Der Workflow bestätigt die Verfügbarkeit, indem er dessen Tool list_simulators aufruft, und fährt erst fort, wenn XcodeBuildMCP funktioniert; falls es fehlt, werden Anweisungen zur Installation über Homebrew und npx bereitgestellt.

Wie wähle ich das zu testende Schema aus?

Geben Sie den Schemanamen als Argument an oder übergeben Sie „current“, um das Standard- oder zuletzt verwendete Schema zu nutzen. Das Skill entdeckt Projekte und Schemata mit discover_projs und list_schemes und verwendet das angegebene Argument, falls eines angegeben wurde.

Warum funktionieren Tippen auf SwiftUI-Textlinks im Simulator nicht?

Simulierte Tippen lösen keine Gesture Recognizer auf SwiftUI-Textansichten mit inline AttributedString-Links aus, da diese Links nicht als separate Elemente im Accessibility-Baum verfügbar sind. Das Skill fordert Sie auf, manuell zu tippen, und kann xcrun simctl openurl nutzen, um eine bekannte Ziel-URL direkt als Fallback zu öffnen.

Wann pausiert es für menschliche Eingaben?

Es pausiert bei Abläufen, die eine echte Geräteinteraktion erfordern, wie „Mit Apple anmelden“, Push-Benachrichtigungen, In-App-Käufe, Kamera und Fotos sowie Standort, und fragt dies über das blockierende Frage-Tool der Plattform ab, wobei die Überprüfung niemals stillschweigend übersprungen wird.

Was geschieht nach einem Testfehler?

Es dokumentiert den Fehler mit einem Screenshot des Fehlerzustands, erfassten Konsolenprotokollen und Reproduktionshinweisen und fragt dann, ob der Fehler jetzt behoben werden soll (Debuggen, Vorschlag einer Behebung, Neuerstellung und erneuter Test) oder ob übersprungen und mit dem Testen anderer Bildschirme fortgefahren werden soll.