Communitygithub.com

ComeOnOliver/skillshub

UI 테스트 작성, 상호작용 기록, 경쟁 상태, 타이밍 종속성, 일관되지 않은 통과/실패 동작, 또는 XCTest UI 테스트의 불안정성 문제 해결 시 사용합니다. 2025년 WWDC의 UI 자동화 기록, 조건 기반 대기, 네트워크 컨디셔닝, 다중 요소 테스트, 크래시 디버깅, 접근성 우선 테스트 패턴을 다룹니다.

skillshub란 무엇인가요?

이 스킬은 Apple 플랫폼(iOS, iPadOS, macOS, watchOS, tvOS, visionOS)에서 불안정한 XCTest UI 테스트를 근본적으로 해결하기 위한 조건 기반 대기 패턴과 최신 UI 자동화 기법을 제공합니다. 핵심 원칙은 `sleep()`과 같은 임의의 타임아웃을 사용하지 않고 `waitForExistence`, `XCTestExpectation`, NSPredicate를 활용하여 실제 조건이 충족될 때까지 기다리는 것입니다. 또한 Xcode 26의 새로운 UI 자동화 기록 기능을 활용하여 사용자 상호작용을 기록하고, 여러 기기/언어에서 재생하며, 비디오 리뷰를 통해 테스트 실패 지점을 정확히 분석하는 방법을 가르칩니다. 이 스킬은 테스트 스위트 실행 시간을 3배 단축시키고(예: 15분 -> 5분) 불안정한 테스트 비율을 20% 미만으로 낮추는 실질적인 효과를 제공하며, 접근성 식별자 사용, 애니메이션 처리, 네트워크 지연 대응 등 포괄적인 테스트 모범 사례를 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-ui-testing

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

UI 테스트

개요

임의의 타임아웃이 아닌 조건을 기다리세요. 핵심 원칙 불안정한 테스트는 작업이 얼마나 오래 걸릴지 추측하기 때문에 발생합니다. 조건 기반 대기는 경쟁 상태를 제거합니다.

WWDC 2025의 새로운 기능: Recording UI Automation을 사용하면 상호작용을 기록하고, 여러 기기/언어에서 재생하며, 테스트 실행 비디오를 검토할 수 있습니다.

예제 프롬프트

이 스킬이 답변하도록 설계된 실제 개발자 질문입니다.

1. "UI 테스트가 내 Mac에서는 통과하지만 CI에서는 실패합니다. 어떻게 더 안정적으로 만들 수 있나요?"

→ 이 스킬은 다양한 기기/속도에서 작동하여 CI 타이밍 차이를 제거하는 조건 기반 대기 패턴을 보여줍니다.

2. "제 테스트는 sleep(2)와 sleep(5)를 사용하지만 여전히 불안정합니다. 임의 타임아웃을 실제 조건으로 어떻게 바꾸나요?"

→ 이 스킬은 데이터 로드, 네트워크 요청, 애니메이션에 대한 waitForExistence, XCTestExpectation 및 폴링 패턴을 설명합니다.

3. "Xcode 26의 Recording UI Automation으로 테스트를 막 기록했습니다. 비디오를 검토하고 실패를 디버깅하려면 어떻게 해야 하나요?"

→ 이 스킬은 비디오 디버깅 워크플로우를 다루어 기록을 분석하고 테스트가 실패하는 정확한 단계를 찾는 방법을 알려줍니다.

4. "제 테스트는 iPad에서는 실패하지만 iPhone에서는 통과합니다. 모든 기기 크기에서 작동하는 테스트를 작성하려면 어떻게 해야 하나요?"

→ 이 스킬은 강력한 크로스 디바이스 테스트를 위한 다중 요소 테스트 전략과 기기 독립적 조건자를 설명합니다.

5. "불안정하지 않은 테스트를 작성하고 싶습니다. 제가 알아야 할 중요한 패턴은 무엇인가요?"

→ 이 스킬은 조건 기반 대기 템플릿, 접근성 우선 패턴, 안정적인 테스트 아키텍처를 위한 결정 트리를 제공합니다.


위험 신호 — 테스트 신뢰성 문제

다음 중 하나라도 보이면 타이밍 문제를 의심하세요:

  • 테스트가 로컬에서는 통과하지만 CI에서는 실패 (타이밍 차이)
  • 테스트가 때로는 통과하고 때로는 실패 (경쟁 상태)
  • 테스트가 sleep() 또는 Thread.sleep()을 사용 (임의 지연)
  • "UI 요소를 찾을 수 없음"으로 테스트가 실패했다가 재시도 시 통과
  • 긴 테스트 실행 시간 (최악의 시나리오 대기)

빠른 결정 트리

