Communitygithub.com

ComeOnOliver/skillshub

Úsalo al configurar la grabación de pruebas de UI en Xcode 26, mejorar las pruebas grabadas para mayor estabilidad o configurar planes de prueba para reproducción multi-configuración. Basado en WWDC 2025-344 'Grabar, reproducir y revisar'.

¿Qué es skillshub?

Este skill proporciona una guía completa sobre la función 'Grabación de Automatización de UI' de Xcode 26, que permite crear pruebas de UI mediante la grabación de interacciones del usuario en el simulador. Es útil para desarrolladores de iOS que quieran automatizar pruebas de interfaz de usuario de manera eficiente, ya que explica el flujo de trabajo de tres fases: Grabar, Reproducir y Revisar. El skill detalla cómo iniciar una grabación, qué se registra (toques, texto, gestos, etc.) y cómo mejorar el código generado para hacerlo más estable, añadiendo identificadores de accesibilidad, esperas explícitas y aserciones. También cubre la configuración de planes de prueba para ejecuciones multi-configuración (diferentes idiomas, regiones, modo oscuro, orientación) y cómo revisar los resultados mediante vídeos y capturas de pantalla. Finalmente, incluye plantillas de patrones comunes, resolución de problemas y anti-patrones a evitar, como el uso de coordenadas fijas o la omisión de verificaciones.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Grabación de Automatización de UI (Xcode 26+)

Guía para la función 'Grabación de Automatización de UI' de Xcode 26, que permite crear pruebas de UI mediante la grabación de interacciones del usuario.

El Flujo de Trabajo en Tres Fases

De WWDC 2025-344:

┌─────────────────────────────────────────────────────────────┐
│                Flujo de Trabajo de Automatización de UI     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. GRABAR ──────► Interactúa con la app en el Simulador   │
│                    Xcode captura el código Swift de prueba  │
│                                                             │
│  2. REPRODUCIR ──► Ejecuta en dispositivos, idiomas,       │
│                    configuraciones usando planes de prueba  │
│                                                             │
│  3. REVISAR ─────► Mira grabaciones de vídeo en el informe │
│                    Analiza fallos con capturas de pantalla  │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Fase 1: Grabación

Iniciar una Grabación

  1. Abre tu archivo de prueba de UI en Xcode
  2. Coloca el cursor dentro de un método de prueba
  3. Debug → Record UI Automation (o usa el botón de grabación)
  4. La app se lanza en el Simulador
  5. Realiza interacciones - Xcode genera código
  6. Detén la grabación cuando termines

Qué se Graba

  • Toques en botones, celdas, controles
  • Entrada de texto en campos de texto
  • Deslizamientos y desplazamiento
  • Gestos (pellizco, rotación)
  • Pulsaciones de botones físicos (Inicio, volumen)

Ejemplo de Código Generado

// Xcode genera esto a partir de tus interacciones
func testLoginFlow() {
    let app = XCUIApplication()
    app.launch()

    // Grabado: Tocar campo de email, escribir email
    app.textFields["Email"].tap()
    app.textFields["Email"].typeText("[email protected]")

    // Grabado: Tocar campo de contraseña, escribir contraseña
    app.secureTextFields["Password"].tap()
    app.secureTextFields["Password"].typeText("password123")

    // Grabado: Tocar botón de inicio de sesión
    app.buttons["Login"].tap()
}

Mejorar el Código Grabado

Crítico: El código grabado suele ser frágil. Siempre mejóralo para mayor estabilidad.

1. Añadir Identificadores de Accesibilidad

El código grabado usa etiquetas que se rompen con la localización:

// GRABADO (frágil - se rompe con localización)
app.buttons["Login"].tap()

// MEJORADO (estable - usa identificador)
app.buttons["loginButton"].tap()

Añade identificadores en el código de tu app:

// SwiftUI
Button("Login") { ... }
    .accessibilityIdentifier("loginButton")

// UIKit
loginButton.accessibilityIdentifier = "loginButton"

2. Añadir waitForExistence

El código grabado asume que los elementos existen inmediatamente:

// GRABADO (puede fallar si la app es lenta)
app.buttons["Login"].tap()

// MEJORADO (espera al elemento)
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
loginButton.tap()

3. Añadir Aserciones

El código grabado solo realiza acciones sin verificación:

// GRABADO (sin verificación)
app.buttons["Login"].tap()

// MEJORADO (con aserción)
app.buttons["loginButton"].tap()
let welcomeLabel = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeLabel.waitForExistence(timeout: 10),
              "La pantalla de bienvenida debería aparecer después del inicio de sesión")

4. Usar Consultas Más Cortas

El código grabado puede tener consultas excesivamente específicas:

// GRABADO (demasiado específico)
app.tables.cells.element(boundBy: 0).buttons["Action"].tap()

// MEJORADO (más simple)
app.buttons["actionButton"].tap()

Guías de Selección de Consultas

De WWDC 2025-344:

EscenarioProblemaSolución
Cadenas localizadas"Login" cambia según el idiomaUsa accessibilityIdentifier
Vistas profundamente anidadasCadenas de consulta largas se rompen fácilmenteUsa la consulta más corta posible
Contenido dinámicoEl contenido de las celdas cambiaUsa identificador o consulta genérica
Múltiples coincidenciasLa consulta devuelve muchos elementosAñade un identificador único

Mejores Prácticas

  1. Prefiere identificadores sobre etiquetas
  2. Usa la consulta más corta que funcione
  3. Evita consultas basadas en índices (element(boundBy: 0))
  4. Añade identificadores al contenido dinámico

Fase 2: Reproducción con Planes de Prueba

Los planes de prueba permiten ejecutar las mismas pruebas en múltiples configuraciones.

