記録、再生、レビュー：Xcodeを使用したUI自動化

記録、再生、レビュー：Xcodeを使用したUI自動化

Xcodeで、XCUIAutomationテストの記録、実行、保守を行う方法を学びましょう。テストプランの構成を使用して、多数のロケール、デバイスタイプ、システム環境でXCTest UIテストを再生する方法や、Xcodeのテストレポートでテスト結果をレビューし、実行時のスクリーンショットやビデオをダウンロードする方法を確認します。また、アクセシビリティの導入と安定した高品質な自動化コードの記述を通じて、自動化に向けたアプリの準備を行うためのベストプラクティスについても説明します。

関連する章
- 0:00 - イントロダクションとアジェンダ
- 3:58 - UI自動化の概要
- 6:26 - 自動化に向けたアプリの準備
- 11:32 - インタラクションの記録
- 17:30 - 複数の構成での再生
- 20:54 - ビデオと結果のレビュー
- 24:16 - 次のステップ
リソース
関連ビデオ

WWDC24
- Swift Testingについて
WWDC23
WWDC22
- Xcode Cloud用の高速で信頼性の高いテストを作成する
WWDC21
- SwiftUIのアクセシビリティ: 基礎を超えて
こんにちは Maxです Xcodeチームのエンジニアです Xcodeには非常に多くの素晴らしい機能と体験があります圧倒されるほどです例えば様々なデバイス言語構成におけるアプリの実行状況をワンクリックで確認できることをご存知でしたかさらにアプリの実行ごとに優れた品質のビデオを録画することもできますこれらはすべて XcodeのUI自動化のパワーを活用して実現できますその仕組みを見てみましょう最初にUI自動化の概要について説明します次にアプリを準備して操作を自動化コードとして記録し複数のデバイスや言語で自動化を再生しますそして最後に結果のビデオ録画を見て各実行が成功したか失敗したかに関するレポートを確認します
まず UI自動化の仕組みの概要を説明します
Xcodeには Swift TestingとXCTestの 2つのテストフレームワークがありますどちらのフレームワークでも様々な構成でアプリとソースコードをすばやくテストできます
XCTestをインポートすると XCUIAutomationというフレームワークが自動的に組み込まれます XCUIAutomationを使用するとアプリを自動化でき人間が行うようにアプリを操作できますこれらのフレームワークが連携することで包括的なアプリテストスイートが実現します個人的には非常に素晴らしいことだと思います包括的なアプリテストスイートは通常単体テストとUI自動化テストの両方で構成されます単体テストではアプリのロジックとモデルをテストし Swiftテストによってユーザーインターフェイスを持たないフレームワークやSwiftパッケージ上でテストを実施できます一方 UI自動化テストではアプリのユーザー体験や Appleハードウェアとの統合一般的なワークフローの動作を検証します
一般にテストスイートでは UIテストよりも単体テストの割合が多くデベロッパはコード全体をカバーすることを目指しますしかし UI自動化テストではアプリの外観や動作オペレーティングシステムの他の部分との統合を確認できますこれを実施することには非常に多くのメリットがあります
例えばタップスワイプなどのジェスチャーやクリックにより人間と同じようにアプリをテストできます VoiceOver Voice Control ダイナミックタイプなどの支援技術を使用する人々がアプリをどのように受け止めるかを理解することができます
アプリがサポートするすべての言語や地域でのアプリの実行状態を確認でき長い文字列を使用する言語や右から左に書く言語などアプリの外観に大きく影響する言語に焦点を当てることができますアプリとAppleハードウェアの機能との統合つまりアクションボタンカメラボタン Apple TV Remote Apple WatchのDigital Crownなどの機能との統合をテストできます最後にアプリの起動性能をテストできますこれはアプリをどれだけすばやく使い始めることができるかを理解するための重要な指標です UI自動化のワークフローを設定する 3つの重要なフェーズとして記録再生レビューがあります
まずタップやスワイプハードウェアボタンの押下などの操作を記録しますすると Xcodeが自動的にそれらをコードとして記述します次にデバイス上とXcode Cloud内の両方について複数のデバイス言語地域デバイスの向きでインタラクションを再生します最後にそれらすべての構成でアプリの実行のビデオと結果を参照してどれが成功しどれが失敗したかを確認します UI自動化はすべてのAppleプラットフォーム iOS iPadOS macOS watchOS tvOS visionOS（iPad向け）でサポートされ同じ自動化を複数のプラットフォームで実行することもできますしたがって一度自動化を構築したらすべてのサポート対象デバイスで実行できますつまりワンクリックでコードを変更する必要なく Mac iPhone Vision Proでアプリの実行を確認できます UI自動化の仕組みを簡単に説明します UI自動化はジェスチャーやハードウェアイベントを使用して人間と同じようにアプリを操作します自動化はアプリから完全に独立して実行されるためアプリのモデルやデータに直接アクセスすることはできません
UI自動化は実行するジェスチャーをオペレーティングシステムに伝え同期的に待機して一度に1つずつジェスチャーを完了させます
これらのアクションにはアプリの起動ボタンやナビゲーションの操作ダークモードなどのシステム状態の設定が含まれ必要に応じてデバイスに対して場所をシミュレートすることもできますアクセシビリティはAppleの基本的な価値の1つです Appleの支援技術は身体的視覚的聴覚的運動的な障がいの有無に関係なく誰もがアプリを使えるようにサポートします Appleはこれらの技術のほとんどがデベロッパによる作業の必要なくアプリにおいてデフォルトで機能するように懸命に取り組んでいますとはいえサポートを追加することでアプリの体験が豊かになりより簡単に自動化できます重要なことはアクセシビリティが UI自動化の基盤となるフレームワークであることですアクセシビリティ体験が優れていれば UI自動化体験も優れたものになりますアクセシビリティは要素の種類ラベル値フレームなどの情報を UI自動化に直接提供しますがアクセシビリティで把握できるものが人間が把握できるものと1対1で対応している必要はありません例を見てみましょうこの画面ではボタンがUIに表示されていますがアクセシビリティはそれ以上の情報を把握しますアクセシビリティは要素の種類とラベルを把握してそれらをUI自動化に公開しさらに identifierプロパティも公開しますアクセシビリティの識別子を使用すると画面上の任意の要素をその周囲にあるすべての要素との関係で一意に記述できます識別子はローカライズの対象ではないのでどの言語またはデバイスでも識別子を使用して同じUI要素を参照できます
チェックボックスなどのステートフル要素の場合 valueプロパティを使用できますこれによりアクセシビリティとUI自動化の両方で要素の現在の状態を把握できます
アクセシビリティの詳細については WWDC23の「Build accessible apps with SwiftUI and UIKit」や WWDC21の「SwiftUI Accessibility: Beyond the basics」をご確認ください
UI自動化とアクセシビリティの連携について説明したのでアプリの自動化を準備しましょう
最初にアクセシビリティ識別子を追加します次にアプリのアクセシビリティについて簡単に確認し最後に新しいUIテストターゲットを追加しインタラクションをコードとして記録する準備を整えますその前にアプリはUI自動化とUIの記録をすでにサポートしていてデベロッパによる作業の必要なくすぐに使用できることを指摘しておきますこれから説明する手順の実施は必須ではありませんが実施することでより適切でより質の高い結果につながる可能性がありますアクセシビリティ識別子の追加は SwiftUI UIKit AppKitで記述されたビューコードで行うことができますアクセシビリティ識別子は自動化するアプリ内の任意の要素を一意に識別する最善の方法ですアクセシビリティ識別子はローカライズ対象の文字列または動的なコンテンツを含む要素に追加することをお勧めしますこれには任意のデータモデル内で取得されるコンテンツやインターネットからダウンロードされるコンテンツが含まれます
適切な識別子はアプリ全体で一意でありそれらが設定されている要素の詳細を適切に記述し静的でありコンテンツの変化に影響されないものです
タイトルや説明は変化する場合がありますが適切な識別子はそれが付与されている要素のコンテンツを常に記述しますこれにより私の素敵なランドマークを永遠に残すことができます
SwiftUIでは accessibilityIdentifier 修飾子を任意のUI要素に追加できますこれはビューやその親ビューがアクセシビリティから把握できる状態にある限り認識されます
特にアプリで何度も使用されるビューの場合識別子をビューのインスタンスに固有なものにすることをお勧めしますこの例ではランドマークの idプロパティを使用して各インスタンスに対して識別子を一意にしています
UIKitではアクセシビリティ要素である任意のUIViewに対して accessibilityIdentifierプロパティを設定できますコントロールテキスト画像などのほとんどのUIビューはデフォルトでアクセシビリティ要素であり通常特別な作業は不要です
accessibilityLabelや accessibilityTraits accessibilityValueなどのプロパティは VoiceOverなどの支援技術に利用でき UI自動化でも利用できます
ただし accessibilityIdentifier プロパティは VoiceOverで読み上げることができずまたアプリを使用するユーザーに公開されることもありませんそのため表のセルのインデックスや画像のシンボル名など自動化にのみ役立つ情報を提供するのに便利です Xcodeのコーディングアシスタントを使ってアクセシビリティ識別子を追加することもできます例えばアクセシビリティ識別子をこのビューの適切な部分に追加するように指示するとこのようになりますコーディングアシスタントはランドマークの idプロパティの使い方さえ知っていて各識別子を完全に一意にしてくれますとても便利ですね UIの記録を開始する前にアプリ全体でのアクセシビリティの動作を確認することをお勧めしますこれは歯医者に行く前にデンタルフロスで歯をきれいにするようなものですどれだけうまくやっているかをすぐに知ることになりますこれにより有用な情報を得ることができます Xcodeには Accessibility Inspector というアプリが付属しておりこれを使ってアクセシビリティの問題を検出診断修正できますこのアプリはXcodeトップレベルメニューの「Open Developer Tool」から起動できます Spotlightから起動することもできます
Accessibility Inspectorでは任意のプラットフォーム上でアプリ内の任意のビューに関するアクセシビリティ値を一覧表示できます確認するプラットフォームを選択してから要素インスペクタをクリックしそのプラットフォーム上で確認したいUI要素を操作します要素プロパティの一覧が表示されますセクションにあるプロパティなどいくつかのプロパティは UI自動化に非常に役立ちますビューに情報が欠けている場合はアプリのソースコードを変更して追加するとよいでしょう各プロパティの詳細を確認するにはプロパティ名をクリックしますポップオーバーには設定されるプロパティが表示され関連する情報も提供されます
アクセシビリティ機能の詳細についてはサンプルコードプロジェクトの「Delivering an exceptional accessibility experience」をご覧くださいこのプロジェクトでは様々なアクセシビリティ機能を使用し UIの自動化に適しているアプリの優れたサンプルコードを提供していますまた「Performing accessibility testing for your app」の記事を確認し様々な支援技術を使ってアプリのアクセシビリティを確認する方法について理解を深めてください自動化を開始する準備ができたら新しいUIテストターゲットを追加して自動化コードを配置する場所を設定する必要があります
Xcodeのプロジェクト設定ビューでターゲットリストの下にあるボタンを使用して新しいターゲットを追加します
次にポップオーバーからを選択します
をクリックすると新しい UIテストフォルダとテンプレートがプロジェクトに追加されますテンプレートには作業を開始するのに役立つ簡単なテストがいくつかありますこれでインタラクションをSwiftコードとして記録する準備が整いましたこのためにiOSシミュレータと Xcodeを使用しましょう数年前私の母と妹は私を置いてオーストラリアへの 1か月の旅行に出かけました一緒に行くことができず私は大変がっかりしました幸い私にはそのためのアプリがあります今年のWWDCの Landmarksサンプルプロジェクトを使用して私自身の休暇を計画してみます旅行を計画するインタラクションをいくつか記録するのでアプリの今後のバージョンでワークフローが中断するのを避けることができます UIテストのソースファイルを初めて開いたときポップオーバーが表示され UIの記録を開始する方法が示されます次にサイドバーのボタンを使用して UIの記録を開始します Xcodeがアプリを自動的にビルドしシミュレータでアプリを再起動します
アプリが起動したのでビューに進みます
アプリを操作するとインタラクションを表すコードがソースエディタに記録されますボタンをタップして新しいコレクションを追加しオーストラリアへの私自身の旅行を計画し始めます次にボタンをタップして旅行の名前を変更します旅行の名前を「Max’s Australian Adventure」に変更します
入力に合わせて Xcodeは私のテストを最新の状態に保ちます
ランドマークのコレクションを編集します
グレートバリアリーフやウルルなどのオーストラリアのランドマークを追加してチェックマークをタップするだけです
ビューに戻るとオーストラリアのランドマークを含むコレクションが追加されたことを確認できます
UIの記録を停止するには Xcodeのボタンを押します記録を終了したら想定した自動化が得られたことを確認するためにいくつかの作業を行う必要がありますまず記録されたコードを確認します次に XCTest APIを使用する検証を追加しアプリが期待どおりに動作していることを確認します最後に他の自動化APIについて確認しテストをさらに強力なものにします
記録されたUIクエリを確認し調整が必要かどうか調べましょう記録されたコードの各行には各UI要素に対処するための複数のオプションがありどれを選択するかは目標によって異なりますソースコードの各行のドロップダウンをクリックすると選択肢が表示されます
簡単に言うと適切なものを選択すればそれだけ早くオーストラリア行きの便に乗ることができます
選択する際に役立ついくつかの推奨事項があります
テキスト要素やボタンなどローカライズ対象の文字列を含むビューの場合はアクセシビリティ識別子があればそれを選択することをお勧めします UIの記録では識別子が存在する場合デフォルトでその識別子の使用を試みます
スクロールビューのテキストのように深くネストしたビューの場合はできるだけ短いクエリを選択することをお勧めしますこれによりアプリの変更に応じて自動化を容易に調整できます
最後にインターネットからダウンロードするコンテンツまたはタイムスタンプや温度など頻繁に変化するコンテンツなどの動的コンテンツの場合より汎用的なクエリか存在する場合はアクセシビリティ識別子を使用することをお勧めします
この例では識別子や文字列を使用しておらず常に最初のテキストを参照しています
では選択を行ってみます編集したいソースコードの行をクリックしてオプションを表示しますこれらのクエリはどれも操作した要素を一意に特定するため不適切な選択肢はありません今後のためにこのUIへの参照をどのように保存するかを単に選択するだけですここでは textFields.firstMatch オプションを選択しテスト内でテキストフィールドがその名称に関係なく確実に参照されるようにしますドロップダウンをダブルクリックすると結果がソースコードに保存されますでは自動化を簡単に再実行して操作が正しく記録されているか確認しましょうテストのひし形をクリックして実行しますこれはアプリをテストするものであり忍耐力を試されることはありません自動化の再生は非常に高速に実行されます
コレクションが正しい名前ですぐに作成され場所が追加され
自動化がうまく機能しました素晴らしいですね 19時間のフライトよりもずっと高速です今度はコードに検証を追加して想定した動作をするか確認しますこの例ではグレートバリアリーフのランドマークがコレクションに追加されたことを確認します
waitForExistenceなどのメソッドを呼び出して自動化を待機させ特定の要素が表示されてから次に進ませますより汎用的なメソッド wait(for:toEqual:)を呼び出して XCUIElement上のプロパティが想定した結果と一致することを検証することもできます
これら両方のメソッドをXCTestの XCTAssert文と組み合わせてこれらのメソッドがfalseを返す場合にテストが失敗したと判断できます
さて私のコードに戻りコレクションの名前に対して waitForExistenceを追加し以降の実行時に常にそれを有効にしましょう
次にコードをより強力にするために他の自動化APIを確認しましょう
XCTestCaseのsetUpインスタンスメソッドを使用すると以降の実行時にデバイスを確実に同じ状態にするのに役立ちます orientationやappearanceなどのAPIの呼び出しや場所のシミュレートを行い実行を開始する前にデバイスを適切な状態にすることができます
アプリを起動する前に launchArgumentsや launchEnvironmentなどのプロパティを使用して launchメソッドが呼び出されたときにこれらのパラメータをアプリで使用できます
アプリがカスタムURLスキームをサポートしている場合 XCUIApplicationの openメソッドを直接使用して一致する URLに対してアプリを開くことができます
グローバルバージョンもありデバイスのデフォルトアプリを使用してURLを開きます
最後に UIテスト内でアプリのアクセシビリティ監査を実行できます詳しくはWWDC23のセッション「Perform accessibility audits for your app」をご覧くださいインタラクションを記録し自動化を設定したのでデバイスとクラウドの両方において複数の構成で再生するようにテストを構成しましょうテストを新規または既存のテスト計画に追加すると非常に便利ですテスト計画では個々のテストを含めるか除外するかを決めテストを実行する場所や方法に関するシステム設定を行いタイムアウト繰り返し並列化実行順序などのテストプロパティを管理できます
テスト計画をスキームに関連付けてテスト計画と特定のビルド設定を組み合わせることもできます
詳細についてはデベロッパ向けドキュメントの「Improving code assessment by organizing tests into test plans」をご覧ください
テスト計画では最初の画面でテストを追加または削除できますまたタブに切り替えてテストの実行方法を変更できます複数の構成を設定して複数の言語でアプリを実行できます
通常各ロケールはテスト計画内の独立した構成として存在します
特定のロケール構成に焦点を絞った設定を行ったりすべてのロケールで共有するその他の設定を行ったりできます
ドイツ語のように長い文字列を使用する言語やアラビア語やヘブライ語のように右から左に書く言語のための構成を含めると便利です
タブには UI自動化に関する設定もあります
例えば実行中にビデオやスクリーンショットをキャプチャするか実行後にメディアを残すかなどがあります
デフォルトでは実行に失敗した場合のみ問題を確認できるようにビデオとスクリーンショットを残します実行に成功した場合もそれらを残すにはを選択しますこの設定を使用するとドキュメントチュートリアルマーケティングなど他の目的のためにビデオ録画を残すことができますタブには他にも多くの有用な設定があります詳細については WWDC22の「Author fast and reliable tests for Xcode Cloud」をご覧ください
Xcode CloudはXcodeに内蔵されたサービスで App Store Connectでも利用できますアプリのビルドテストの実行 App Store へのアップロードなど様々に役立ちますこれらすべてがクラウドで行われデベロッパやチームのデバイスを使用する必要がありません Xcode Cloudならすべて問題なく実行できそうです Landmarksアプリ向けに Xcode Cloudワークフロー構成しましたこのワークフローは私が作成したテスト計画を使用して私が書いたすべてのUI自動化を実行しますこの計画は iPhoneとiPad上の英語アラビア語ヘブライ語ドイツ語など任意の数のデバイスと構成でシミュレータで実行する場合と同様にクラウド内で実行されます
Xcode Cloudの実行履歴はXcode内からまたはApp Store Connectのセクションで確認できますそこではビルド情報の概要ログ失敗に関する説明などを確認できます
Xcode Cloudを使用するとチームの全員が私の実行履歴を確認でき結果やビデオ録画をダウンロードできます私が文字どおり雲の中にいてもつまりシドニー行きの便に乗っていてもチームはそのような作業を行うことができます
Xcode Cloudについて学ぶべきことは他にもたくさんありますより高度な構成については WWDC23の「Create practical workflows in Xcode Cloud」をご覧ください複数の構成でテスト計画を使用し記録したテストを実行したのでテストレポートを使用して結果とビデオ録画を確認できます Xcodeのテストレポートにはテスト結果の表示理解診断に役立つ優れたツールがいくつかあります実行したばかりの自動化で複数の実行のうち1つが失敗したようですこれではオーストラリアに行くための荷物をまだ準備できません失敗したテストに移動するためにボタンをクリックします次に失敗した実行をダブルクリックしビデオ録画と何が起きたかの説明を確認します
このテストに含まれるすべての実行が実行のドロップダウンに表示されますこれにより異なる言語など様々な構成で実行したテストのビデオ録画をすばやく切り替えることができますまた面白いことに副ボタンのクリックに続いてを選択するとビデオをダウンロードできます
を押してビデオの再生を開始します
ビデオを再生すると UIインタラクションを示すドットがビデオの上に重ねて表示されますこれらのアクションは下部のタイムラインにもドットで示されます
失敗までには少し時間がかかりそうですのでスキップしましょうタイムライン上の失敗のひし形を使って失敗の瞬間に直接ジャンプします
失敗メッセージが表示されていますが何が問題かを把握するのは難しいですメッセージはというボタンを探していることを意味します失敗の時点で実際に何が起きていたかを見てみましょう
失敗の時点でビデオ録画の上に存在していたすべてのUI要素のオーバーレイを確認できます
いずれかの要素をクリックすると自動化コード内でこの要素に対処するための推奨コードが表示されますを押すと別の例を表示して最適なコードを見つけることができます間違いがわかりましたここにボタンを表示する必要がありますがボタンがありませんただのテキストですすぐに修正しましょう
希望のサンプルコードを選択し副ボタンのクリックを使ってコピーします
次にをクリックしてテストに直接移動し新しいコード行を既存のコードに貼り付けることができます
一時的な変数XCUIApplicationを UI記録の変数appに置き換えると準備は完了です
これで想定どおりに動作するはずですテストのひし形をクリックしてテストを再実行します今回はアラビア語でテストを実行し右から左に書くレイアウトでアプリが実行されているときでも同じ自動化が機能することを確認します
自動化によりコレクションがすばやく作成され英語と同じように名前が変更されますうまく機能します
自動化が成功しましたこれを終わらせて一生に一度の旅に出かけましょう母と妹が案内してくれることでしょう Xcodeのテストレポートでは他にも様々なことができます WWDC23のセッション「Fix failures faster with Xcode test reports」で詳細を確認できます UIの自動化アクセシビリティローカライズ Xcode Cloudおよびテストレポートをすべて連携させてアプリの品質を高め世界中のすべての人にとって使いやすくできるというのは驚くべきことですこれらの技術を 1つのフローに統合することはとても素晴らしいことであり皆さんに使ってもらうのが待ち遠しいです
単体テストとSwiftテストの詳細については WWDC24の「Meet Swift Testing」をご覧くださいご質問やフィードバックがある場合はデベロッパフォーラムで私たちにご連絡くださいありがとうございましたオーストラリアでお会いしましょう