테스트 실패?
├─ 요소를 찾을 수 없음?
│  └─ sleep() 대신 waitForExistence(timeout:) 사용
├─ 로컬 통과, CI 실패?
│  └─ sleep()을 조건 폴링으로 교체
├─ 애니메이션이 문제를 일으킴?
│  └─ 애니메이션 완료를 기다리고, 비활성화하지 마세요
└─ 네트워크 요청 타이밍?
   └─ XCTestExpectation 또는 waitForExistence 사용

핵심 패턴: 조건 기반 대기

❌ 잘못된 방법 (임의 타임아웃):

func testButtonAppears() {
    app.buttons["Login"].tap()
    sleep(2)  // ❌ 2초가 걸릴 거라고 추측
    XCTAssertTrue(app.buttons["Dashboard"].exists)
}

✅ 올바른 방법 (조건 대기):

func testButtonAppears() {
    app.buttons["Login"].tap()
    let dashboard = app.buttons["Dashboard"]
    XCTAssertTrue(dashboard.waitForExistence(timeout: 5))
}

일반적인 UI 테스트 패턴

패턴 1: 요소 대기

// 요소가 나타날 때까지 대기
func waitForElement(_ element: XCUIElement, timeout: TimeInterval = 5) -> Bool {
    return element.waitForExistence(timeout: timeout)
}

// 사용법
XCTAssertTrue(waitForElement(app.buttons["Submit"]))

패턴 2: 요소 사라짐 대기

func waitForElementToDisappear(_ element: XCUIElement, timeout: TimeInterval = 5) -> Bool {
    let predicate = NSPredicate(format: "exists == false")
    let expectation = XCTNSPredicateExpectation(predicate: predicate, object: element)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    return result == .completed
}

// 사용법
XCTAssertTrue(waitForElementToDisappear(app.activityIndicators["Loading"]))

패턴 3: 특정 상태 대기

func waitForButton(_ button: XCUIElement, toBeEnabled enabled: Bool, timeout: TimeInterval = 5) -> Bool {
    let predicate = NSPredicate(format: "isEnabled == %@", NSNumber(value: enabled))
    let expectation = XCTNSPredicateExpectation(predicate: predicate, object: button)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    return result == .completed
}

// 사용법
let submitButton = app.buttons["Submit"]
XCTAssertTrue(waitForButton(submitButton, toBeEnabled: true))
submitButton.tap()

패턴 4: 접근성 식별자

앱에서 설정:

Button("Submit") {
    // 동작
}
.accessibilityIdentifier("submitButton")

테스트에서 사용:

func testSubmitButton() {
    let submitButton = app.buttons["submitButton"]  // 레이블이 아닌 식별자 사용
    XCTAssertTrue(submitButton.waitForExistence(timeout: 5))
    submitButton.tap()
}

이유: 접근성 식별자는 지역화에 따라 변경되지 않으며 UI 업데이트 전반에 걸쳐 안정적으로 유지됩니다.

패턴 5: 네트워크 요청 지연

func testDataLoads() {
    app.buttons["Refresh"].tap()

    // 로딩 표시기가 사라질 때까지 대기
    let loadingIndicator = app.activityIndicators["Loading"]
    XCTAssertTrue(waitForElementToDisappear(loadingIndicator, timeout: 10))

    // 이제 데이터가 로드되었는지 확인
    XCTAssertTrue(app.cells.count > 0)
}

패턴 6: 애니메이션 처리

func testAnimatedTransition() {
    app.buttons["Next"].tap()

    // 대상 뷰가 나타날 때까지 대기
    let destinationView = app.otherElements["DestinationView"]
    XCTAssertTrue(destinationView.waitForExistence(timeout: 2))

    // 선택 사항: 애니메이션이 안정될 때까지 약간 더 대기
    // 꼭 필요한 경우에만
    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.3))
}

테스트 체크리스트

테스트 작성 전

  • 모든 대화형 요소에 접근성 식별자 사용
  • 하드코딩된 레이블 사용하지 않기 (대신 식별자 사용)
  • 네트워크 지연 및 애니메이션 계획
  • 적절한 타임아웃 선택 (UI 2초, 네트워크 10초)

테스트 작성 시

  • sleep() 대신 waitForExistence() 사용
  • 복잡한 조건에는 NSPredicate 사용
  • 성공 및 실패 경로 모두 테스트
  • 테스트를 독립적으로 작성 (어떤 순서로든 실행 가능)

테스트 작성 후

  • 로컬에서 테스트 10회 실행 (불안정성 발견)
  • 가장 느린 지원 기기에서 테스트 실행
  • CI 환경에서 테스트 실행
  • 테스트 기간 확인 (테스트당 30초 초과 시 최적화)

