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
- Abre tu archivo de prueba de UI en Xcode
- Coloca el cursor dentro de un método de prueba
- Debug → Record UI Automation (o usa el botón de grabación)
- La app se lanza en el Simulador
- Realiza interacciones - Xcode genera código
- 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:
| Escenario | Problema | Solución |
|---|---|---|
| Cadenas localizadas | "Login" cambia según el idioma | Usa accessibilityIdentifier |
| Vistas profundamente anidadas | Cadenas de consulta largas se rompen fácilmente | Usa la consulta más corta posible |
| Contenido dinámico | El contenido de las celdas cambia | Usa identificador o consulta genérica |
| Múltiples coincidencias | La consulta devuelve muchos elementos | Añade un identificador único |
Mejores Prácticas
- Prefiere identificadores sobre etiquetas
- Usa la consulta más corta que funcione
- Evita consultas basadas en índices (
element(boundBy: 0)) - 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
- File → New → File → Test Plan
- Añade objetivos de prueba
- 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ón | Propósito |
|---|---|
language | Probar localización |
region | Probar formato regional |
userInterfaceStyle | Probar modo oscuro/claro |
targetForVariableExpansion | Objetivo de la app para configuración |
testTimeoutsEnabled | Habilitar aplicación de tiempos de espera |
defaultTestExecutionTimeAllowance | Tiempo 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:
- Ve los resultados en el Navegador de Informes
- Mira las grabaciones de vídeo de cada prueba
- Ve capturas de pantalla en los puntos de fallo
- 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
- Asegúrate de estar en un método de prueba
- Verifica que el simulador esté disponible
- Confirma que la app se construye y ejecuta
- Intenta reiniciar Xcode
El Código Grabado No Funciona
- Añade waitForExistence antes de las interacciones
- Verifica que los identificadores de accesibilidad estén configurados
- Simplifica las consultas a la forma más corta
- Ejecuta la app manualmente para verificar que el flujo funciona
Las Pruebas Funcionan Localmente, Fallan en CI
- Aumenta los tiempos de espera para máquinas CI más lentas
- Añade esperas explícitas para animaciones
- Verifica que la configuración del simulador coincida
- 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