UI-Automatisierung aufzeichnen (Xcode 26+)
Anleitung zur Aufzeichnungsfunktion für UI-Automatisierung in Xcode 26 zum Erstellen von UI-Tests durch Benutzerinteraktionsaufzeichnung.
Der Dreiphasen-Workflow
Aus WWDC 2025-344:
┌─────────────────────────────────────────────────────────────┐
│ UI-Automatisierungs-Workflow │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. AUFZEICHNEN ──► Mit App im Simulator interagieren │
│ Xcode erfasst als Swift-Testcode │
│ │
│ 2. WIEDERGEBEN ──► Auf verschiedenen Geräten, │
│ Sprachen und Konfigurationen ausführen │
│ Mit Testplänen für Multi-Konfiguration │
│ │
│ 3. ÜBERPRÜFEN ──► Videoaufzeichnungen im Testbericht │
│ ansehen und Fehler mit Screenshots │
│ analysieren │
│ │
└─────────────────────────────────────────────────────────────┘
Phase 1: Aufzeichnen
Aufzeichnung starten
- Öffnen Sie Ihre UI-Testdatei in Xcode
- Platzieren Sie den Cursor innerhalb einer Testmethode
- Debug → UI-Automatisierung aufzeichnen (oder den Aufnahmebutton verwenden)
- Die App wird im Simulator gestartet
- Führen Sie Interaktionen durch – Xcode generiert Code
- Stoppen Sie die Aufzeichnung, wenn Sie fertig sind
Was wird aufgezeichnet
- Tippen auf Buttons, Zellen, Steuerelemente
- Texteingabe in Textfelder
- Wischen und Scrollen
- Gesten (Zusammenziehen, Drehen)
- Hardware-Tastendrücke (Home, Lautstärke)
Beispiel für generierten Code
// Xcode generiert diesen Code aus Ihren Interaktionen
func testLoginFlow() {
let app = XCUIApplication()
app.launch()
// Aufgezeichnet: E-Mail-Feld antippen, E-Mail eingeben
app.textFields["Email"].tap()
app.textFields["Email"].typeText("[email protected]")
// Aufgezeichnet: Passwortfeld antippen, Passwort eingeben
app.secureTextFields["Password"].tap()
app.secureTextFields["Password"].typeText("password123")
// Aufgezeichnet: Login-Button antippen
app.buttons["Login"].tap()
}
Aufgezeichneten Code verbessern
Wichtig: Aufgezeichneter Code ist oft instabil. Verbessern Sie ihn immer für Stabilität.
1. Accessibility-Identifier hinzufügen
Aufgezeichneter Code verwendet Labels, die bei Lokalisierung brechen:
// AUFGEZEICHNET (instabil – bricht bei Lokalisierung)
app.buttons["Login"].tap()
// VERBESSERT (stabil – verwendet Identifier)
app.buttons["loginButton"].tap()
Fügen Sie Identifier in Ihrem App-Code hinzu:
// SwiftUI
Button("Login") { ... }
.accessibilityIdentifier("loginButton")
// UIKit
loginButton.accessibilityIdentifier = "loginButton"
2. waitForExistence hinzufügen
Aufgezeichneter Code geht davon aus, dass Elemente sofort existieren:
// AUFGEZEICHNET (kann fehlschlagen, wenn App langsam ist)
app.buttons["Login"].tap()
// VERBESSERT (wartet auf Element)
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
loginButton.tap()
3. Assertions hinzufügen
Aufgezeichneter Code führt nur Aktionen ohne Verifizierung aus:
// AUFGEZEICHNET (keine Verifizierung)
app.buttons["Login"].tap()
// VERBESSERT (mit Assertion)
app.buttons["loginButton"].tap()
let welcomeLabel = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeLabel.waitForExistence(timeout: 10),
"Willkommensbildschirm sollte nach Login erscheinen")
4. Kürzere Abfragen verwenden
Aufgezeichneter Code kann übermäßig spezifische Abfragen enthalten:
// AUFGEZEICHNET (zu spezifisch)
app.tables.cells.element(boundBy: 0).buttons["Action"].tap()
// VERBESSERT (einfacher)
app.buttons["actionButton"].tap()
Richtlinien zur Abfrageauswahl
Aus WWDC 2025-344:
| Szenario | Problem | Lösung |
|---|---|---|
| Lokalisierte Zeichenketten | "Login" ändert sich je nach Sprache | accessibilityIdentifier verwenden |
| Tief verschachtelte Ansichten | Lange Abfrageketten brechen leicht | Kürzestmögliche Abfrage verwenden |
| Dynamischer Inhalt | Zellinhalt ändert sich | Identifier oder generische Abfrage verwenden |
| Mehrere Treffer | Abfrage gibt viele Elemente zurück | Eindeutigen Identifier hinzufügen |
Best Practices
- Identifier Labels vorziehen
- Die kürzeste funktionierende Abfrage verwenden
- Indexbasierte Abfragen vermeiden (
element(boundBy: 0)) - Identifier zu dynamischem Inhalt hinzufügen
Phase 2: Wiedergeben mit Testplänen
Testpläne ermöglichen das Ausführen derselben Tests über mehrere Konfigurationen hinweg.
Testplan erstellen
- Datei → Neu → Datei → Testplan
- Testziele hinzufügen
- Konfigurationen konfigurieren
Testplan-Struktur
{
"configurations": [
{
"name": "iPhone - Englisch",
"options": {
"targetForVariableExpansion": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyApp"
},
"language": "en",
"region": "US"
}
},
{
"name": "iPhone - Spanisch",
"options": {
"language": "es",
"region": "ES"
}
},
{
"name": "iPhone - Dunkelmodus",
"options": {
"userInterfaceStyle": "dark"
}
},
{
"name": "iPad - Querformat",
"options": {
"defaultTestExecutionTimeAllowance": 120,
"testTimeoutsEnabled": true
}
}
],
"defaultOptions": {
"targetForVariableExpansion": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyApp"
}
},
"testTargets": [
{
"target": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyAppUITests",
"name": "MyAppUITests"
}
}
],
"version": 1
}
Konfigurationsoptionen
| Option | Zweck |
|---|---|
language | Lokalisierung testen |
region | Regionale Formatierung testen |
userInterfaceStyle | Dunkel-/Hellmodus testen |
targetForVariableExpansion | App-Ziel für Konfiguration |
testTimeoutsEnabled | Timeout-Erzwingung aktivieren |
defaultTestExecutionTimeAllowance | Timeout in Sekunden |
Mit Testplan ausführen
# Befehlszeile
xcodebuild test \
-scheme "MyApp" \
-testPlan "MyTestPlan" \
-destination "platform=iOS Simulator,name=iPhone 16" \
-resultBundlePath /tmp/results.xcresult
# In Xcode
# Produkt → Testplan → Wählen Sie Ihren Plan
# Dann Cmd+U, um Tests auszuführen
Phase 3: Überprüfen
Funktionen des Testberichts
Nach Abschluss der Tests:
- Testergebnisse anzeigen im Berichtsnavigator
- Videoaufzeichnungen jedes Tests ansehen
- Screenshots an Fehlerstellen sehen
- Zeitleiste der Aktionen analysieren
Anhänge aktivieren
Im Testplan oder Schema:
"options": {
"systemAttachmentLifetime": "keepAlways",
"userAttachmentLifetime": "keepAlways"
}
Benutzerdefinierte Screenshots erfassen
func testCheckout() {
// ... Aktionen ...
// Manueller Screenshot zu einem bestimmten Zeitpunkt
let screenshot = app.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.name = "Checkout-Bestätigung"
attachment.lifetime = .keepAlways
add(attachment)
}
Häufige Muster
Vorlage für Login-Ablauf
func testLoginWithValidCredentials() throws {
let app = XCUIApplication()
app.launch()
// Zum Login navigieren
let showLoginButton = app.buttons["showLoginButton"]
XCTAssertTrue(showLoginButton.waitForExistence(timeout: 5))
showLoginButton.tap()
// Anmeldedaten eingeben
let emailField = app.textFields["emailTextField"]
XCTAssertTrue(emailField.waitForExistence(timeout: 5))
emailField.tap()
emailField.typeText("[email protected]")
let passwordField = app.secureTextFields["passwordTextField"]
passwordField.tap()
passwordField.typeText("password123")
// Absenden
app.buttons["loginButton"].tap()
// Erfolg überprüfen
let welcomeScreen = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeScreen.waitForExistence(timeout: 10))
}
Vorlage für Navigationsablauf
func testNavigateToSettings() throws {
let app = XCUIApplication()
app.launch()
// Tab-Leiste öffnen
app.tabBars.buttons["Einstellungen"].tap()
// Navigation überprüfen
let settingsTitle = app.navigationBars["Einstellungen"]
XCTAssertTrue(settingsTitle.waitForExistence(timeout: 5))
// Tiefer navigieren
app.tables.cells["Konto"].tap()
XCTAssertTrue(app.navigationBars["Konto"].exists)
}
Vorlage für Formularvalidierung
func testFormValidation() throws {
let app = XCUIApplication()
app.launch()
// Leeres Formular absenden
app.buttons["submitButton"].tap()
// Fehler überprüfen
let errorAlert = app.alerts["Fehler"]
XCTAssertTrue(errorAlert.waitForExistence(timeout: 5))
XCTAssertTrue(errorAlert.staticTexts["Bitte füllen Sie alle Felder aus"].exists)
// Alert schließen
errorAlert.buttons["OK"].tap()
}
Fehlerbehebung
Aufzeichnung startet nicht
- Stellen Sie sicher, dass Sie sich in einer Testmethode befinden
- Überprüfen Sie, ob der Simulator verfügbar ist
- Verifizieren Sie, dass die App erstellt und ausgeführt wird
- Versuchen Sie, Xcode neu zu starten
Aufgezeichneter Code funktioniert nicht
waitForExistencevor Interaktionen hinzufügen- Überprüfen Sie Accessibility-Identifier sind gesetzt
- Vereinfachen Sie Abfragen auf die kürzeste Form
- Führen Sie die App manuell aus, um den Ablauf zu überprüfen
Tests bestehen lokal, schlagen in CI fehl
- Erhöhen Sie Timeouts für langsamere CI-Maschinen
- Fügen Sie explizite Wartezeiten für Animationen hinzu
- Überprüfen Sie die Simulator-Konfiguration auf Übereinstimmung
- Deaktivieren Sie Animationen im Test-Setup:
app.launchArguments = ["--disable-animations"]
Anti-Patterns
Roh aufgezeichneten Code nicht in CI verwenden
// SCHLECHT – Roh aufgezeichneter Code
app.buttons["Login"].tap()
app.textFields["Email"].typeText("[email protected]")
// GUT – Für CI verbessert
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 10))
loginButton.tap()
Koordinaten nicht hartcodieren
// SCHLECHT – Koordinaten aus Aufzeichnung
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
// GUT – Elementabfragen verwenden
app.buttons["centerButton"].tap()
Assertions nicht auslassen
// SCHLECHT – Nur Aktionen
app.buttons["Login"].tap()
sleep(2) // Hoffen, dass es funktioniert
// GUT – Ergebnisse überprüfen
app.buttons["loginButton"].tap()
XCTAssertTrue(app.staticTexts["Willkommen"].waitForExistence(timeout: 10))
Ressourcen
WWDC: 2025-344, 2024-10206, 2019-413
Dokumentation: /xcode/testing/recording-ui-tests, /xctest/xcuiapplication
Skills: axiom-xctest-automation, axiom-ui-testing
Übersetzt aus dem Englischen. Die ursprüngliche Quelle ist die WWDC 2025-344.