Xcode UI 테스트 팁

테스트용 런치 인수

func testExample() {
    let app = XCUIApplication()
    app.launchArguments = ["UI-Testing"]
    app.launch()
}

앱 코드에서:

if ProcessInfo.processInfo.arguments.contains("UI-Testing") {
    // 모의 데이터 사용, 온보딩 건너뛰기 등
}

더 빠른 테스트 실행

override func setUpWithError() throws {
    continueAfterFailure = false  // 첫 번째 실패에서 중지
}

실패 테스트 디버깅

func testExample() {
    // 실패 시 스크린샷 촬영
    addUIInterruptionMonitor(withDescription: "Alert") { alert in
        alert.buttons["OK"].tap()
        return true
    }

    // 요소 계층 구조 출력
    print(app.debugDescription)
}

일반적인 실수

❌ 모든 것에 sleep() 사용

sleep(5)  // ❌ 작업이 1초 안에 완료되면 시간 낭비

❌ 애니메이션 처리하지 않음

app.buttons["Next"].tap()
XCTAssertTrue(app.buttons["Back"].exists)  // ❌ 애니메이션 중 실패 가능

❌ 하드코딩된 텍스트 레이블

app.buttons["Submit"].tap()  // ❌ 지역화와 함께 깨짐

❌ 테스트가 서로 의존

// ❌ 테스트 2는 테스트 1이 먼저 실행되었다고 가정
func test1_Login() { /* ... */ }
func test2_ViewDashboard() { /* 로그인 상태 가정 */ }

❌ 타임아웃 전략 없음

element.waitForExistence(timeout: 100)  // ❌ 너무 김
element.waitForExistence(timeout: 0.1)  // ❌ 너무 짧음

적절한 타임아웃 사용:

  • UI 애니메이션: 2-3초
  • 네트워크 요청: 10초
  • 복잡한 작업: 최대 30초

실제 효과

이전 (sleep() 사용):

  • 테스트 스위트: 15분 (최악의 경우 대기)
  • 불안정한 테스트: 20% 실패율
  • CI 실패: 50% 재시도 필요

이후 (조건 기반 대기):

  • 테스트 스위트: 5분 (필요할 때만 대기)
  • 불안정한 테스트: <2% 실패율
  • CI 실패: <5% 재시도 필요

핵심 인사이트 시간을 추측하는 대신 실제 조건을 기다리면 테스트가 더 빨리 완료되고 더 안정적입니다.


Recording UI Automation

개요

Xcode 26의 새로운 기능: 비디오 녹화와 함께 UI 자동화 테스트를 기록, 재생, 검토합니다.

세 가지 단계:

  1. 기록 — 상호작용(탭, 스와이프, 하드웨어 버튼 누름)을 Swift 코드로 캡처
  2. 재생 — 여러 기기, 언어, 지역, 방향에서 실행
  3. 검토 — 비디오 녹화 시청, 실패 분석, UI 요소 오버레이 보기

지원 플랫폼: iOS, iPadOS, macOS, watchOS, tvOS, visionOS (iPad용으로 설계됨)

UI 자동화 작동 방식

핵심 원칙:

  • UI 자동화는 사람처럼 제스처 및 하드웨어 이벤트를 사용하여 앱과 상호작용
  • 앱과 완전히 독립적으로 실행 (앱 모델/데이터에 직접 접근 불가)
  • 기본 기술로 접근성 프레임워크 사용
  • OS에 수행할 제스처를 알린 후 동기적으로 하나씩 완료를 기다림

수행 작업:

  • 앱 실행
  • 버튼 및 탐색과 상호작용
  • 시스템 상태 설정 (다크 모드, 지역화 등)
  • 시뮬레이션된 위치 설정

접근성이 기반입니다

중요한 이해: 접근성은 UI 자동화에 직접 정보를 제공합니다.

접근성이 보는 것:

  • 요소 유형 (버튼, 텍스트, 이미지 등)
  • 레이블 (표시 텍스트)
  • 값 (체크박스 등의 현재 상태)
  • 프레임 (요소 위치)
  • 식별자 (접근성 식별자 — 지역화되지 않음)

모범 사례: 훌륭한 접근성 경험 = 훌륭한 UI 자동화 경험

기록을 위한 앱 준비

1단계: 접근성 식별자 추가

SwiftUI:

Button("Submit") {
    // 동작
}
.accessibilityIdentifier("submitButton")

// 인스턴스별로 식별자 지정
List(landmarks) { landmark in
    LandmarkRow(landmark)
        .accessibilityIdentifier("landmark-\(landmark.id)")
}

UIKit:

let button = UIButton()
button.accessibilityIdentifier = "submitButton"

