自動化システムのユーザーガイド

テストの実行に使用する自動化システムのガイド

Banner Image

[Automation] タブをフォーカスした状態の Session Frontend

[Automation] タブは、Unreal EngineUnreal (Session) Frontend の一部です。マシンに接続されているか、ローカル ネットワークにある他のどのデバイスでも自動化テストを実行できるようにこの位置にあります。

Session (Unreal) Frontend にアクセスするには、以下の 2 種類の方法があります。

  • Session Frontend - 外部デバイスで自動化を実行する自動化ワーカーとしてローカル エディタを開きます。

    • [Window > Developer Tools > Session Frontend] の順に進みます。

  • Unreal Frontend - Frontend のスタンドアローン バージョンを開きます。このバージョンには、Session FrontendDevice Manager、および Project Launcher が含まれます。

    • [Unreal Engine Root Directory] > Engine > Binaries > Win64 > UnrealFrontend.exe の順に進みます。

プラグインを有効にする

UE の最新バージョンでは、すべての自動化テストは Engine Content フォルダからそのプラグインに移動しました。プラグインを有効にしないと[Automation] タブに表示されません。

Open Plugins

プラグインを有効にするには、[Edit > Plugins > Testing] の順に選択します。

自動化テストのプラグイン ブラウザ

スタンドアローンの UnrealFrontend を使っている場合、すべての自動化テストは有効にするための追加手順なしに利用することができます。

ユーザーインターフェース

Session Frontend を開くと、ConsoleAutomationScreenshot Comparison、 および Profiler などのいくつかのタブを利用できます。すべての自動化テストについて、[Automation] タブには、レンダリング機能の比較のための Screenshot Comparison タブにある追加機能で必要となるすべての機能があります。

画像をクリックして拡大表示します。

[Automation] タブ ウィンドウに何も表示されていなければ、左側のセッション ブラウズから有効なセッションを選択します。例えば、[This Application] で、[RDU-WD] という名前のマシンが選択されています。

セッション ブラウザ

セッション ブラウザ では、エディタの特定のインスタンスに接続することができます。セッションを選択すると、 [Automation] ウィンドウに利用可能な自動化テストが表示されます。

Sessions Browser

ツールバー

[Automation] タブのツールバーでは、自動化テストの開始、リフレッシュ、およびエラーや警告のフィルタリングの方法を制御することができます。

画像をクリックして拡大表示します。

アイコン

タイトル

説明

Start Test button

Start Tests

有効になっている現在選択中の自動化テストを開始および停止します。実行するテスト数も、参照のためにボタンの下に一覧表示されています。

Run Level Test button

Run Level Test

現在、ロードされているレベルがテストマップの場合、このボタンをクリックしてテストを選択し、ただちに実行することができます。

Refresh Test button

Refresh Tests

プロジェクトに追加されるテストの Test Name リストをリフレッシュします。

Find Workers button

Find Workers

テスト実行に使用可能なローカル ワーカーを探します。

Errors button

Errors

テストを完了しようとしてエラーが発生したテストを表示する [Test] ウィンドウのフィルタを切り替えます。

Warnings button

Warnings

テストを完了しようとして警告が発生したテストを表示する [Test] ウィンドウのフィルタを切り替えます。

Dev Content button

Dev Content

有効にすると、デベロッパー ディレクトリが、自動化テストに含まれるようになります。

Device Group button

Device Groups

マシン名、プラットフォーム、オペレーティング システムのバージョンなど、一連のオプションに従いテストをグループ化することができます。

Excluded Tests button

Excluded Tests

除外されたテストのみをトグルします。

Presets panel

Preset

テストと設定を選択して自動化テストの独自のプリセットを追加し、後で再度使用できるようにします。

テスト ウィンドウと結果

[Automation Tests] ウィンドウと [Automation Test Results] パネルには、テストが完了したマシン、実行したテスト数、不合格数など、実行したテストに関連する情報が表示されます。

画像をクリックして拡大表示します。

[Device Groups] ボタンを使って、自動化テストの実行を新たに開始するときに、結果パネルに表示する情報をどのようにグループ化するかを決めることができます。

画像をクリックして拡大表示します。

結果を見る場合、[Display] の選択肢を使って、テストの [Name] またはテスト完了にかかる [Time] を表示させます。

画像をクリックして拡大表示します。

エクスポート

自動化テストが完了すると、[Export] ドロップダウンを使って、結果を CSV ファイルにエクスポートすることができます。

画像をクリックして拡大表示します。

エクスポート対象を利用可能なフィルタで選んでから、[Export Data] ボタンを選択します。

Export Data button

データをエクスポートすると、成功の可否を示すポップアップと、CSV ファイルの保存場所が表示されます。

Export Data success message

[Export] ドロップダウンは、レポートが生成された場合に限りアクティブになります。[Export Data] ボタンはフィルタリングのクライテリアを満たすレポートがあった場合に限り、有効になります。

コピー

テストが完了すると、[Automation Test Results] パネルに表示される任意の行を選択して、[Copy] ボタンをクリックして、クリップボードにコピーし、どこにでも貼り付けることができます。

画像をクリックして拡大表示します。

タグ
Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル