Communitygithub.com

ComeOnOliver/skillshub

Use ao configurar a gravação de testes de UI no Xcode 26, aprimorar testes gravados para estabilidade ou configurar planos de teste para reprodução em múltiplas configurações. Baseado na WWDC 2025-344 "Record, replay, and review".

O que é skillshub?

Esta skill oferece um guia completo para a funcionalidade de Gravação de Automação de UI do Xcode 26, permitindo criar testes de UI através da gravação de interações do usuário no Simulador. Dividido em um fluxo de três fases — Gravar, Reproduzir e Revisar —, o guia mostra como capturar ações como toques, entrada de texto e gestos, transformando-os em código Swift. Além disso, fornece práticas essenciais para tornar o código gravado mais robusto, como adicionar identificadores de acessibilidade, esperas explícitas (waitForExistence) e asserções, evitando assim testes frágeis. A skill também aborda a configuração de planos de teste para executar os mesmos testes em diferentes dispositivos, idiomas e temas, e explica como revisar os resultados com vídeos e capturas de tela. Por fim, inclui templates de padrões comuns, dicas de solução de problemas e anti-padrões a serem evitados, sendo útil para desenvolvedores iOS que desejam criar testes de UI mais confiáveis e escaláveis.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Abra seu arquivo de teste de UI no Xcode
  2. Posicione o cursor dentro de um método de teste
  3. Debug → Record UI Automation (ou use o botão de gravação)
  4. O app é iniciado no Simulador
  5. Realize interações - O Xcode gera o código
  6. 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árioProblemaSolução
Strings localizadas"Login" muda por idiomaUse accessibilityIdentifier
Views profundamente aninhadasCadeias longas de consulta quebram facilmenteUse a consulta mais curta possível
Conteúdo dinâmicoO conteúdo da célula mudaUse identificador ou consulta genérica
Múltiplas correspondênciasA consulta retorna muitos elementosAdicione um identificador único

Melhores Práticas

  1. Prefira identificadores a rótulos
  2. Use a consulta mais curta que funciona
  3. Evite consultas baseadas em índice (element(boundBy: 0))
  4. 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

  1. File → New → File → Test Plan
  2. Adicione destinos de teste
  3. 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çãoPropósito
languageTestar localização
regionTestar formatação regional
userInterfaceStyleTestar modo escuro/claro
targetForVariableExpansionDestino do app para configuração
testTimeoutsEnabledHabilitar aplicação de timeout
defaultTestExecutionTimeAllowanceTempo 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:

  1. Veja os resultados dos testes no Navegador de Relatórios
  2. Assista às gravações de vídeo de cada teste
  3. Veja capturas de tela nos pontos de falha
  4. 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

  1. Certifique-se de estar em um método de teste
  2. Verifique se o simulador está disponível
  3. Confirme que o app compila e executa
  4. Tente reiniciar o Xcode

O Código Gravado Não Funciona

  1. Adicione waitForExistence antes das interações
  2. Verifique se os identificadores de acessibilidade estão definidos
  3. Simplifique as consultas para a forma mais curta
  4. Execute o app manualmente para verificar se o fluxo funciona

Testes Passam Localmente, Falham no CI

  1. Aumente os timeouts para máquinas de CI mais lentas
  2. Adicione esperas explícitas para animações
  3. Verifique se a configuração do simulador corresponde
  4. 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

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

Habilidades Relacionadas