screenshot-ios

name	screenshot-ios
description	Fernsteuert den iOS-Simulator (App tippen, wischen, tippen-mit-Text, Hardware-Tasten) und nimmt Verifikations-Screenshots auf. Aktiviere bei "Mach Screenshot...", "Tippe auf...", "Verifiziere die View visuell...", "Wische zum...", oder /screenshot-ios. NICHT fuer Fastlane/Marketing-Screenshots — dafuer /create-ui-test.

Skill: iOS Simulator fernsteuern und Screenshots aufnehmen

Wrapper um axe + xcrun simctl + sips fuer den haeufigsten Loop: UI-Hierarchie lesen → Koordinate antippen → Screenshot verifizieren.

Die Schritte sind als Shell-Scripts in scripts/screenshot-ios/ versioniert. Nicht jedes Mal neue Wege probieren — diese Scripts sind der Weg.

Voraussetzungen

• iOS Simulator gebootet. Falls nicht: XcodeBuildMCP boot_sim aufrufen, oder xcrun simctl boot <UDID>.
• axe installiert (brew install axe).

Simulator-Auswahl

Alle Scripts akzeptieren --udid <UDID> als erstes Arg-Paar. Resolution-Order (hoechste Prioritaet zuerst):

1. --udid <UDID> Flag (explizit, pro Aufruf)
2. SM_IOS_UDID env var (Session-Default fuer Menschen)
3. Auto-Detect: einziger gebooteter Simulator
4. Mehrere gebootet: erster + Warnung auf stderr

Booted-Simulatoren mit Namen auflisten:

xcrun simctl list devices booted | grep -E "^\s+\S"
# Beispiel:
#   iPhone 16 Plus (54B045BE-A7D9-4083-93C2-03DF719754DE) (Booted)
#   iPhone 16 Pro  (91211B93-0475-4FED-8C71-09D140199C36) (Booted)

Empfehlung fuer Claude Code: Bei mehreren Booted-Simulatoren immer --udid nutzen. Kein export SM_IOS_UDID=... && script Compound-Chain — das triggert unnoetig eine Permission-Abfrage.

scripts/screenshot-ios/dump_ui.sh --udid 54B045BE-A7D9-4083-93C2-03DF719754DE ui-lib.json
scripts/screenshot-ios/tap.sh    --udid 54B045BE-A7D9-4083-93C2-03DF719754DE 201 582

Scripts

Alle Scripts liegen unter scripts/screenshot-ios/ und sind ausfuehrbar. Alle setzen sinnvolle Defaults (--post-delay 1, --duration 0.5 --delta 5) hartcodiert ein — diese Werte sind durch Schmerzen erkauft, nicht anfassen.

[--udid <UDID>] ist bei jedem Konsumer-Script optional, kommt immer zuerst und wird in der Tabelle weggelassen.

Script	Zweck	Output
udid.sh	Liefert UDID des gebooteten Simulators (akzeptiert --udid als Pass-Through)	stdout
dump_ui.sh [name]	Accessibility-Hierarchie nach tmp/<name> (default ui.json)	Pfad auf stdout
shot.sh [name]	Screenshot nach tmp/<name>, auf 1800px resized (default ios.png)	Pfad auf stdout
tap.sh <x> <y>	Tippt an Koordinate	—
tap_by_id.sh <AXUniqueId>	Dumpt UI, sucht Element, tippt Mittelpunkt	—
tap_by_label.sh <AXLabel>	Wie tap_by_id.sh, aber via lokalisiertes Label	—
swipe.sh <sx> <sy> <ex> <ey>	Wischt von Start zu Ende	—
type.sh <text>	Tippt Text in fokussiertes Feld	—
button.sh <name>	Druckt Hardware-Button (home, lock, ...)	—

Bevorzugt tap_by_id.sh wenn das Ziel einen stabilen accessibilityIdentifier traegt. Spart den manuellen Loop dump → grep → Read → Mittelpunkt rechnen → tap.sh. Bei 0/>1 Treffern bricht das Script mit Hint ab. tap_by_label.sh ist der Fallback, wenn nur ein lokalisiertes VoiceOver-Label verfuegbar ist — fragil bei Sprachwechseln.

Standard-Loop

# 1. Interagieren — stabiler accessibilityIdentifier vorhanden?
scripts/screenshot-ios/tap_by_id.sh library.search.field

# 2. Visuell verifizieren
scripts/screenshot-ios/shot.sh   # → schreibt tmp/ios.png, gibt Pfad aus
# → mit Read-Tool oeffnen

# Wiederholen ab 1.

Fallback ohne Identifier — Koordinaten-Loop:

scripts/screenshot-ios/dump_ui.sh  # → schreibt tmp/ui.json
# → mit Read-Tool oeffnen, AXFrame finden, Mittelpunkt berechnen:
#   tap-x = x + width/2 ; tap-y = y + height/2
scripts/screenshot-ios/tap.sh 201 582

Goldene Regel: Nach jeder Interaktion frisch dumpen — gecachte Koordinaten sind nach einem Frame schon falsch. tap_by_id.sh/tap_by_label.sh machen das intern automatisch.

Fallen, die diese Scripts NICHT loesen

• SwiftUI .menu-Picker: Element-Mittelpunkt oeffnet das Popup nicht. Tippe auf den Wert-Text auf der rechten Seite des Elements.
• TabBar-Items: Tauchen oft nicht im Accessibility-Baum auf und reagieren auch auf Koordinaten-Taps nicht zuverlaessig. Aendere den App-Zustand auf einem anderen Weg.
• Wheel Picker (z.B. Timer-Minuten): AXValue ist 0-basiert (AXValue 0 = 1 min). Eine Reihe ≈ 35pt. Nach Swipe immer dump_ui.sh und AXValue pruefen — visuelles Rendering kann nachhinken.
• Element-Suche per --id: Fragil auf iOS 18. Diese Scripts arbeiten ausschliesslich mit Koordinaten.

App-Lifecycle (NICHT in Scripts)

Diese Aktionen laufen ueber XcodeBuildMCP-Tools und sind keine Bash-Calls:

Aktion	Tool
Bauen + starten	mcp__XcodeBuildMCP__build_run_sim
Nur starten	mcp__XcodeBuildMCP__launch_app_sim
Stoppen	mcp__XcodeBuildMCP__stop_app_sim
Simulator booten	mcp__XcodeBuildMCP__boot_sim
Defaults setzen	mcp__XcodeBuildMCP__session_set_defaults

Vor dem ersten Build in einer Session: session_show_defaults aufrufen (siehe globale MCP-Anweisungen).

Wann diesen Skill NICHT nutzen

• Fastlane-Marketing-Screenshots (mehrsprachig, automatisiert via XCUITest): → /create-ui-test. Anderer Workflow, anderes Target.
• Reine App-Lifecycle-Operationen ohne Verifikation: direkter MCP-Aufruf.

Wann andere Skills hier verweisen sollten

• /review-view und /review-website: wenn visuelle Verifikation einer View Teil der Bewertung ist.
• /implement-ticket: wenn die Akzeptanzkriterien eines Tickets visuelle UI-Aenderungen umfassen, die nicht durch Unit-Tests abgedeckt sind.

Diese Skills muessen den Verweis selbst im eigenen Markdown setzen — Skills rufen einander nicht programmatisch auf.

Referenzen

• Scripts: scripts/screenshot-ios/*.sh
• Standard-Simulator-Setup: XcodeBuildMCP session-show-defaults
• Tool-Hintergrund: axe (cameroncooke/axe, brew), xcrun simctl, sips