7:52 - Adding accessibility identifiers in SwiftUI

// Adding accessibility identifiers in SwiftUI
import SwiftUI

struct LandmarkDetailView: View {
  let landmark: Landmark
  var body: some View {
    VStack {
      Image(landmark.backgroundImageName)
        .accessibilityIdentifier("LandmarkImage-\(landmark.id)")
      
      Text(landmark.description)
        .accessibilityIdentifier("LandmarkDescription-\(landmark.id)")
    }
  }
}

8:19 - Adding accessibility identifiers in UIKit

// Adding accessibility identifiers in UIKit
import UIKit

struct LandmarksListViewController: UIViewController {
  let landmarks: [Landmark] = [landmarkGreatBarrier, landmarkCairo]

  override func viewDidLoad() {
    super.viewDidLoad()

    for landmark in landmarks {
      let button = UIButton(type: .custom)
      setupButtonView()
                
      button.accessibilityIdentifier = "LandmarkButton-\(landmark.id)"
      
      view.addSubview(button)
    }
  }
}

13:54 - Best practice: Prefer accessibility identifiers over localized strings

// Example SwiftUI view
struct CollectionDetailDisplayView: View {
  var body: some View {
    ScrollView {
      Text(collection.name)
        .font(.caption)
        .accessibilityIdentifier("Collection-\(collection.id)")
    }
  }
}

