Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Variabel lingkungan untuk lingkungan pengujian khusus
<a name="custom-test-environment-variables"></a>

 Device Farm secara dinamis mengonfigurasi beberapa variabel lingkungan untuk digunakan sebagai bagian dari lingkungan pengujian kustom yang dijalankan. 

**Topics**
+ [Variabel lingkungan khusus](#custom-test-environment-variables-custom)
+ [Variabel lingkungan umum](#custom-test-environment-variables-common)
+ [Variabel lingkungan untuk tes Appium](#custom-test-environment-variables-appium)
+ [Variabel lingkungan untuk XCUITest pengujian](#custom-test-environment-variables-xcuitest)

## Variabel lingkungan khusus
<a name="custom-test-environment-variables-custom"></a>

 Device Farm mendukung konfigurasi pasangan nilai kunci yang diterapkan sebagai variabel lingkungan pada host pengujian. Ini dapat dikonfigurasi pada proyek Device Farm atau selama pembuatan run; variabel apa pun yang dikonfigurasi saat menjalankan akan menggantikan variabel apa pun yang mungkin dikonfigurasi pada proyek induknya. Pembatasan berikut berlaku: 
+ Variabel lingkungan khusus tidak didukung pada host uji iOS lama. Untuk informasi selengkapnya, lihat [Host uji iOS lama](custom-test-environments-hosts-ios.md#legacy-ios-host).
+ Nama variabel yang dimulai dengan `$DEVICEFARM_` dicadangkan untuk penggunaan layanan internal.
+ Variabel lingkungan khusus tidak dapat digunakan untuk mengonfigurasi pemilihan komputasi host pengujian dalam spesifikasi pengujian Anda.

## Variabel lingkungan umum
<a name="custom-test-environment-variables-common"></a>

 Bagian ini menjelaskan variabel lingkungan yang umum untuk semua pengujian di Device Farm. 

** `$DEVICEFARM_DEVICE_NAME` **  
 Perangkat tempat pengujian Anda dijalankan. Ini mewakili pengenal perangkat unik (UDID) perangkat. 

** `$DEVICEFARM_DEVICE_UDID` **  
 Pengidentifikasi unik perangkat. 

** `$DEVICEFARM_DEVICE_PLATFORM_NAME` **  
 Nama platform perangkat. Itu salah satu `Android` atau`iOS`. 

** `$DEVICEFARM_DEVICE_OS_VERSION` **  
 Versi OS perangkat. 

** `$DEVICEFARM_APP_PATH` **  
 *(tes aplikasi seluler)*   
 Jalur ke aplikasi seluler di mesin host tempat pengujian dijalankan. Variabel ini tidak tersedia selama pengujian web. 

** `$DEVICEFARM_LOG_DIR` **  
 Jalur ke direktori default tempat log pelanggan, artefak, dan file yang diinginkan lainnya akan disimpan untuk pengambilan nanti. Menggunakan [contoh spesifikasi pengujian](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example), file dalam direktori ini diarsipkan dalam file ZIP dan tersedia sebagai artefak setelah pengujian Anda dijalankan. 

** `$DEVICEFARM_SCREENSHOT_PATH` **  
 Jalur ke tangkapan layar, jika ada, ditangkap selama uji coba. 

** `$DEVICEFARM_PROJECT_ARN` **  
 ARN dari proyek induk pekerjaan. 

** `$DEVICEFARM_RUN_ARN` **  
 ARN dari orang tua pekerjaan dijalankan. 

** `$DEVICEFARM_DEVICE_ARN` **  
 ARN perangkat yang diuji. 

** `$DEVICEFARM_TOTAL_JOBS` **  
 Jumlah total pekerjaan yang terkait dengan induk Device Farm run. 

** `$DEVICEFARM_JOB_NUMBER` **  
 Jumlah pekerjaan ini di dalamnya`$DEVICEFARM_TOTAL_JOBS`. Misalnya, sebuah run mungkin berisi 5 pekerjaan, dan masing-masing akan memiliki unik `$DEVICEFARM_JOB_NUMBER` mulai dari 0 hingga 4. 

** `$AWS_REGION` **  
 Wilayah AWS. Layanan akan mengatur ini agar sesuai dengan wilayah di mana perangkat yang diuji berada. Hal ini dapat diganti oleh variabel lingkungan kustom jika diperlukan. 

** `$ANDROID_HOME` **  
 *(Hanya Android)*   
 Jalur ke direktori instalasi Android SDK. 

## Variabel lingkungan untuk tes Appium
<a name="custom-test-environment-variables-appium"></a>

 Bagian ini menjelaskan variabel lingkungan yang digunakan oleh pengujian Appium apa pun di lingkungan pengujian kustom di Device Farm. 

** `$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR` **  
 *(Hanya Android)*   
 Lokasi direktori yang berisi ChromeDriver executable yang diperlukan untuk digunakan dalam web Appium dan tes hybrid. 

** `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` **  
 *(Hanya iOS)*   
 Jalur data turunan dari versi yang WebDriverAgent dibuat untuk dijalankan di Device Farm. Penomoran pada variabel akan sesuai dengan versi utama dari. WebDriverAgent Sebagai contoh, `DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` akan menunjuk ke WebDriverAgent versi 9.x. Untuk informasi selengkapnya, lihat [Memilih WebDriverAgent versi untuk pengujian iOS](test-types-appium.md#test-types-appium-select-wda).  
 Variabel `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` lingkungan hanya ada di host iOS non-warisan. Untuk informasi selengkapnya, lihat [Host uji iOS lama](custom-test-environments-hosts-ios.md#legacy-ios-host). 

** `$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9` **  
 *(Hanya iOS, tidak digunakan lagi)*   
 Jalur data turunan dari versi yang WebDriverAgent dibuat untuk dijalankan di Device Farm. Lihat skema `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` penamaan pengganti.

## Variabel lingkungan untuk XCUITest pengujian
<a name="custom-test-environment-variables-xcuitest"></a>

 Bagian ini menjelaskan variabel lingkungan yang digunakan oleh XCUITest pengujian di lingkungan pengujian kustom di Device Farm. 

** `$DEVICEFARM_XCUITESTRUN_FILE` **  
 Path ke `.xctestun` file Device Farm. Ini dihasilkan dari aplikasi dan paket pengujian Anda. 

** `$DEVICEFARM_DERIVED_DATA_PATH` **  
Jalur yang diharapkan dari keluaran Device Farm xcodebuild.

** `$DEVICEFARM_XCTEST_BUILD_DIRECTORY` **  
Jalur ke konten yang tidak di-zip dari file paket pengujian.