// 테이블 셀에 인덱스 사용
cell.accessibilityIdentifier = "cell-\(indexPath.row)"

좋은 식별자의 조건:

  • ✅ 전체 앱 내에서 고유
  • ✅ 요소 내용을 설명적
  • ✅ 정적 (콘텐츠 변경에 반응하지 않음)
  • ✅ 지역화되지 않음 (모든 언어에서 동일)

식별자가 중요한 이유:

  • 제목/설명은 변경될 수 있지만 식별자는 안정적으로 유지
  • 지역화된 문자열에서도 작동
  • 동적 콘텐츠가 있는 요소를 고유하게 식별

프로 팁: Xcode 코딩 어시스턴트를 사용하여 식별자 추가:

프롬프트: "이 뷰의 관련 부분에 접근성 식별자를 추가하세요"

2단계: Accessibility Inspector로 접근성 검토

Accessibility Inspector 실행:

  • Xcode 메뉴 → Open Developer Tool → Accessibility Inspector
  • 또는: Spotlight에서 실행

기능:

  1. 요소 검사기 — 모든 뷰의 접근성 값 나열
  2. 속성 세부 정보 — 속성 이름을 클릭하면 문서 표시
  3. 플랫폼 지원 — 모든 Apple 플랫폼에서 작동

확인할 사항:

  • 요소에 레이블이 있음
  • 대화형 요소에 유형이 있음 (텍스트만이 아닌 버튼)
  • 상태를 가진 요소(체크박스, 토글)에 값이 설정됨
  • 동적/지역화된 콘텐츠가 있는 요소에 식별자가 설정됨

샘플 코드 참조: 탁월한 접근성 경험 제공

3단계: UI 테스트 타겟 추가

  1. Xcode에서 프로젝트 설정 열기
  2. 타겟 목록 아래 "+" 클릭
  3. UI Testing Bundle 선택
  4. 완료 클릭

결과: 프로젝트에 템플릿 테스트가 포함된 새 UI 테스트 폴더 추가됨

상호작용 기록

기록 시작 (Xcode 26)

  1. UI 테스트 소스 파일 열기
  2. 팝오버가 기록 시작 방법 설명 (처음 한 번만)
  3. 편집기 거터의 "Start Recording" 버튼 클릭
  4. Xcode가 시뮬레이터/기기에서 앱 빌드 및 실행

기록 중:

  • 앱과 정상적으로 상호작용 (탭, 스와이프, 텍스트 입력 등)
  • 상호작용을 나타내는 코드가 실시간으로 소스 편집기에 나타남
  • 입력 시 기록 업데이트 (예: 텍스트 필드 입력)

기록 중지:

  • Xcode에서 "Stop Run" 버튼 클릭

기록 세션 예시

func testCreateAustralianCollection() {
    let app = XCUIApplication()
    app.launch()

    // "Collections" 탭 탭 (자동 기록됨)
    app.tabBars.buttons["Collections"].tap()

    // 새 컬렉션 추가를 위해 "+" 탭
    app.navigationBars.buttons["Add"].tap()

    // "Edit" 버튼 탭
    app.buttons["Edit"].tap()

    // 컬렉션 이름 입력
    app.textFields.firstMatch.tap()
    app.textFields.firstMatch.typeText("Max's Australian Adventure")

    // "Edit Landmarks" 탭
    app.buttons["Edit Landmarks"].tap()

    // 랜드마크 추가
    app.tables.cells.containing(.staticText, identifier:"Great Barrier Reef").buttons["Add"].tap()
    app.tables.cells.containing(.staticText, identifier:"Uluru").buttons["Add"].tap()

    // 저장을 위해 체크마크 탭
    app.navigationBars.buttons["Done"].tap()
}

기록된 코드 검토

기록 후 쿼리를 검토하고 조정하세요:

여러 옵션: 각 줄에는 요소를 참조하는 대체 방법을 보여주는 드롭다운이 있습니다.

선택 권장 사항:

  1. 지역화된 문자열의 경우 (텍스트, 버튼 레이블): 가능하면 접근성 식별자 선택
  2. 깊이 중첩된 뷰의 경우: 가장 짧은 쿼리 선택 (앱이 변경되어도 복원력 유지)
  3. 동적 콘텐츠의 경우 (타임스탬프, 온도): 일반 쿼리 또는 식별자 사용

예시:

// 텍스트 필드의 기록된 옵션:
app.textFields["Collection Name"]              // ❌ 레이블이 지역화되면 깨짐
app.textFields["collectionNameField"]          // ✅ 식별자 사용
app.textFields.element(boundBy: 0)             // ✅ 위치 기반
app.textFields.firstMatch                      // ✅ 일반적, 가장 짧음

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

관련 스킬