As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Variáveis de ambiente para ambientes de teste personalizados
<a name="custom-test-environment-variables"></a>

 O Device Farm configura dinamicamente várias variáveis de ambiente para uso como parte da execução do seu ambiente de teste personalizado. 

**Topics**
+ [Variáveis de ambiente personalizadas](#custom-test-environment-variables-custom)
+ [Variáveis de ambiente comuns](#custom-test-environment-variables-common)
+ [Variáveis de ambiente para testes Appium](#custom-test-environment-variables-appium)
+ [Variáveis de ambiente para XCUITest testes](#custom-test-environment-variables-xcuitest)

## Variáveis de ambiente personalizadas
<a name="custom-test-environment-variables-custom"></a>

 O Device Farm suporta a configuração de pares de valores-chave que são aplicados como variáveis de ambiente no host de teste. Elas podem ser configuradas em um projeto Device Farm ou durante a criação da execução; qualquer variável configurada em uma execução substituirá qualquer variável que possa estar configurada em seu projeto principal. As seguintes restrições são aplicáveis: 
+ Variáveis de ambiente personalizadas não são compatíveis com hosts de teste antigos do iOS. Para obter mais informações, consulte [Host de teste iOS antigo](custom-test-environments-hosts-ios.md#legacy-ios-host).
+ Os nomes das variáveis que começam com `$DEVICEFARM_` são reservados para uso interno do serviço.
+ Variáveis de ambiente personalizadas não podem ser usadas para configurar a seleção de computação do host de teste em sua especificação de teste.

## Variáveis de ambiente comuns
<a name="custom-test-environment-variables-common"></a>

 Esta seção descreve as variáveis de ambiente comuns a todos os testes no Device Farm. 

** `$DEVICEFARM_DEVICE_NAME` **  
 O dispositivo no qual seus testes são executados. Ele representa o identificador exclusivo do dispositivo (UDID) do dispositivo. 

** `$DEVICEFARM_DEVICE_UDID` **  
 O identificador exclusivo do dispositivo. 

** `$DEVICEFARM_DEVICE_PLATFORM_NAME` **  
 O nome da plataforma do dispositivo. É `Android` ou `iOS`. 

** `$DEVICEFARM_DEVICE_OS_VERSION` **  
 A versão do sistema operacional do dispositivo. 

** `$DEVICEFARM_APP_PATH` **  
 *(testes de aplicativos móveis)*   
 O caminho do aplicativo para dispositivos móveis na máquina de host onde os testes estão sendo executados. Essa variável não está disponível durante os testes na web. 

** `$DEVICEFARM_LOG_DIR` **  
 O caminho para o diretório padrão em que os registros, artefatos e outros arquivos desejados do cliente serão armazenados para recuperação posterior. Usando um [exemplo de especificação de teste](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example), os arquivos nesse diretório são arquivados em um arquivo ZIP e disponibilizados como artefato após a execução do teste. 

** `$DEVICEFARM_SCREENSHOT_PATH` **  
 O caminho das capturas de telas, se houver, capturadas durante a execução de teste. 

** `$DEVICEFARM_PROJECT_ARN` **  
 O ARN do projeto principal do trabalho. 

** `$DEVICEFARM_RUN_ARN` **  
 O ARN da execução principal do trabalho. 

** `$DEVICEFARM_DEVICE_ARN` **  
 O ARN do dispositivo em teste. 

** `$DEVICEFARM_TOTAL_JOBS` **  
 O número total de trabalhos associados à execução do Device Farm principal. 

** `$DEVICEFARM_JOB_NUMBER` **  
 O número desse trabalho está dentro`$DEVICEFARM_TOTAL_JOBS`. Por exemplo, uma execução pode conter 5 trabalhos e cada um terá um intervalo `$DEVICEFARM_JOB_NUMBER` exclusivo de 0 a 4. 

** `$AWS_REGION` **  
 A região da AWS. O serviço definirá isso para corresponder à região na qual o dispositivo em teste está localizado. Ela pode ser substituída por uma variável de ambiente personalizada, se necessário. 

** `$ANDROID_HOME` **  
 *(Somente para Android)*   
 O caminho para o diretório de instalação do SDK do Android. 

## Variáveis de ambiente para testes Appium
<a name="custom-test-environment-variables-appium"></a>

 Esta seção descreve as variáveis de ambiente usadas por qualquer teste Appium em um ambiente de teste personalizado no Device Farm. 

** `$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR` **  
 *(Somente para Android)*   
 A localização de um diretório que contém os ChromeDriver executáveis necessários para uso nos testes web e híbridos do Appium. 

** `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` **  
 *(somente iOS)*   
 O caminho de dados derivado de uma versão WebDriverAgent criada para ser executada no Device Farm. A numeração na variável corresponderá à versão principal do WebDriverAgent. Como exemplo, `DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` apontará para a WebDriverAgent versão 9.x. Para obter mais informações, consulte [Seleção de uma WebDriverAgent versão para testes do iOS](test-types-appium.md#test-types-appium-select-wda).  
 As variáveis de `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` ambiente só estão presentes em hosts iOS não legados. Para obter mais informações, consulte [Host de teste iOS antigo](custom-test-environments-hosts-ios.md#legacy-ios-host). 

** `$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9` **  
 *(somente iOS, obsoleto)*   
 O caminho de dados derivado de uma versão WebDriverAgent criada para ser executada no Device Farm. Consulte `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` para obter o esquema de nomenclatura de substituição.

## Variáveis de ambiente para XCUITest testes
<a name="custom-test-environment-variables-xcuitest"></a>

 Esta seção descreve as variáveis de ambiente usadas pelo XCUITest teste em um ambiente de teste personalizado no Device Farm. 

** `$DEVICEFARM_XCUITESTRUN_FILE` **  
 O caminho para o `.xctestun` arquivo Device Farm. Ele é gerado com base nos pacotes de aplicativos e testes. 

** `$DEVICEFARM_DERIVED_DATA_PATH` **  
Caminho esperado da saída do xcodebuild do Device Farm.

** `$DEVICEFARM_XCTEST_BUILD_DIRECTORY` **  
O caminho para o conteúdo descompactado do arquivo do pacote de teste.