Enregistrement de l'automatisation UI (Xcode 26+)
Guide de la fonctionnalité d'enregistrement d'automatisation UI de Xcode 26 pour créer des tests UI via l'enregistrement des interactions utilisateur.
Le workflow en trois phases
De la WWDC 2025-344 :
┌─────────────────────────────────────────────────────────────┐
│ Workflow d'automatisation UI │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. ENREGISTRER ──► Interagir avec l'application dans le │
│ simulateur. Xcode capture le code de │
│ test Swift │
│ │
│ 2. REJOUER ──────► Exécuter sur plusieurs appareils, │
│ langues et configurations. Utiliser des│
│ plans de test pour multi-configuration │
│ │
│ 3. RÉVISER ──────► Regarder les enregistrements vidéo dans │
│ le rapport de test. Analyser les │
│ échecs avec des captures d'écran │
│ │
└─────────────────────────────────────────────────────────────┘
Phase 1 : Enregistrement
Démarrer un enregistrement
- Ouvrez votre fichier de test UI dans Xcode
- Placez le curseur à l'intérieur d'une méthode de test
- Debug → Record UI Automation (ou utilisez le bouton d'enregistrement)
- L'application se lance dans le simulateur
- Effectuez des interactions - Xcode génère le code
- Arrêtez l'enregistrement une fois terminé
Ce qui est enregistré
- Taps sur boutons, cellules, contrôles
- Saisie de texte dans les champs de texte
- Balayages et défilement
- Gestes (pincement, rotation)
- Pressions de boutons matériels (Accueil, volume)
Exemple de code généré
// Xcode génère ce code à partir de vos interactions
func testLoginFlow() {
let app = XCUIApplication()
app.launch()
// Enregistré : Tap sur le champ email, saisie de l'email
app.textFields["Email"].tap()
app.textFields["Email"].typeText("[email protected]")
// Enregistré : Tap sur le champ mot de passe, saisie du mot de passe
app.secureTextFields["Password"].tap()
app.secureTextFields["Password"].typeText("password123")
// Enregistré : Tap sur le bouton de connexion
app.buttons["Login"].tap()
}
Améliorer le code enregistré
Important : Le code enregistré est souvent fragile. Améliorez-le toujours pour plus de stabilité.
1. Ajouter des identifiants d'accessibilité
Le code enregistré utilise des libellés qui changent avec la localisation :
// ENREGISTRÉ (fragile - change avec la localisation)
app.buttons["Login"].tap()
// AMÉLIORÉ (stable - utilise un identifiant)
app.buttons["loginButton"].tap()
Ajoutez des identifiants dans le code de votre application :
// SwiftUI
Button("Connexion") { ... }
.accessibilityIdentifier("loginButton")
// UIKit
loginButton.accessibilityIdentifier = "loginButton"
2. Ajouter waitForExistence
Le code enregistré suppose que les éléments existent immédiatement :
// ENREGISTRÉ (peut échouer si l'application est lente)
app.buttons["Login"].tap()
// AMÉLIORÉ (attend l'élément)
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
loginButton.tap()
3. Ajouter des assertions
Le code enregistré effectue des actions sans vérification :
// ENREGISTRÉ (pas de vérification)
app.buttons["Login"].tap()
// AMÉLIORÉ (avec assertion)
app.buttons["loginButton"].tap()
let welcomeLabel = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeLabel.waitForExistence(timeout: 10),
"L'écran d'accueil devrait apparaître après la connexion")
4. Utiliser des requêtes plus courtes
Le code enregistré peut avoir des requêtes trop spécifiques :
// ENREGISTRÉ (trop spécifique)
app.tables.cells.element(boundBy: 0).buttons["Action"].tap()
// AMÉLIORÉ (plus simple)
app.buttons["actionButton"].tap()
Directives de sélection des requêtes
De la WWDC 2025-344 :
| Scénario | Problème | Solution |
|---|---|---|
| Chaînes localisées | "Connexion" change selon la langue | Utiliser accessibilityIdentifier |
| Vues profondément imbriquées | Les longues chaînes de requêtes se cassent facilement | Utiliser la requête la plus courte possible |
| Contenu dynamique | Le contenu des cellules change | Utiliser un identifiant ou une requête générique |
| Correspondances multiples | La requête retourne plusieurs éléments | Ajouter un identifiant unique |
Bonnes pratiques
- Privilégier les identifiants plutôt que les libellés
- Utiliser la requête la plus courte qui fonctionne
- Éviter les requêtes basées sur l'index (
element(boundBy: 0)) - Ajouter des identifiants au contenu dynamique
Phase 2 : Relecture avec les plans de test
Les plans de test permettent d'exécuter les mêmes tests sur plusieurs configurations.
Créer un plan de test
- File → New → File → Test Plan
- Ajoutez les cibles de test
- Configurez les configurations
Structure d'un plan de test
{
"configurations": [
{
"name": "iPhone - Anglais",
"options": {
"targetForVariableExpansion": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyApp"
},
"language": "en",
"region": "US"
}
},
{
"name": "iPhone - Espagnol",
"options": {
"language": "es",
"region": "ES"
}
},
{
"name": "iPhone - Mode sombre",
"options": {
"userInterfaceStyle": "dark"
}
},
{
"name": "iPad - Paysage",
"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
}
Options de configuration
| Option | Objectif |
|---|---|
language | Tester la localisation |
region | Tester le format régional |
userInterfaceStyle | Tester le mode sombre/clair |
targetForVariableExpansion | Cible de l'application pour la configuration |
testTimeoutsEnabled | Activer l'application des délais d'attente |
defaultTestExecutionTimeAllowance | Délai d'attente en secondes |
Exécuter avec un plan de test
# Ligne de commande
xcodebuild test \
-scheme "MyApp" \
-testPlan "MyTestPlan" \
-destination "platform=iOS Simulator,name=iPhone 16" \
-resultBundlePath /tmp/results.xcresult
# Dans Xcode
# Product → Test Plan → Sélectionnez votre plan
# Puis Cmd+U pour exécuter les tests
Phase 3 : Révision
Fonctionnalités du rapport de test
Après l'exécution des tests :
- Consultez les résultats des tests dans le Navigateur de rapports
- Regardez les enregistrements vidéo de chaque test
- Voyez les captures d'écran aux points d'échec
- Analysez la chronologie des actions
Activer les pièces jointes
Dans le plan de test ou le schéma :
"options": {
"systemAttachmentLifetime": "keepAlways",
"userAttachmentLifetime": "keepAlways"
}
Capturer des captures d'écran personnalisées
func testCheckout() {
// ... actions ...
// Capture d'écran manuelle à un point spécifique
let screenshot = app.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.name = "Confirmation de commande"
attachment.lifetime = .keepAlways
add(attachment)
}
Modèles courants
Modèle de flux de connexion
func testLoginWithValidCredentials() throws {
let app = XCUIApplication()
app.launch()
// Naviguer vers la connexion
let showLoginButton = app.buttons["showLoginButton"]
XCTAssertTrue(showLoginButton.waitForExistence(timeout: 5))
showLoginButton.tap()
// Saisir les identifiants
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")
// Soumettre
app.buttons["loginButton"].tap()
// Vérifier le succès
let welcomeScreen = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeScreen.waitForExistence(timeout: 10))
}
Modèle de flux de navigation
func testNavigateToSettings() throws {
let app = XCUIApplication()
app.launch()
// Ouvrir l'élément de la barre d'onglets
app.tabBars.buttons["Réglages"].tap()
// Vérifier la navigation
let settingsTitle = app.navigationBars["Réglages"]
XCTAssertTrue(settingsTitle.waitForExistence(timeout: 5))
// Naviguer plus profondément
app.tables.cells["Compte"].tap()
XCTAssertTrue(app.navigationBars["Compte"].exists)
}
Modèle de validation de formulaire
func testFormValidation() throws {
let app = XCUIApplication()
app.launch()
// Soumettre un formulaire vide
app.buttons["submitButton"].tap()
// Vérifier l'apparition de l'erreur
let errorAlert = app.alerts["Erreur"]
XCTAssertTrue(errorAlert.waitForExistence(timeout: 5))
XCTAssertTrue(errorAlert.staticTexts["Veuillez remplir tous les champs"].exists)
// Fermer l'alerte
errorAlert.buttons["OK"].tap()
}
Dépannage
L'enregistrement ne démarre pas
- Assurez-vous d'être dans une méthode de test
- Vérifiez que le simulateur est disponible
- Vérifiez que l'application se compile et s'exécute
- Essayez de redémarrer Xcode
Le code enregistré ne fonctionne pas
- Ajoutez waitForExistence avant les interactions
- Vérifiez que les identifiants d'accessibilité sont définis
- Simplifiez les requêtes à la forme la plus courte
- Exécutez l'application manuellement pour vérifier que le flux fonctionne
Les tests passent en local, échouent en CI
- Augmentez les délais d'attente pour les machines CI plus lentes
- Ajoutez des attentes explicites pour les animations
- Vérifiez que la configuration du simulateur correspond
- Désactivez les animations dans la configuration de test :
app.launchArguments = ["--disable-animations"]
Anti-patrons
Ne pas utiliser le code enregistré brut en CI
// MAUVAIS - Code enregistré brut
app.buttons["Login"].tap()
app.textFields["Email"].typeText("[email protected]")
// BON - Amélioré pour la CI
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 10))
loginButton.tap()
Ne pas coder en dur les coordonnées
// MAUVAIS - Coordonnées issues de l'enregistrement
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
// BON - Utiliser des requêtes d'éléments
app.buttons["centerButton"].tap()
Ne pas sauter les assertions
// MAUVAIS - Actions uniquement
app.buttons["Login"].tap()
sleep(2) // Espérer que ça marche
// BON - Vérifier les résultats
app.buttons["loginButton"].tap()
XCTAssertTrue(app.staticTexts["Bienvenue"].waitForExistence(timeout: 10))
Ressources
WWDC : 2025-344, 2024-10206, 2019-413
Docs : /xcode/testing/recording-ui-tests, /xctest/xcuiapplication
Skills : axiom-xctest-automation, axiom-ui-testing