Recording UI Automation (Xcode 26+)
Xcode 26 の Recording UI Automation 機能のガイドです。ユーザー操作の録画を通じて UI テストを作成します。
3つのフェーズからなるワークフロー
WWDC 2025-344 より:
┌─────────────────────────────────────────────────────────────┐
│ UI Automation ワークフロー │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. 録画 (RECORD) ────► シミュレーターでアプリを操作 │
│ Xcode が Swift テストコードとしてキャプチャ│
│ │
│ 2. リプレイ (REPLAY) ───► デバイス、言語、構成をまたいで実行 │
│ テスト計画を使用したマルチ構成 │
│ │
│ 3. レビュー (REVIEW) ──► テストレポートでビデオ録画を確認 │
│ スクリーンショットで障害を分析 │
│ │
└─────────────────────────────────────────────────────────────┘
フェーズ1: 録画
録画の開始
- Xcode で UI テストファイルを開く
- カーソルをテストメソッド内に配置する
- デバッグ → UI Automation を録画(または録画ボタンを使用)
- アプリがシミュレーターで起動する
- 操作を実行 – Xcode がコードを生成する
- 完了したら録画を停止する
録画されるもの
- タップ: ボタン、セル、コントロール
- テキスト入力: テキストフィールド
- スワイプとスクロール
- ジェスチャー: ピンチ、ローテート
- ハードウェアボタン操作: Home、音量
生成されるコード例
// Xcode が操作からこのコードを生成
func testLoginFlow() {
let app = XCUIApplication()
app.launch()
// 録画: メールフィールドをタップ、メールを入力
app.textFields["Email"].tap()
app.textFields["Email"].typeText("[email protected]")
// 録画: パスワードフィールドをタップ、パスワードを入力
app.secureTextFields["Password"].tap()
app.secureTextFields["Password"].typeText("password123")
// 録画: ログインボタンをタップ
app.buttons["Login"].tap()
}
録画されたコードの強化
重要: 録画されたコードは多くの場合脆弱です。安定性を高めるために必ず強化してください。
1. アクセシビリティ識別子を追加する
録画コードはラベルを使用するため、ローカライズで壊れます:
// 録画されたコード(脆弱 – ローカライズで壊れる)
app.buttons["Login"].tap()
// 強化されたコード(安定 – 識別子を使用)
app.buttons["loginButton"].tap()
アプリコードに識別子を追加:
// SwiftUI
Button("ログイン") { ... }
.accessibilityIdentifier("loginButton")
// UIKit
loginButton.accessibilityIdentifier = "loginButton"
2. waitForExistence を追加する
録画コードは要素がすぐに存在することを前提としています:
// 録画されたコード(アプリが遅いと失敗する可能性あり)
app.buttons["Login"].tap()
// 強化されたコード(要素を待機)
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
loginButton.tap()
3. アサーションを追加する
録画コードはアクションのみを実行し、検証は行いません:
// 録画されたコード(検証なし)
app.buttons["Login"].tap()
// 強化されたコード(アサーションあり)
app.buttons["loginButton"].tap()
let welcomeLabel = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeLabel.waitForExistence(timeout: 10),
"ログイン後、ウェルカム画面が表示される必要があります")
4. 短いクエリを使用する
録画コードは過度に具体的なクエリを使う場合があります:
// 録画されたコード(詳細すぎる)
app.tables.cells.element(boundBy: 0).buttons["Action"].tap()
// 強化されたコード(よりシンプル)
app.buttons["actionButton"].tap()
クエリ選択のガイドライン
WWDC 2025-344 より:
| シナリオ | 問題 | 解決策 |
|---|---|---|
| ローカライズされた文字列 | "Login" が言語によって変わる | accessibilityIdentifier を使用する |
| 深くネストしたビュー | 長いクエリチェーンは壊れやすい | 可能な限り短いクエリを使用する |
| 動的コンテンツ | セルの内容が変わる | 識別子または汎用クエリを使用する |
| 複数のマッチ | クエリが多くの要素を返す | 一意の識別子を追加する |
ベストプラクティス
- ラベルよりも識別子を優先する
- 動作する最短のクエリを使用する
- インデックスベースのクエリを避ける(
element(boundBy: 0)) - 動的コンテンツに識別子を追加する
フェーズ2: テスト計画によるリプレイ
テスト計画を使用すると、同じテストを複数の構成で実行できます。
テスト計画の作成
- ファイル → 新規 → ファイル → テスト計画
- テストターゲットを追加する
- 構成を設定する
テスト計画の構造
{
"configurations": [
{
"name": "iPhone - English",
"options": {
"targetForVariableExpansion": {
"containerPath": "container:MyApp.xcodeproj",
"identifier": "MyApp"
},
"language": "en",
"region": "US"
}
},
{
"name": "iPhone - Spanish",
"options": {
"language": "es",
"region": "ES"
}
},
{
"name": "iPhone - ダークモード",
"options": {
"userInterfaceStyle": "dark"
}
},
{
"name": "iPad - ランドスケープ",
"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
}
構成オプション
| オプション | 目的 |
|---|---|
language | ローカライゼーションのテスト |
region | 地域の書式設定のテスト |
userInterfaceStyle | ダーク/ライトモードのテスト |
targetForVariableExpansion | 構成のためのアプリターゲット |
testTimeoutsEnabled | タイムアウト強制の有効化 |
defaultTestExecutionTimeAllowance | タイムアウト(秒) |
テスト計画の実行
# コマンドライン
xcodebuild test \
-scheme "MyApp" \
-testPlan "MyTestPlan" \
-destination "platform=iOS Simulator,name=iPhone 16" \
-resultBundlePath /tmp/results.xcresult
# Xcode 内
# プロダクト → テスト計画 → 計画を選択
# その後 Cmd+U でテストを実行
フェーズ3: レビュー
テストレポートの機能
テスト完了後:
- テスト結果を表示(レポートナビゲーター)
- 各テストのビデオ録画を視聴
- 障害ポイントのスクリーンショットを確認
- アクションのタイムラインを分析
アタッチメントの有効化
テスト計画またはスキーム内:
"options": {
"systemAttachmentLifetime": "keepAlways",
"userAttachmentLifetime": "keepAlways"
}
カスタムスクリーンショットの取得
func testCheckout() {
// ... アクション ...
// 特定のポイントで手動スクリーンショット
let screenshot = app.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.name = "チェックアウト確認"
attachment.lifetime = .keepAlways
add(attachment)
}
共通パターン
ログインフローのテンプレート
func testLoginWithValidCredentials() throws {
let app = XCUIApplication()
app.launch()
// ログイン画面へ移動
let showLoginButton = app.buttons["showLoginButton"]
XCTAssertTrue(showLoginButton.waitForExistence(timeout: 5))
showLoginButton.tap()
// 認証情報を入力
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")
// 送信
app.buttons["loginButton"].tap()
// 成功を確認
let welcomeScreen = app.staticTexts["welcomeLabel"]
XCTAssertTrue(welcomeScreen.waitForExistence(timeout: 10))
}
ナビゲーションフローのテンプレート
func testNavigateToSettings() throws {
let app = XCUIApplication()
app.launch()
// タブバーアイテムを開く
app.tabBars.buttons["設定"].tap()
// ナビゲーションを確認
let settingsTitle = app.navigationBars["設定"]
XCTAssertTrue(settingsTitle.waitForExistence(timeout: 5))
// さらに深く移動
app.tables.cells["アカウント"].tap()
XCTAssertTrue(app.navigationBars["アカウント"].exists)
}
フォームバリデーションのテンプレート
func testFormValidation() throws {
let app = XCUIApplication()
app.launch()
// 空のフォームを送信
app.buttons["submitButton"].tap()
// エラーが表示されることを確認
let errorAlert = app.alerts["エラー"]
XCTAssertTrue(errorAlert.waitForExistence(timeout: 5))
XCTAssertTrue(errorAlert.staticTexts["すべての項目を入力してください"].exists)
// アラートを閉じる
errorAlert.buttons["OK"].tap()
}
トラブルシューティング
録画が開始しない
- テストメソッド内にいることを確認する
- シミュレーターが利用可能か確認する
- アプリがビルドおよび実行されることを確認する
- Xcode を再起動してみる
録画されたコードが動作しない
- インタラクションの前に waitForExistence を追加する
- アクセシビリティ識別子が設定されているか確認する
- クエリを最短の形式に簡略化する
- アプリを手動で実行してフローが動作するか確認する
ローカルではテストが成功するが、CI で失敗する
- 低速な CI マシン向けに タイムアウトを増やす
- アニメーション用に 明示的な待機を追加する
- シミュレーター構成が一致するか確認する
- テストセットアップで アニメーションを無効にする:
app.launchArguments = ["--disable-animations"]
アンチパターン
CI で生の録画コードを使用しない
// 悪い例 – 生の録画コード
app.buttons["Login"].tap()
app.textFields["Email"].typeText("[email protected]")
// 良い例 – CI 向けに強化
let loginButton = app.buttons["loginButton"]
XCTAssertTrue(loginButton.waitForExistence(timeout: 10))
loginButton.tap()
座標をハードコードしない
// 悪い例 – 録画からの座標
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
// 良い例 – 要素クエリを使用
app.buttons["centerButton"].tap()
アサーションをスキップしない
// 悪い例 – アクションのみ
app.buttons["Login"].tap()
sleep(2) // うまくいくことを期待
// 良い例 – 結果を確認
app.buttons["loginButton"].tap()
XCTAssertTrue(app.staticTexts["ようこそ"].waitForExistence(timeout: 10))
リソース
WWDC: 2025-344, 2024-10206, 2019-413
ドキュメント: /xcode/testing/recording-ui-tests, /xctest/xcuiapplication
スキル: axiom-xctest-automation, axiom-ui-testing