iOS 用 XCTest UI と Device Farm の統合

Device Farm は、XCTest UI テストフレームワークをサポートしています。中でも、Device Farm では、Objective-C と Swift の両方で記述される XCTest UI テストをサポートしています。

XCTest UI フレームワークは、XCTest 上に構築された iOS 開発での UI テストを可能にします。詳細については、iOS 開発者ライブラリの「ユーザーインターフェイスのテスト」を参照してください。

Device Farm でのテストに関する一般的な情報については、「」を参照してくださいAWS Device Farm でのフレームワークと組み込みテストのテスト。

Device Farm を iOS 用の XCTest UI テストフレームワークと統合するには、次の手順を使用します。

iOS XCTest UI テストを準備する

XCTEST_UI テストパッケージの .ipa ファイルまたは .zip ファイルをアップロードできます。

.ipa ファイルは、バンドル形式の iOS Runner アプリを含むアプリケーションアーカイブです。追加のファイルを.ipaファイルに含めることはできません。

.zip ファイルをアップロードする場合、iOS Runner アプリを直接含めるか、 .ipa ファイルを含めることができます。テスト中に他のファイルを使用する場合は、ファイル内に他の.zipファイルを含めることもできます。例えば.xctestrun、 などのファイル.xcworkspaceや、 .xcodeproj内の.zipファイルを含めて、デバイスファームで XCUI テストプランを実行できます。テストプランの実行方法の詳細については、XCUI テストタイプのデフォルトのテスト仕様ファイルを参照してください。

オプション 1: XCTest UI .ipa パッケージの作成

yourAppNameUITest UITest-Runner.app バンドルは、テスト用のプロジェクトを構築するときに Xcode によって生成されます。プロジェクトの Products ディレクトリにあります。

.ipa ファイルを作成するには：

1. Payload というディレクトリを作成します。

2. アプリディレクトリを Payload ディレクトリに追加します。

3. Payload ディレクトリを.zipファイルにアーカイブし、ファイル拡張子を に変更します.ipa。

次のフォルダ構造は、my-project-nameUITest-Runner.app という名前のサンプルアプリが.ipaファイルとしてパッケージ化される方法を示しています。

.
└── my-project-nameUITest.ipa
    └── Payload (directory)
        └── my-project-nameUITest-Runner.app 

オプション 2: XCTest UI .zip パッケージの作成

Device Farm は、完全な XCTest UI テストスイートを実行するための.xctestrunファイルを自動的に生成します。Device Farm で独自の.xctestrunファイルを使用する場合は、.xctestrunファイルとアプリケーションディレクトリを .zip ファイルに圧縮できます。テストパッケージ用の.ipaファイルが既にある場合は、*-Runner.app の代わりに、このファイルを含めることができます。

.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── SampleTestPlan_2.xctestrun
   ├── SampleTestPlan_1.xctestrun
   └── (any other files)

Device Farm で XCUI テストの Xcode テストプランを実行する場合は、my-project-nameUITest-Runner.app または my-project-nameUITest.ipa ファイルを含む zip と、 .xcworkspace または ファイルを含むテストプランで XCTEST_UI を実行するために必要な xcode ソースコード.xcodeprojファイルを作成できます。

.xcodeproj ファイルを使用した zip の例を次に示します。

.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── (any directory)
   └── SampleXcodeProject.xcodeproj
        ├── Testplan_1.xctestplan
        ├── Testplan_2.xctestplan
        └── (any other source code files created by xcode with .xcodeproj)
	

.xcworkspace ファイルを使用した zip の例を次に示します。

.
└──swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   └── (any directory)
   │   ├── SampleXcodeProject.xcodeproj
   │   ├── Testplan_1.xctestplan
   │   ├── Testplan_2.xctestplan
   |   └── (any other source code files created by xcode with .xcodeproj)
   └── SampleWorkspace.xcworkspace
       └── contents.xcworkspacedata
  

注記

XCTest UI .zip パッケージ内に「Payload」という名前のディレクトリがないことを確認してください。

iOS XCTest UI テストをアップロードする

Device Farm コンソールを使用してテストをアップロードします。

1. https://console.aws.amazon.com/devicefarm で Device Farm コンソールにサインインします。

2. Device Farm ナビゲーションパネルで、[モバイルデバイスのテスト] を選択して、[プロジェクト] を選択します。

3. プロジェクトのリストで、テストをアップロードするプロジェクトを選択します。

   ヒント

   検索バーで名前によりプロジェクトリストを絞り込めます。

   プロジェクトを作成するには、「AWS Device Farm でのプロジェクトの作成」の手順に従ってください

4. [新規実行を作成] ボタンが表示されている場合は、選択します。

5. 「アプリケーションを選択する」ページで、[ファイルを選択] を選びます。

6. iOS アプリケーションファイルを参照して選択します。このファイルは、.ipa ファイルである必要があります。

   注記

   .ipa ファイルがシミュレーター用ではなく iOS デバイス用に作成されていることを確認します。

7. [次へ] をクリックします。

8. 「構成する」ページの [テストフレームワークをセットアップ] セクションにある [XCTest UI] を選択して、[ファイルを選択] を選びます。

9. iOS XCTest UI テストランナーを含む .ipa または .zip ファイルを参照して選択します。

10. [次へ] を選択後、残りの画面上の指示を完了してテストを実行するデバイスを選択し、実行を開始します。