Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Variabili di ambiente per ambienti di test personalizzati
Device Farm configura dinamicamente diverse variabili di ambiente da utilizzare come parte dell'esecuzione dell'ambiente di test personalizzato.
**Topics**
+ [Variabili di ambiente personalizzate](#custom-test-environment-variables-custom)
+ [Variabili di ambiente comuni](#custom-test-environment-variables-common)
+ [Variabili di ambiente per i test di Appium](#custom-test-environment-variables-appium)
+ [Variabili di ambiente per i test XCUITest](#custom-test-environment-variables-xcuitest)
## Variabili di ambiente personalizzate
Device Farm supporta la configurazione di coppie chiave-valore che vengono applicate come variabili di ambiente sull'host di test. Queste possono essere configurate in un progetto Device Farm o durante la creazione dell'esecuzione; tutte le variabili configurate in un'esecuzione sostituiranno quelle che possono essere configurate nel relativo progetto principale. Le restrizioni si applicano come segue:
+ Le variabili di ambiente personalizzate non sono supportate sugli host di test iOS precedenti. Per ulteriori informazioni, consulta [Host di test iOS legacy](custom-test-environments-hosts-ios.md#legacy-ios-host).
+ I nomi delle variabili che iniziano con `$DEVICEFARM_` sono riservati all'uso interno del servizio.
+ Le variabili di ambiente personalizzate non possono essere utilizzate per configurare la selezione del calcolo dell'host di test nelle specifiche del test.
## Variabili di ambiente comuni
Questa sezione descrive le variabili di ambiente comuni a tutti i test in Device Farm.
** `$DEVICEFARM_DEVICE_NAME` **
Il dispositivo su cui vengono eseguiti i test. Rappresenta l'identificatore univoco del dispositivo (UDID).
** `$DEVICEFARM_DEVICE_UDID` **
L'identificatore univoco del dispositivo.
** `$DEVICEFARM_DEVICE_PLATFORM_NAME` **
Il nome della piattaforma del dispositivo. O è `Android` o`iOS`.
** `$DEVICEFARM_DEVICE_OS_VERSION` **
La versione del sistema operativo del dispositivo.
** `$DEVICEFARM_APP_PATH` **
*(test delle app per dispositivi mobili)*
Il percorso all'app mobile sulla macchina host dove vengono eseguiti i test. Questa variabile non è disponibile durante i test web.
** `$DEVICEFARM_LOG_DIR` **
Il percorso della directory predefinita in cui verranno archiviati i log del cliente, gli artefatti e gli altri file desiderati per un successivo recupero. Utilizzando una [specifica di test di esempio](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example), i file in questa directory vengono archiviati in un file ZIP e resi disponibili come artefatto dopo l'esecuzione del test.
** `$DEVICEFARM_SCREENSHOT_PATH` **
Il percorso agli screenshot, se esistenti, acquisiti durante la sessione di test.
** `$DEVICEFARM_PROJECT_ARN` **
L'ARN del progetto principale del lavoro.
** `$DEVICEFARM_RUN_ARN` **
L'ARN dell'esecuzione principale del processo.
** `$DEVICEFARM_DEVICE_ARN` **
L'ARN del dispositivo sottoposto a test.
** `$DEVICEFARM_TOTAL_JOBS` **
Il numero totale di job associati all'esecuzione della Device Farm principale.
** `$DEVICEFARM_JOB_NUMBER` **
Il numero di questo lavoro è compreso`$DEVICEFARM_TOTAL_JOBS`. Ad esempio, un'esecuzione può contenere 5 job, ognuno dei quali avrà un valore univoco `$DEVICEFARM_JOB_NUMBER` compreso tra 0 e 4.
** `$AWS_REGION` **
La regione AWS. Il servizio lo imposterà in modo che corrisponda alla regione in cui si trova il dispositivo sottoposto a test. Se necessario, può essere sovrascritto da una variabile di ambiente personalizzata.
** `$ANDROID_HOME` **
*(Solo Android)*
Il percorso della directory di installazione di Android SDK.
## Variabili di ambiente per i test di Appium
Questa sezione descrive le variabili di ambiente utilizzate da qualsiasi test Appium in un ambiente di test personalizzato in Device Farm.
** `$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR` **
*(Solo Android)*
La posizione di una directory che contiene gli ChromeDriver eseguibili necessari per l'uso nei test web e ibridi di Appium.
** `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V` **
*(solo iOS)*
Il percorso dati derivato di una versione di Device Farm WebDriverAgent creata per essere eseguita su Device Farm. La numerazione sulla variabile corrisponderà alla versione principale di WebDriverAgent. Ad esempio, `DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` indicherà la WebDriverAgent versione a 9.x. Per ulteriori informazioni, consulta [Selezione di una WebDriverAgent versione per i test iOS](test-types-appium.md#test-types-appium-select-wda).
Le variabili di `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V` ambiente sono presenti solo su host iOS non legacy. Per ulteriori informazioni, consulta [Host di test iOS legacy](custom-test-environments-hosts-ios.md#legacy-ios-host).
** `$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9` **
*(solo iOS, obsoleto)*
Il percorso dati derivato di una versione di Device Farm WebDriverAgent creata per essere eseguita su Device Farm. `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V`Per lo schema di denominazione sostitutivo, fare riferimento a.
## Variabili di ambiente per i test XCUITest
Questa sezione descrive le variabili di ambiente utilizzate dal XCUITest test in un ambiente di test personalizzato in Device Farm.
** `$DEVICEFARM_XCUITESTRUN_FILE` **
Il percorso del `.xctestun` file Device Farm. Viene generato dalla tua app e dai pacchetti di test.
** `$DEVICEFARM_DERIVED_DATA_PATH` **
Percorso previsto dell'output xcodebuild di Device Farm.
** `$DEVICEFARM_XCTEST_BUILD_DIRECTORY` **
Il percorso ai contenuti decompressi del file del pacchetto di test.