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 자동화 테스트를 기록, 재생, 검토합니다.
세 가지 단계:
- 기록 — 상호작용(탭, 스와이프, 하드웨어 버튼 누름)을 Swift 코드로 캡처
- 재생 — 여러 기기, 언어, 지역, 방향에서 실행
- 검토 — 비디오 녹화 시청, 실패 분석, 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에서 실행
기능:
- 요소 검사기 — 모든 뷰의 접근성 값 나열
- 속성 세부 정보 — 속성 이름을 클릭하면 문서 표시
- 플랫폼 지원 — 모든 Apple 플랫폼에서 작동
확인할 사항:
- 요소에 레이블이 있음
- 대화형 요소에 유형이 있음 (텍스트만이 아닌 버튼)
- 상태를 가진 요소(체크박스, 토글)에 값이 설정됨
- 동적/지역화된 콘텐츠가 있는 요소에 식별자가 설정됨
샘플 코드 참조: 탁월한 접근성 경험 제공
3단계: UI 테스트 타겟 추가
- Xcode에서 프로젝트 설정 열기
- 타겟 목록 아래 "+" 클릭
- UI Testing Bundle 선택
- 완료 클릭
결과: 프로젝트에 템플릿 테스트가 포함된 새 UI 테스트 폴더 추가됨
상호작용 기록
기록 시작 (Xcode 26)
- UI 테스트 소스 파일 열기
- 팝오버가 기록 시작 방법 설명 (처음 한 번만)
- 편집기 거터의 "Start Recording" 버튼 클릭
- 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()
}
기록된 코드 검토
기록 후 쿼리를 검토하고 조정하세요:
여러 옵션: 각 줄에는 요소를 참조하는 대체 방법을 보여주는 드롭다운이 있습니다.
선택 권장 사항:
- 지역화된 문자열의 경우 (텍스트, 버튼 레이블): 가능하면 접근성 식별자 선택
- 깊이 중첩된 뷰의 경우: 가장 짧은 쿼리 선택 (앱이 변경되어도 복원력 유지)
- 동적 콘텐츠의 경우 (타임스탬프, 온도): 일반 쿼리 또는 식별자 사용
예시:
// 텍스트 필드의 기록된 옵션:
app.textFields["Collection Name"] // ❌ 레이블이 지역화되면 깨짐
app.textFields["collectionNameField"] // ✅ 식별자 사용
app.textFields.element(boundBy: 0) // ✅ 위치 기반
app.textFields.firstMatch // ✅ 일반적, 가장 짧음