Crear un Plan de Prueba

  1. File → New → File → Test Plan
  2. Añade objetivos de prueba
  3. Configura las configuraciones

Estructura del Plan de Prueba

{
  "configurations": [
    {
      "name": "iPhone - Inglés",
      "options": {
        "targetForVariableExpansion": {
          "containerPath": "container:MyApp.xcodeproj",
          "identifier": "MyApp"
        },
        "language": "en",
        "region": "US"
      }
    },
    {
      "name": "iPhone - Español",
      "options": {
        "language": "es",
        "region": "ES"
      }
    },
    {
      "name": "iPhone - Modo Oscuro",
      "options": {
        "userInterfaceStyle": "dark"
      }
    },
    {
      "name": "iPad - Horizontal",
      "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
}

Opciones de Configuración

OpciónPropósito
languageProbar localización
regionProbar formato regional
userInterfaceStyleProbar modo oscuro/claro
targetForVariableExpansionObjetivo de la app para configuración
testTimeoutsEnabledHabilitar aplicación de tiempos de espera
defaultTestExecutionTimeAllowanceTiempo de espera en segundos

Ejecutar con Plan de Prueba

# Línea de comandos
xcodebuild test \
  -scheme "MyApp" \
  -testPlan "MyTestPlan" \
  -destination "platform=iOS Simulator,name=iPhone 16" \
  -resultBundlePath /tmp/results.xcresult

# En Xcode
# Product → Test Plan → Selecciona tu plan
# Luego Cmd+U para ejecutar las pruebas

Fase 3: Revisión

Características del Informe de Prueba

Después de que las pruebas se completen:

  1. Ve los resultados en el Navegador de Informes
  2. Mira las grabaciones de vídeo de cada prueba
  3. Ve capturas de pantalla en los puntos de fallo
  4. Analiza la línea de tiempo de las acciones

Habilitar Adjuntos

En el plan de prueba o esquema:

"options": {
  "systemAttachmentLifetime": "keepAlways",
  "userAttachmentLifetime": "keepAlways"
}

Capturar Capturas de Pantalla Personalizadas

func testCheckout() {
    // ... acciones ...

    // Captura de pantalla manual en un punto específico
    let screenshot = app.screenshot()
    let attachment = XCTAttachment(screenshot: screenshot)
    attachment.name = "Confirmación de Compra"
    attachment.lifetime = .keepAlways
    add(attachment)
}

Patrones Comunes

Plantilla de Flujo de Inicio de Sesión

func testLoginWithValidCredentials() throws {
    let app = XCUIApplication()
    app.launch()

    // Navegar al inicio de sesión
    let showLoginButton = app.buttons["showLoginButton"]
    XCTAssertTrue(showLoginButton.waitForExistence(timeout: 5))
    showLoginButton.tap()

    // Ingresar credenciales
    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")

    // Enviar
    app.buttons["loginButton"].tap()

    // Verificar éxito
    let welcomeScreen = app.staticTexts["welcomeLabel"]
    XCTAssertTrue(welcomeScreen.waitForExistence(timeout: 10))
}

Plantilla de Flujo de Navegación

func testNavigateToSettings() throws {
    let app = XCUIApplication()
    app.launch()

    // Abrir elemento de la barra de pestañas
    app.tabBars.buttons["Settings"].tap()

    // Verificar navegación
    let settingsTitle = app.navigationBars["Settings"]
    XCTAssertTrue(settingsTitle.waitForExistence(timeout: 5))

    // Navegar más profundo
    app.tables.cells["Account"].tap()
    XCTAssertTrue(app.navigationBars["Account"].exists)
}

Plantilla de Validación de Formulario

func testFormValidation() throws {
    let app = XCUIApplication()
    app.launch()

    // Enviar formulario vacío
    app.buttons["submitButton"].tap()

    // Verificar que aparece el error
    let errorAlert = app.alerts["Error"]
    XCTAssertTrue(errorAlert.waitForExistence(timeout: 5))
    XCTAssertTrue(errorAlert.staticTexts["Por favor completa todos los campos"].exists)

    // Descartar alerta
    errorAlert.buttons["OK"].tap()
}

Solución de Problemas

La Grabación No Inicia

  1. Asegúrate de estar en un método de prueba
  2. Verifica que el simulador esté disponible
  3. Confirma que la app se construye y ejecuta
  4. Intenta reiniciar Xcode

El Código Grabado No Funciona

  1. Añade waitForExistence antes de las interacciones
  2. Verifica que los identificadores de accesibilidad estén configurados
  3. Simplifica las consultas a la forma más corta
  4. Ejecuta la app manualmente para verificar que el flujo funciona

Las Pruebas Funcionan Localmente, Fallan en CI

  1. Aumenta los tiempos de espera para máquinas CI más lentas
  2. Añade esperas explícitas para animaciones
  3. Verifica que la configuración del simulador coincida
  4. Desactiva las animaciones en la configuración de prueba:
    app.launchArguments = ["--disable-animations"]
    

Anti-Patrones

No Usar Código Grabado en Bruto en CI

// MALO - Código grabado en bruto
app.buttons["Login"].tap()
app.textFields["Email"].typeText("[email protected]")

// BUENO - Mejorado para CI
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 10))
loginButton.tap()

No Codificar Coordenadas Fijas

// MALO - Coordenadas de la grabación
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()

// BUENO - Usa consultas de elementos
app.buttons["centerButton"].tap()

No Omitir Aserciones

// MALO - Solo acciones
app.buttons["Login"].tap()
sleep(2)  // Esperar que funcione

// BUENO - Verificar resultados
app.buttons["loginButton"].tap()
XCTAssertTrue(app.staticTexts["Welcome"].waitForExistence(timeout: 10))

Recursos

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 relacionados