[Automation] タブをフォーカスした状態の Session Frontend
[Automation] タブは、Unreal Engine の Unreal (Session) Frontend の一部です。マシンに接続されているか、ローカル ネットワークにある他のどのデバイスでも自動化テストを実行できるようにこの位置にあります。
Session (Unreal) Frontend にアクセスするには、以下の 2 種類の方法があります。
-
Session Frontend - 外部デバイスで自動化を実行する自動化ワーカーとしてローカル エディタを開きます。
- [Window > Developer Tools > Session Frontend] の順に進みます。
-
Unreal Frontend - Frontend のスタンドアローン バージョンを開きます。このバージョンには、Session Frontend、 Device Manager、および Project Launcher が含まれます。
- [Unreal Engine Root Directory] > Engine > Binaries > Win64 > UnrealFrontend.exe の順に進みます。
プラグインを有効にする
UE の最新バージョンでは、すべての自動化テストは Engine Content フォルダからそのプラグインに移動しました。プラグインを有効にしないと[Automation] タブに表示されません。
 |
|
|---|---|
| プラグインを有効にするには、[Edit > Plugins > Testing] の順に選択します。 | 自動化テストのプラグイン ブラウザ |
スタンドアローンの UnrealFrontend を使っている場合、すべての自動化テストは有効にするための追加手順なしに利用することができます。
ユーザーインターフェース
Session Frontend を開くと、Console、 Automation、 Screenshot Comparison、 および Profiler などのいくつかのタブを利用できます。すべての自動化テストについて、[Automation] タブには、レンダリング機能の比較のための Screenshot Comparison タブにある追加機能で必要となるすべての機能があります。
画像をクリックして拡大表示します。
[Automation] タブ ウィンドウに何も表示されていなければ、左側のセッション ブラウズから有効なセッションを選択します。例えば、[This Application] で、[RDU-WD] という名前のマシンが選択されています。
セッション ブラウザ
セッション ブラウザ では、エディタの特定のインスタンスに接続することができます。セッションを選択すると、 [Automation] ウィンドウに利用可能な自動化テストが表示されます。
ツールバー
[Automation] タブのツールバーでは、自動化テストの開始、リフレッシュ、およびエラーや警告のフィルタリングの方法を制御することができます。
画像をクリックして拡大表示します。
| アイコン | タイトル | 説明 |
|---|---|---|
 |
Start Tests | 有効になっている現在選択中の自動化テストを開始および停止します。実行するテスト数も、参照のためにボタンの下に一覧表示されています。 |
 |
Run Level Test | 現在、ロードされているレベルがテストマップの場合、このボタンをクリックしてテストを選択し、ただちに実行することができます。 |
 |
Refresh Tests | プロジェクトに追加されるテストの Test Name リストをリフレッシュします。 |
 |
Find Workers | テスト実行に使用可能なローカル ワーカーを探します。 |
 |
Errors | テストを完了しようとしてエラーが発生したテストを表示する [Test] ウィンドウのフィルタを切り替えます。 |
 |
Warnings | テストを完了しようとして警告が発生したテストを表示する [Test] ウィンドウのフィルタを切り替えます。 |
 |
Dev Content | 有効にすると、デベロッパー ディレクトリが、自動化テストに含まれるようになります。 |
 |
Device Groups | マシン名、プラットフォーム、オペレーティング システムのバージョンなど、一連のオプションに従いテストをグループ化することができます。 |
 |
Excluded Tests | 除外されたテストのみをトグルします。 |
 |
Preset | テストと設定を選択して自動化テストの独自のプリセットを追加し、後で再度使用できるようにします。 |
テスト ウィンドウと結果
[Automation Tests] ウィンドウと [Automation Test Results] パネルには、テストが完了したマシン、実行したテスト数、不合格数など、実行したテストに関連する情報が表示されます。
画像をクリックして拡大表示します。
[Device Groups] ボタンを使って、自動化テストの実行を新たに開始するときに、結果パネルに表示する情報をどのようにグループ化するかを決めることができます。
画像をクリックして拡大表示します。
結果を見る場合、[Display] の選択肢を使って、テストの [Name] またはテスト完了にかかる [Time] を表示させます。
画像をクリックして拡大表示します。
エクスポート
自動化テストが完了すると、[Export] ドロップダウンを使って、結果を CSV ファイルにエクスポートすることができます。
画像をクリックして拡大表示します。
エクスポート対象を利用可能なフィルタで選んでから、[Export Data] ボタンを選択します。
データをエクスポートすると、成功の可否を示すポップアップと、CSV ファイルの保存場所が表示されます。
[Export] ドロップダウンは、レポートが生成された場合に限りアクティブになります。[Export Data] ボタンはフィルタリングのクライテリアを満たすレポートがあった場合に限り、有効になります。
コピー
テストが完了すると、[Automation Test Results] パネルに表示される任意の行を選択して、[Copy] ボタンをクリックして、クリップボードにコピーし、どこにでも貼り付けることができます。
画像をクリックして拡大表示します。