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
O Device Farm configura dinamicamente várias variáveis de ambiente para uso como parte da execução do seu ambiente de teste personalizado.
Tópicos
Variáveis de ambiente personalizadas
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.
-
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
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. É
AndroidouiOS. -
$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, 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_NUMBERexclusivo 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
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_V9apontará para a WebDriverAgent versão 9.x. Para obter mais informações, consulte Seleção de uma WebDriverAgent versão para testes do iOS.nota
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. -
$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
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
.xctestunarquivo 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.