// Example of a worse XCUIElementQuery
XCUIApplication().staticTexts["Max's Australian Adventure"]

// Example of a better XCUIElementQuery
XCUIApplication().staticTexts["Collection-1"]

14:09 - Best practice: Keep queries as concise as possible

// Example SwiftUI view
struct CollectionDetailDisplayView: View {
  var body: some View {
    ScrollView {
      Text(collection.name)
        .font(.caption)
        .accessibilityIdentifier("Collection-\(collection.id)")
    }
  }
}

// Example of a worse XCUIElementQuery
XCUIApplication().scrollViews.staticTexts["Collection-1"]

// Example of a better XCUIElementQuery
XCUIApplication().staticTexts["Collection-1"]

14:21 - Best practice: Prefer generic queries for dynamic content

// Example SwiftUI view
struct CollectionDetailDisplayView: View {
  var body: some View {
    ScrollView {
      Text(collection.name)
        .font(.caption)
        .accessibilityIdentifier("Collection-\(collection.id)")
    }
  }
}

// Example of a worse XCUIElementQuery
XCUIApplication().staticTexts["Max's Australian Adventure"]

// Example of a better XCUIElementQuery
XCUIApplication().staticTexts.firstMatch

15:49 - Add validations to a test case

// Add validations to the test case
import XCTest

class LandmarksUITests: XCTestCase {

  func testGreatBarrierAddedToFavorites() {
    let app = XCUIApplication()
    app.launch()
    app.cells["Landmark-186"].tap()
    XCTAssertTrue(
      app.staticTexts["Landmark-186"].waitForExistence(timeout: 10.0)),
      "Great Barrier exists"
    )

    let favoriteButton = app.buttons["Favorite"]
    favoriteButton.tap()
    XCTAssertTrue(
      favoriteButton.wait(for: \.value, toEqual: true, timeout: 10.0),
      "Great Barrier is a favorite"
    )
  }
}

16:36 - Set up your device for test execution

// Set up your device for test execution
import XCTest
import CoreLocation

class LandmarksUITests: XCTestCase {

  override func setUp() {
    continueAfterFailure = false
    
    XCUIDevice.shared.orientation = .portrait
    XCUIDevice.shared.appearance = .light
      
    let simulatedLocation = CLLocation(latitude: 28.3114, longitude: -81.5535)
    XCUIDevice.shared.location = XCUILocation(location: simulatedLocation)
  }
  
}

16:54 - Launch your app with environment variables and arguments

// Launch your app with environment variables and arguments
import XCTest

class LandmarksUITests: XCTestCase {

  func testLaunchWithDefaultCollection() {
    let app = XCUIApplication()
    app.launchArguments = ["ClearFavoritesOnLaunch"]
    app.launchEnvironment = ["DefaultCollectionName": "Australia 🐨 🐠"]
    app.launch()

    app.tabBars.buttons["Collections"].tap()
    XCTAssertTrue(app.buttons["Australia 🐨 🐠"].waitForExistence(timeout: 10.0))
  }
}

