Gravando Automação de UI (Xcode 26+)
Guia para o recurso de Gravação de Automação de UI do Xcode 26 para criar testes de UI através da gravação de interações do usuário.
O Fluxo de Trabalho em Três Fases
Da WWDC 2025-344:
┌─────────────────────────────────────────────────────────────┐
│ Fluxo de Automação de UI │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. GRAVAR ──────► Interaja com o app no Simulador │
│ O Xcode captura como código de teste Swift│
│ │
│ 2. REPRODUZIR ──► Execute em dispositivos, idiomas, configs│
│ Usando planos de teste para multi-config │
│ │
│ 3. REVISAR ─────► Assista às gravações de vídeo no relatório│
│ Analise falhas com capturas de tela │
│ │
└─────────────────────────────────────────────────────────────┘
Fase 1: Gravando
Iniciando uma Gravação
- Abra seu arquivo de teste de UI no Xcode
- Posicione o cursor dentro de um método de teste
- Debug → Record UI Automation (ou use o botão de gravação)
- O app é iniciado no Simulador
- Realize interações - O Xcode gera o código
- Pare a gravação quando terminar
O Que é Gravado
- Toques em botões, células, controles
- Entrada de texto em campos de texto
- Deslizes e rolagem
- Gestos (pinça, rotação)
- Pressionamentos de botões de hardware (Home, volume)
Exemplo de Código Gerado
// O Xcode gera isso a partir de suas interações
func testLoginFlow() {
let app = XCUIApplication()
app.launch()
// Gravado: Tocar no campo de email, digitar email
app.textFields["Email"].tap()
app.textFields["Email"].typeText("[email protected]")
// Gravado: Tocar no campo de senha, digitar senha
app.secureTextFields["Password"].tap()
app.secureTextFields["Password"].typeText("password123")
// Gravado: Tocar no botão de login
app.buttons["Login"].tap()
}
Aprimorando o Código Gravado
Crítico: O código gravado é frequentemente frágil. Sempre aprimore-o para estabilidade.
1. Adicione Identificadores de Acessibilidade
O código gravado usa rótulos que quebram com a localização:
// GRAVADO (frágil - quebra com localização)
app.buttons["Login"].tap()
// APRIMORADO (estável - usa identificador)
app.buttons["loginButton"].tap()
Adicione identificadores no código do seu app:
// SwiftUI
Button("Login") { ... }
.accessibilityIdentifier("loginButton")
// UIKit
loginButton.accessibilityIdentifier = "loginButton"
2. Adicione waitForExistence
O código gravado assume que os elementos existem imediatamente:
// GRAVADO (pode falhar se o app estiver lento)
app.buttons["Login"].tap()
// APRIMORADO (espera pelo elemento)
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
loginButton.tap()
3. Adicione Asserções
O código gravado apenas executa ações sem verificação:
// GRAVADO (sem verificação)
app.buttons["Login"].tap()
// APRIMORADO (com asserção)
app.buttons["loginButton"].tap()
let welcomeLabel = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeLabel.waitForExistence(timeout: 10),
"A tela de boas-vindas deve aparecer após o login")
4. Use Consultas Mais Curtas
O código gravado pode ter consultas excessivamente específicas:
// GRAVADO (muito específico)
app.tables.cells.element(boundBy: 0).buttons["Action"].tap()
// APRIMORADO (mais simples)
app.buttons["actionButton"].tap()
Diretrizes para Seleção de Consultas
Da WWDC 2025-344:
| Cenário | Problema | Solução |
|---|---|---|
| Strings localizadas | "Login" muda por idioma | Use accessibilityIdentifier |
| Views profundamente aninhadas | Cadeias longas de consulta quebram facilmente | Use a consulta mais curta possível |
| Conteúdo dinâmico | O conteúdo da célula muda | Use identificador ou consulta genérica |
| Múltiplas correspondências | A consulta retorna muitos elementos | Adicione um identificador único |
Melhores Práticas
- Prefira identificadores a rótulos
- Use a consulta mais curta que funciona
- Evite consultas baseadas em índice (
element(boundBy: 0)) - Adicione identificadores ao conteúdo dinâmico
Fase 2: Reproduzindo com Planos de Teste
Planos de teste permitem executar os mesmos testes em múltiplas configurações.
Criando um Plano de Teste
- File → New → File → Test Plan
- Adicione destinos de teste
- Configure as configurações
Estrutura do Plano de Teste
{
"configurations": [
{
"name": "iPhone - Inglês",
"options": {
"targetForVariableExpansion": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyApp"
},
"language": "en",
"region": "US"
}
},
{
"name": "iPhone - Espanhol",
"options": {
"language": "es",
"region": "ES"
}
},
{
"name": "iPhone - Modo Escuro",
"options": {
"userInterfaceStyle": "dark"
}
},
{
"name": "iPad - Paisagem",
"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
}
Opções de Configuração
| Opção | Propósito |
|---|---|
language | Testar localização |
region | Testar formatação regional |
userInterfaceStyle | Testar modo escuro/claro |
targetForVariableExpansion | Destino do app para configuração |
testTimeoutsEnabled | Habilitar aplicação de timeout |
defaultTestExecutionTimeAllowance | Tempo limite em segundos |
Executando com Plano de Teste
# Linha de comando
xcodebuild test \
-scheme "MyApp" \
-testPlan "MyTestPlan" \
-destination "platform=iOS Simulator,name=iPhone 16" \
-resultBundlePath /tmp/results.xcresult
# No Xcode
# Product → Test Plan → Selecione seu plano
# Então Cmd+U para executar os testes
Fase 3: Revisando
Funcionalidades do Relatório de Teste
Após a conclusão dos testes:
- Veja os resultados dos testes no Navegador de Relatórios
- Assista às gravações de vídeo de cada teste
- Veja capturas de tela nos pontos de falha
- Analise a linha do tempo das ações
Habilitando Anexos
No plano de teste ou esquema:
"options": {
"systemAttachmentLifetime": "keepAlways",
"userAttachmentLifetime": "keepAlways"
}
Capturando Capturas de Tela Personalizadas
func testCheckout() {
// ... ações ...
// Captura de tela manual em um ponto específico
let screenshot = app.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.name = "Confirmação de Checkout"
attachment.lifetime = .keepAlways
add(attachment)
}
Padrões Comuns
Template de Fluxo de Login
func testLoginWithValidCredentials() throws {
let app = XCUIApplication()
app.launch()
// Navegar para o login
let showLoginButton = app.buttons["showLoginButton"]
XCTAssertTrue(showLoginButton.waitForExistence(timeout: 5))
showLoginButton.tap()
// Inserir credenciais
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 sucesso
let welcomeScreen = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeScreen.waitForExistence(timeout: 10))
}
Template de Fluxo de Navegação
func testNavigateToSettings() throws {
let app = XCUIApplication()
app.launch()
// Abrir item da barra de abas
app.tabBars.buttons["Settings"].tap()
// Verificar navegação
let settingsTitle = app.navigationBars["Settings"]
XCTAssertTrue(settingsTitle.waitForExistence(timeout: 5))
// Navegar mais fundo
app.tables.cells["Account"].tap()
XCTAssertTrue(app.navigationBars["Account"].exists)
}
Template de Validação de Formulário
func testFormValidation() throws {
let app = XCUIApplication()
app.launch()
// Enviar formulário vazio
app.buttons["submitButton"].tap()
// Verificar se o erro aparece
let errorAlert = app.alerts["Error"]
XCTAssertTrue(errorAlert.waitForExistence(timeout: 5))
XCTAssertTrue(errorAlert.staticTexts["Please fill all fields"].exists)
// Dispensar alerta
errorAlert.buttons["OK"].tap()
}
Solução de Problemas
A Gravação Não Inicia
- Certifique-se de estar em um método de teste
- Verifique se o simulador está disponível
- Confirme que o app compila e executa
- Tente reiniciar o Xcode
O Código Gravado Não Funciona
- Adicione waitForExistence antes das interações
- Verifique se os identificadores de acessibilidade estão definidos
- Simplifique as consultas para a forma mais curta
- Execute o app manualmente para verificar se o fluxo funciona
Testes Passam Localmente, Falham no CI
- Aumente os timeouts para máquinas de CI mais lentas
- Adicione esperas explícitas para animações
- Verifique se a configuração do simulador corresponde
- Desative animações na configuração do teste:
app.launchArguments = ["--disable-animations"]
Anti-Padrões
Não Use Código Gravado Bruto no CI
// RUIM - Código gravado bruto
app.buttons["Login"].tap()
app.textFields["Email"].typeText("[email protected]")
// BOM - Aprimorado para CI
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 10))
loginButton.tap()
Não Codifique Coordenadas
// RUIM - Coordenadas da gravação
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
// BOM - Use consultas de elemento
app.buttons["centerButton"].tap()
Não Pule Asserções
// RUIM - Apenas ações
app.buttons["Login"].tap()
sleep(2) // Espera que funcione
// BOM - Verifique 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