翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムテスト環境の環境変数
<a name="custom-test-environment-variables"></a>

 Device Farm は、カスタムテスト環境の実行の一部として使用するために、複数の環境変数を動的に設定します。

**Topics**
+ [カスタム環境変数](#custom-test-environment-variables-custom)
+ [一般的な環境変数](#custom-test-environment-variables-common)
+ [Appium テストの環境変数](#custom-test-environment-variables-appium)
+ [XCUITest テストの環境変数](#custom-test-environment-variables-xcuitest)

## カスタム環境変数
<a name="custom-test-environment-variables-custom"></a>

 Device Farm は、テストホストの環境変数として適用されるキーと値のペアの設定をサポートします。これらは Device Farm プロジェクトで設定することも、実行の作成時に設定することもできます。実行時に設定される変数は、親プロジェクトで設定される変数よりも優先されます。以下の制限が適用されます。
+ カスタム環境変数は、レガシー iOS テストホストではサポートされていません。詳細については、「[レガシー iOS テストホスト](custom-test-environments-hosts-ios.md#legacy-ios-host)」を参照してください。
+ で始まる変数名`$DEVICEFARM_`は、内部サービス用に予約されています。
+ カスタム環境変数を使用して、テスト仕様でテストホストのコンピューティング選択を設定することはできません。

## 一般的な環境変数
<a name="custom-test-environment-variables-common"></a>

 このセクションでは、Device Farm のすべてのテストに共通の環境変数について説明します。

** `$DEVICEFARM_DEVICE_NAME` **  
 テストを実行するデバイス。デバイスの一意のデバイス識別子 (UDID) を表します。

** `$DEVICEFARM_DEVICE_UDID` **  
 デバイスの一意の識別子。

** `$DEVICEFARM_DEVICE_PLATFORM_NAME` **  
 デバイスのプラットフォーム名。これは `Android`または のいずれかです`iOS`。

** `$DEVICEFARM_DEVICE_OS_VERSION` **  
 デバイスの OS バージョン。

** `$DEVICEFARM_APP_PATH` **  
 *(モバイルアプリテスト)*   
 テストが実行されているホストマシン上のモバイルアプリケーションへのパス。この変数は、ウェブテスト中には使用できません。

** `$DEVICEFARM_LOG_DIR` **  
 カスタマーログ、アーティファクト、その他の必要なファイルが後で取得できるように保存されるデフォルトのディレクトリへのパス。[テスト仕様の例](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example)を使用すると、このディレクトリ内のファイルは ZIP ファイルにアーカイブされ、テストの実行後にアーティファクトとして使用可能になります。

** `$DEVICEFARM_SCREENSHOT_PATH` **  
 テスト実行中にキャプチャされるスクリーンショットへのパス (ある場合)。

** `$DEVICEFARM_PROJECT_ARN` **  
 ジョブの親プロジェクトの ARN。

** `$DEVICEFARM_RUN_ARN` **  
 ジョブの親実行の ARN。

** `$DEVICEFARM_DEVICE_ARN` **  
 テスト対象のデバイスの ARN。

** `$DEVICEFARM_TOTAL_JOBS` **  
 親 Device Farm 実行に関連付けられているジョブの合計数。

** `$DEVICEFARM_JOB_NUMBER` **  
 このジョブの 内の番号`$DEVICEFARM_TOTAL_JOBS`。たとえば、実行には 5 つのジョブを含めることができ、それぞれに 0`$DEVICEFARM_JOB_NUMBER`～4 の一意の範囲があります。

** `$AWS_REGION` **  
 AWS リージョン。サービスは、テスト対象のデバイスが配置されているリージョンと一致するようにこれを設定します。必要に応じて、カスタム環境変数によって上書きできます。

** `$ANDROID_HOME` **  
 *(Android のみ)*   
 Android SDK インストールディレクトリへのパス。

## Appium テストの環境変数
<a name="custom-test-environment-variables-appium"></a>

 このセクションでは、Device Farm のカスタムテスト環境で Appium テストで使用される環境変数について説明します。

** `$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR` **  
 *(Android のみ)*   
 Appium ウェブおよびハイブリッドテストで使用するために必要な ChromeDriver 実行可能ファイルを含むディレクトリの場所。

** `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` **  
 *(iOS のみ)*   
 Device Farm で実行するために構築されたバージョンの WebDriverAgent の派生データパス。変数の番号付けは、WebDriverAgent のメジャーバージョンに対応します。例として、 `DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9`は WebDriverAgent バージョンの 9.x を指します。詳細については、「[iOS テスト用の WebDriverAgent バージョンの選択](test-types-appium.md#test-types-appium-select-wda)」を参照してください。  
 `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` 環境変数は、レガシーではない iOS ホストにのみ存在します。詳細については、「[レガシー iOS テストホスト](custom-test-environments-hosts-ios.md#legacy-ios-host)」を参照してください。

** `$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9` **  
 *(iOS のみ、廃止)*   
 Device Farm で実行するために構築されたバージョンの WebDriverAgent の派生データパス。置換命名スキーム`$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>`については、「」を参照してください。

## XCUITest テストの環境変数
<a name="custom-test-environment-variables-xcuitest"></a>

 このセクションでは、Device Farm のカスタムテスト環境での XCUITest テストで使用される環境変数について説明します。

** `$DEVICEFARM_XCUITESTRUN_FILE` **  
 Device Farm `.xctestun` ファイルへのパス。アプリケーションとテストパッケージから生成されます。

** `$DEVICEFARM_DERIVED_DATA_PATH` **  
Device Farm xcodebuild 出力の予想されるパス。

** `$DEVICEFARM_XCTEST_BUILD_DIRECTORY` **  
テストパッケージの解凍された中身へのパス。