17:04 - Launch your app using custom URL schemes

// Launch your app using custom URL schemes
import XCTest

class LandmarksUITests: XCTestCase {

  func testOpenGreatBarrier() {
    let app = XCUIApplication()
    let customURL = URL(string: "landmarks://great-barrier")!
    app.open(customURL)

    XCTAssertTrue(app.wait(for: .runningForeground, timeout: 10.0))
    XCTAssertTrue(app.staticTexts["Great Barrier Reef"].waitForExistence(timeout: 10.0))
  }
}

17:12 - Launch your app using custom URL schemes and the system default app

// Launch your app using custom URL schemes
import XCTest

class LandmarksUITests: XCTestCase {

  func testOpenGreatBarrier() {
    let app = XCUIApplication()
    let customURL = URL(string: "landmarks://great-barrier")!
    XCUIDevice.shared.system.open(customURL)

    XCTAssertTrue(app.wait(for: .runningForeground, timeout: 10.0))
    XCTAssertTrue(app.staticTexts["Great Barrier Reef"].waitForExistence(timeout: 10.0))
  }
}

17:13 - Perform an accessibility audit during an automation

// Perform an accessibility audit during an automation
import XCTest

class LandmarksUITests: XCTestCase {
  
  func testPerformAccessibilityAudit() {
    let app = XCUIApplication()
    try app.performAccessibilityAudit()
  }

}

関連する章

リソース

関連ビデオ

WWDC24

WWDC23

WWDC22

WWDC21