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

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

Windows
MacOS
Linux

SessionFrontend.png

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

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

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

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

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

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

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

プラグインを有効にする

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

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

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

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

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

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

画像をクリックしてフルサイズで表示

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

セッション ブラウザ

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

SessionBrowser.png

ツールバー

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

画像をクリックしてフルサイズで表示

アイコン

タイトル

説明

StartTests.png

Start Tests

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

RunLevelTests.png

Run Level Test

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

RefreshTests.png

Refresh Tests

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

FindWorkers.png

Find Workers

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

Errors.png

Errors

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

Warnings.png

Warnings

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

DevContent.png

Dev Content

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

DeviceGroups.png

Device Groups

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

Presets.png

Preset

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

テスト ウィンドウと結果

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

画像をクリックしてフルサイズで表示

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

DeviceGroupsDropdown.png

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

画像をクリックしてフルサイズで表示

エラーや警告が発生した場合、メインの [Test] ウィンドウから該当するテストをクリックして、特定のエラーや警告を [Results] パネルに表示させることができます。

画像をクリックしてフルサイズで表示

エクスポート

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

画像をクリックしてフルサイズで表示

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

ExportData.png

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

ExportDataSuccessful.png

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

コピー

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

画像をクリックしてフルサイズで表示

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback