UIテスト
概要
条件を待機し、恣意的なタイムアウトは避けてください。核となる原則 フレーキーテストは、操作にかかる時間を推測することから発生します。条件ベースの待機が競合状態を排除します。
WWDC 2025の新機能: 記録UI自動化により、インタラクションを記録し、複数のデバイス/言語で再生し、テスト実行のビデオ録画を確認できます。
プロンプト例
以下は、開発者が実際に質問し、このスキルが回答するように設計された質問です。
1. 「UIテストがMacではローカルでパスするのに、CIでは失敗します。どうすれば信頼性を高められますか?」
→ このスキルは、デバイス/速度に関係なく動作する条件ベースの待機パターンを示し、CIのタイミング差異を排除します
2. 「テストでsleep(2)とsleep(5)を使っていますが、まだフレーキーです。恣意的なタイムアウトを実際の条件に置き換えるにはどうすればよいですか?」
→ このスキルは、データ読み込み、ネットワークリクエスト、アニメーションに対するwaitForExistence、XCTestExpectation、ポーリングパターンを説明します
3. 「Xcode 26の記録UI自動化を使ってテストを記録しました。ビデオを確認して失敗をデバッグするにはどうすればよいですか?」
→ このスキルは、録画を分析し、テストが失敗する正確なステップを見つけるためのビデオデバッグワークフローをカバーします
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()を使用する - 複雑な条件には述語を使用する
- 成功パスと失敗パスの両方をテストする
- テストを独立させる(任意の順序で実行可能)
テスト作成後
- テストをローカルで10回実行する(フレーキー性を検出)
- サポート対象の最も遅いデバイスでテストを実行する
- CI環境でテストを実行する
- テスト時間を確認する(1テストあたり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 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秒
実際の影響
Before(sleep()を使用):
- テストスイート: 15分(最悪のケースを待機)
- フレーキーテスト: 20%の失敗率
- CI障害: 50%が再試行を必要とする
After(条件ベースの待機):
- テストスイート: 5分(必要なときだけ待機)
- フレーキーテスト: <2%の失敗率
- CI障害: <5%が再試行を必要とする
重要な洞察 テストは、時間を推測する代わりに実際の条件を待機することで、より速く完了し、かつより信頼性が高くなります。
記録UI自動化
概要
Xcode 26の新機能: UI自動化テストをビデオ録画で記録、再生、レビュー。
3つのフェーズ:
- 記録 — インタラクション(タップ、スワイプ、ハードウェアボタン押下)をSwiftコードとしてキャプチャ
- 再生 — 複数のデバイス、言語、地域、向きで実行
- レビュー — ビデオ録画を視聴、失敗を分析、UI要素オーバーレイを表示
サポートプラットフォーム: iOS、iPadOS、macOS、watchOS、tvOS、axiom-visionOS(iPad用に設計)
UI自動化の仕組み
主要原則:
- UI自動化は、ジェスチャーとハードウェアイベントを使用して、人が行うようにアプリと対話します
- アプリから完全に独立して実行されます(アプリのモデル/データには直接アクセス不可)
- 基盤技術としてアクセシビリティフレームワークを使用します
- OSに実行するジェスチャーを指示し、同期的に1つずつ完了を待機します
アクションには以下が含まれます:
- アプリの起動
- ボタンやナビゲーションとの対話
- システム状態の設定(ダークモード、axiom-localizationなど)
- シミュレートされた位置情報の設定
アクセシビリティが基盤
重要な理解: アクセシビリティは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: アクセシビリティインスペクタでアクセシビリティを確認
アクセシビリティインスペクタの起動:
- Xcodeメニュー → 開発ツールを開く → アクセシビリティインスペクタ
- または: Spotlightから起動
機能:
- 要素インスペクタ — 任意のビューのアクセシビリティ値を一覧表示
- プロパティの詳細 — プロパティ名をクリックしてドキュメントを表示
- プラットフォームサポート — すべてのAppleプラットフォームで動作
確認すべきこと:
- 要素にラベルがある
- インタラクティブな要素にタイプがある(テキストだけでなくボタン)
- 状態を持つ要素(チェックボックス、トグル)に値が設定されている
- 動的/ローカライズされたコンテンツを持つ要素に識別子が設定されている
サンプルコード参照: 優れたアクセシビリティ体験の提供
ステップ3: UIテストターゲットの追加
- Xcodeでプロジェクト設定を開く
- ターゲットリストの下にある「+」をクリック
- UI Testing Bundleを選択
- 完了をクリック
結果: テンプレートテストを含む新しいUIテストフォルダがプロジェクトに追加されます
インタラクションの記録
記録の開始(Xcode 26)
- UIテストソースファイルを開く
- ポップオーバーが表示され、記録の開始方法を説明(初回のみ)
- エディタガターの**「記録開始」**ボタンをクリック
- Xcodeがアプリをビルドし、シミュレータ/デバイスで起動
記録中:
- アプリと通常通り対話(タップ、スワイプ、テキスト入力など)
- インタラクションを表すコードがソースエディタにリアルタイムで表示されます
- 入力(テキストフィールドへの入力など)に応じて記録が更新されます
記録の停止:
- Xcodeの**「実行停止」**ボタンをクリック
記録セッションの例
func testCreateAustralianCollection() {
let app = XCUIApplication()
app.launch()
// 「コレクション」タブをタップ(自動的に記録)
app.tabBars.buttons["Collections"].tap()
// 「+」をタップして新しいコレクションを追加
app.navigationBars.buttons["Add"].tap()
// 「編集」ボタンをタップ
app.buttons["Edit"].tap()
// コレクション名を入力
app.textFields.firstMatch.tap()
app.textFields.firstMatch.typeText("Max's Australian Adventure")
// 「ランドマークを編集」をタップ
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 // ✅ 汎用的、最短