Variables de entorno para entornos de prueba personalizados - AWS Device Farm

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Variables de entorno para entornos de prueba personalizados

Device Farm configura dinámicamente varias variables de entorno para usarlas como parte de la ejecución de un entorno de pruebas personalizado.

Variables de entorno personalizadas

Device Farm admite la configuración de pares clave-valor que se aplican como variables de entorno en el host de prueba. Se pueden configurar en un proyecto de Device Farm o durante la creación de una ejecución; cualquier variable configurada en una ejecución sustituirá a las que se hayan configurado en su proyecto principal. Se aplican las siguientes restricciones:

  • Las variables de entorno personalizadas no se admiten en los hosts de prueba de iOS antiguos. Para obtener más información, consulte Host de pruebas de iOS antiguo.

  • Los nombres de variables que comiencen por $DEVICEFARM_ están reservados para el uso del servicio interno.

  • Las variables de entorno personalizadas no se pueden usar para configurar la selección de cómputo del host de prueba en la especificación de la prueba.

Variables de entorno comunes

En esta sección se describen las variables de entorno comunes a todas las pruebas de Device Farm.

$DEVICEFARM_DEVICE_NAME

El dispositivo en el que se ejecutan las pruebas. Representa el identificador de dispositivo único (UDID) del dispositivo.

$DEVICEFARM_DEVICE_UDID

El identificador único del dispositivo.

$DEVICEFARM_DEVICE_PLATFORM_NAME

El nombre de la plataforma del dispositivo. Es Android o iOS.

$DEVICEFARM_DEVICE_OS_VERSION

La versión del sistema operativo del dispositivo.

$DEVICEFARM_APP_PATH

(pruebas de aplicaciones móviles)

La ruta a la aplicación móvil en la máquina host donde se ejecutan las pruebas. Esta variable no está disponible durante las pruebas web.

$DEVICEFARM_LOG_DIR

La ruta al directorio predeterminado donde se almacenarán los registros de los clientes, los artefactos y otros archivos necesarios para su posterior recuperación. Utilizando un ejemplo de especificación de prueba, los archivos de este directorio se archivan en un archivo ZIP y están disponibles como artefactos tras la ejecución de la prueba.

$DEVICEFARM_SCREENSHOT_PATH

Ruta a las capturas de pantalla, si procede, capturadas durante la ejecución de prueba.

$DEVICEFARM_PROJECT_ARN

El ARN del proyecto principal del trabajo.

$DEVICEFARM_RUN_ARN

El ARN de la carrera principal del trabajo.

$DEVICEFARM_DEVICE_ARN

El ARN del dispositivo que se está probando.

$DEVICEFARM_TOTAL_JOBS

El número total de trabajos asociados a su ejecución principal de Device Farm.

$DEVICEFARM_JOB_NUMBER

El número de este trabajo está dentro de$DEVICEFARM_TOTAL_JOBS. Por ejemplo, una ejecución puede contener 5 trabajos y cada uno tendrá un $DEVICEFARM_JOB_NUMBER intervalo único de 0 a 4.

$AWS_REGION

La región de AWS. El servicio lo configurará para que coincida con la región en la que se encuentra el dispositivo que se está probando. Si es necesario, se puede anular mediante una variable de entorno personalizada.

$ANDROID_HOME

(Solo Android)

La ruta al directorio de instalación del SDK de Android.

Variables de entorno para las pruebas de Appium

En esta sección se describen las variables de entorno utilizadas por cualquier prueba de Appium en un entorno de pruebas personalizado en Device Farm.

$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR

(Solo Android)

La ubicación de un directorio que contiene los ChromeDriver ejecutables necesarios para su uso en las pruebas web e híbridas de Appium.

$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>

(solo iOS)

La ruta de datos derivada de una versión de WebDriverAgent creada para ejecutarse en Device Farm. La numeración de la variable corresponderá a la versión principal de WebDriverAgent. Como ejemplo, DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9 apuntará a una WebDriverAgent versión de 9.x. Para obtener más información, consulte Selección de una WebDriverAgent versión para las pruebas de iOS.

nota

Las variables de $DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N> entorno solo están presentes en los hosts iOS que no son antiguos. Para obtener más información, consulte Host de pruebas de iOS antiguo.

$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9

(solo para iOS, obsoleto)

La ruta de datos derivada de una versión de WebDriverAgent creada para ejecutarse en Device Farm. Consulte el esquema $DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N> de nombres de reemplazo.

Variables de entorno para XCUITest las pruebas

En esta sección, se describen las variables de entorno que utiliza la XCUITest prueba en un entorno de prueba personalizado en Device Farm.

$DEVICEFARM_XCUITESTRUN_FILE

La ruta al .xctestun archivo Device Farm. Se genera a partir de los paquetes de prueba y de la aplicación.

$DEVICEFARM_DERIVED_DATA_PATH

Ruta esperada de salida de xcodebuild de Device Farm.

$DEVICEFARM_XCTEST_BUILD_DIRECTORY

Ruta al contenido descomprimido del archivo del paquete de prueba.