Communitygithub.com

ComeOnOliver/skillshub

À utiliser pour configurer l'enregistrement de tests UI dans Xcode 26, améliorer la stabilité des tests enregistrés ou paramétrer des plans de test pour une relecture multi-configuration. Basé sur la WWDC 2025-344 « Enregistrer, rejouer et réviser ».

Qu'est-ce que skillshub ?

ce skill fournit un guide complet pour utiliser la fonctionnalité d'enregistrement d'automatisation UI dans Xcode 26+. Il explique le workflow en trois phases (Enregistrer, Rejouer, Réviser) présenté à la WWDC 2025-344, permettant de créer des tests UI en interagissant avec l'application dans le simulateur, puis de les rejouer sur plusieurs configurations (langues, régions, styles d'interface) via des plans de test, et enfin de visionner les enregistrements vidéo et captures d'écran dans le rapport de test. Le skill met l'accent sur l'amélioration du code enregistré pour plus de robustesse : ajout d'identifiants d'accessibilité, de `waitForExistence`, d'assertions et de requêtes simplifiées. Il donne également des conseils pour configurer les plans de test, exécuter les tests en ligne de commande, capturer des captures d'écran personnalisées, structurer des modèles communs (connexion, navigation, validation de formulaire), et éviter les anti-patrons comme les coordonnées codées en dur ou l'absence de vérifications. Il est utile pour tout développeur iOS utilisant Xcode 26 ou version ultérieure souhaitant automatiser efficacement des tests UI.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-ui-recording

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Ouvrez votre fichier de test UI dans Xcode
  2. Placez le curseur à l'intérieur d'une méthode de test
  3. Debug → Record UI Automation (ou utilisez le bouton d'enregistrement)
  4. L'application se lance dans le simulateur
  5. Effectuez des interactions - Xcode génère le code
  6. 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énarioProblèmeSolution
Chaînes localisées"Connexion" change selon la langueUtiliser accessibilityIdentifier
Vues profondément imbriquéesLes longues chaînes de requêtes se cassent facilementUtiliser la requête la plus courte possible
Contenu dynamiqueLe contenu des cellules changeUtiliser un identifiant ou une requête générique
Correspondances multiplesLa requête retourne plusieurs élémentsAjouter un identifiant unique

Bonnes pratiques

  1. Privilégier les identifiants plutôt que les libellés
  2. Utiliser la requête la plus courte qui fonctionne
  3. Éviter les requêtes basées sur l'index (element(boundBy: 0))
  4. 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

  1. File → New → File → Test Plan
  2. Ajoutez les cibles de test
  3. 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

OptionObjectif
languageTester la localisation
regionTester le format régional
userInterfaceStyleTester le mode sombre/clair
targetForVariableExpansionCible de l'application pour la configuration
testTimeoutsEnabledActiver l'application des délais d'attente
defaultTestExecutionTimeAllowanceDé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 :

  1. Consultez les résultats des tests dans le Navigateur de rapports
  2. Regardez les enregistrements vidéo de chaque test
  3. Voyez les captures d'écran aux points d'échec
  4. 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

  1. Assurez-vous d'être dans une méthode de test
  2. Vérifiez que le simulateur est disponible
  3. Vérifiez que l'application se compile et s'exécute
  4. Essayez de redémarrer Xcode

Le code enregistré ne fonctionne pas

  1. Ajoutez waitForExistence avant les interactions
  2. Vérifiez que les identifiants d'accessibilité sont définis
  3. Simplifiez les requêtes à la forme la plus courte
  4. Exécutez l'application manuellement pour vérifier que le flux fonctionne

Les tests passent en local, échouent en CI

  1. Augmentez les délais d'attente pour les machines CI plus lentes
  2. Ajoutez des attentes explicites pour les animations
  3. Vérifiez que la configuration du simulateur correspond
  4. 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés