翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
IDT テストスイート設定ファイルを作成する
このセクションでは、カスタムテストスイートの作成時、これに含める設定ファイルを作成する際の形式について説明します。
必要な設定ファイル
suite.json
-
テストスイートに関する情報が含まれています。suite.json を設定する を参照してください。
group.json
-
テストグループに関する情報が含まれています。テストスイート内のテストグループごとに
group.json
ファイルを作成する必要があります。group.json を設定する を参照してください。 test.json
-
テストケースに関する情報が含まれています。テストスイート内のテストケースごとに
test.json
ファイルを作成する必要があります。test.json を設定する を参照してください。
オプションの設定ファイル
test_orchestrator.yaml
またはstate_machine.json
-
IDT がテストスイートを実行するときのテストの実行方法を定義します。「test_orchestrator.yaml を設定する」を参照してください。
注記
IDT v4.5.2 以降では、テストワークフローの定義に
test_orchestrator.yaml
ファイルを使用します。IDT のそれより前のバージョンでは、state_machine.json
ファイルを開きます。ステートマシンの詳細については、「IDT ステートマシンを設定する」を参照してください。 userdata_schema.json
-
テストの実行者が構成設定に含めることができる userdata.json ファイルのスキーマを定義します。
userdata.json
ファイルは、テストの実行に必要であるものの、device.json
ファイルに含まれていない、追加の設定情報用に使用します。userdata_schema.json を設定する を参照してください。
設定ファイルは、以下に示すように
に配置します。<custom-test-suite-folder>
<custom-test-suite-folder>
└── suite ├── suite.json ├── test_orchestrator.yaml ├── userdata_schema.json ├──<test-group-folder>
├── group.json ├──<test-case-folder>
└── test.json
suite.json を設定する
suite.json
ファイルは、環境変数を設定し、テストスイートの実行にユーザーデータが必要かどうかを決定します。以下のテンプレートを使用して、
ファイルを設定します。<custom-test-suite-folder>
/suite/suite.json
{ "id": "
<suite-name>_<suite-version>
", "title": "<suite-title>
", "details": "<suite-details>
", "userDataRequired": true | false, "environmentVariables": [ { "key": "<name>
", "value": "<value>
", }, ... { "key": "<name>
", "value": "<value>
", } ] }
以下に説明するように、値が含まれているすべてのフィールドは必須です。
id
-
テストスイートの一意のユーザー定義 ID。
id
の値は、suite.json
ファイルが配置されているテストスイートフォルダ名と一致する必要があります。スイート名とスイートのバージョンは、次の要件も満たしている必要があります。-
にアンダースコアを含めることはできません。<suite-name>
-
が<suite-version>
として表されている (x.x.x
x
は数字)。
ID は IDT によって生成されるテストレポートに表示されます。
-
title
-
このテストスイートでテストされる製品または機能のユーザー定義名。この名前は、テストの実行者の IDT CLI に表示されます。
details
-
テストスイートの目的の簡単な説明。
userDataRequired
-
テストの実行者が
userdata.json
ファイルにカスタム情報を含める必要があるかどうかを定義します。この値をtrue
に設定した場合は、テストスイートフォルダに userdata_schema.json ファイルも含める必要があります。 environmentVariables
-
オプション。このテストスイートに設定する環境変数の配列。
environmentVariables.key
-
環境変数の名前。
environmentVariables.value
-
環境変数の値。
group.json を設定する
group.json
ファイルは、テストグループが必須かオプションかを定義します。以下のテンプレートを使用して、
ファイルを設定します。<custom-test-suite-folder>
/suite/<test-group>
/group.json
{ "id": "
<group-id>
", "title": "<group-title>
", "details": "<group-details>
", "optional": true | false, }
以下に説明するように、値が含まれているすべてのフィールドは必須です。
id
-
テストグループの一意のユーザー定義 ID。
id
の値は、group.json
ファイルが配置されているテストグループフォルダの名前と一致する必要があり、アンダースコア (_
) は使用できません。ID は IDT によって生成されるテストレポートで使用されます。 title
-
テストグループのわかりやすい名前。この名前は、テストの実行者の IDT CLI に表示されます。
details
-
テストグループの目的の簡単な説明。
optional
-
オプション。
true
に設定すると、IDT が必須テストの実行を完了した後に、このテストグループがオプショングループとして表示されます。デフォルト値はfalse
です。
test.json を設定する
test.json
ファイルは、テストケースによって使用されるテストケース実行ファイルと環境変数を決定します。テストケース実行可能ファイルの作成の詳細については、IDT テストケース実行可能ファイルを作成するを参照してください。
以下のテンプレートを使用して、
ファイルを設定します。<custom-test-suite-folder>
/suite/<test-group>
/<test-case>
/test.json
{ "id": "
<test-id>
", "title": "<test-title>
", "details": "<test-details>
", "requireDUT": true | false, "requiredResources": [ { "name": "<resource-name>
", "features": [ { "name": "<feature-name>
", "version": "<feature-version>
", "jobSlots":<job-slots>
} ] } ], "execution": { "timeout":<timeout>
, "mac": { "cmd": "/path/to/executable
", "args": [ "<argument>
" ], }, "linux": { "cmd": "/path/to/executable
", "args": [ "<argument>
" ], }, "win": { "cmd": "/path/to/executable
", "args": [ "<argument>
" ] } }, "environmentVariables": [ { "key": "<name>
", "value": "<value>
", } ] }
以下に説明するように、値が含まれているすべてのフィールドは必須です。
id
-
テストケースの一意のユーザー定義 ID。
id
の値は、test.json
ファイルが配置されているテストケースフォルダの名前と一致する必要があり、アンダースコア (_
) は使用できません。ID は IDT によって生成されるテストレポートで使用されます。 title
-
テストケースのわかりやすい名前。この名前は、テストの実行者の IDT CLI に表示されます。
details
-
テストケースの目的の簡単な説明。
requireDUT
-
オプション。このテストの実行にデバイスが必要な場合は
true
に設定します。必要ない場合はfalse
に設定します。デフォルト値はtrue
です。テストの実行者は、テストの実行に使用するデバイスをdevice.json
ファイルに設定します。 requiredResources
-
オプション。このテストの実行に必要なリソースデバイスに関する情報を指定する配列。
requiredResources.name
-
このテストの実行時にリソースデバイスに与える一意の名前。
requiredResources.features
-
ユーザー定義のリソースデバイス機能の配列。
requiredResources.features.name
-
機能の名前。このデバイスが使用するデバイス機能。この名前は、テストの実行者によって
resource.json
ファイルに指定される機能名に対してマッチングされます。 requiredResources.features.version
-
オプション。機能のバージョン。この値は、テストの実行者によって
resource.json
ファイルに指定される機能のバージョンに対してマッチングされます。バージョンが指定されていない場合、機能はチェックされません。機能にバージョン番号が必要ない場合は、このフィールドは空白のままにしてください。 requiredResources.features.jobSlots
-
オプション。この機能がサポートできる同時テストの数。デフォルト値は、
1
です。IDT が機能ごとに異なるデバイスを使用する場合は、この値を1
に設定することをお勧めします。
execution.timeout
-
IDT がテスト実行終了まで待機する時間 (ミリ秒単位)。この値の設定の詳細については、IDT テストケース実行可能ファイルを作成するを参照してください。
execution.
os
-
IDT を実行するホストコンピュータのオペレーティングシステムに基づいて実行されるテストケースの実行可能ファイル。サポートされている値は
linux
、mac
、win
です。execution.
os
.cmd-
指定されたオペレーティングシステムで実行するテストケース実行可能ファイルへのパス。この場所は、システムパス内に存在する必要があります。
execution.
os
.args-
オプション。テストケースの実行可能ファイルを実行するために指定する引数。
environmentVariables
-
オプション。このテストケース用に設定された環境変数の配列。
environmentVariables.key
-
環境変数の名前。
environmentVariables.value
-
環境変数の値。
注記
test.json
ファイルとsuite.json
ファイルに同じ環境変数を設定した場合は、test.json
ファイルの値が優先されます。
test_orchestrator.yaml を設定する
テストオーケストレーターは、テストスイートの実行フローを制御するコンストラクトです。テストスイートの開始ステートを決定し、ユーザー定義のルールに基づいてステートの移行を管理し、終了ステートに達するまでステートの移行を継続します。
テストスイートにユーザー定義のテストオーケストレーターが含まれていない場合は、IDT によってテストオーケストレーターが生成されます。
デフォルトのテストオーケストレーターには以下の機能があります。
-
テストの実行者に、テストスイート全体ではなく、特定のテストグループを選択して実行する機能を提供する。
-
特定のテストグループが選択されていない場合、テストスイート内のすべてのテストグループをランダムな順序で実行する。
-
レポートを生成し、各テストグループおよびテストケースのテスト結果を示すコンソールサマリーを出力する。
IDT テストオーケストレーターの機能の詳細については、「IDT テストオーケストレーターを設定する」を参照してください。
userdata_schema.json を設定する
userdata_schema.json
ファイルは、テストの実行者がユーザーデータを指定するスキーマを決定します。ユーザーデータは、テストスイートが device.json
ファイルに含まれていない情報を必要とする場合に必要になります。例えば、テストを実行するために、Wi-Fi ネットワークの認証情報、特定のオープンポート、またはユーザーが提供する証明書が必要になる場合があります。この情報は、userdata
という入力パラメータとして IDT に提供できます。これは、ユーザーが
フォルダに作成する<device-tester-extract-location>
/configuserdata.json
ファイルの値です。userdata.json
の形式は、テストケースに含まれている userdata_schema.json
ファイルに基づきます。
テストの実行者が userdata.json
ファイルを提供しなければならないことを示す方法
-
suite.json
ファイルで、userDataRequired
をtrue
に設定します。 -
で、<custom-test-suite-folder>
userdata_schema.json
ファイルを作成します。 -
userdata_schema.json
ファイルを編集して、有効な IETF Draft v4 JSON Schemaを作成します。
IDT は、テストスイートを実行するときに、このスキーマを自動的に読み込み、テストの実行者によって提供される userdata.json
ファイルの検証に使用します。有効な場合、userdata.json
ファイルのコンテンツは IDT コンテキストおよび、テストオーケストレーターコンテキストの両方で利用可能になります。