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.
# Ejecuciones de prueba en AWS Device Farm
Una ejecución en Device Farm representa una compilación específica en la aplicación, con un conjunto específico de pruebas, que se ejecutará en un conjunto específico de dispositivos. Una ejecución produce un informe que contiene información acerca de los resultados de la ejecución. Una ejecución contiene una o varias tareas. Para obtener más información, consulte [Ejecuciones](test-runs.md).
Puede usar la consola de AWS Device Farm, AWS Command Line Interface (AWS CLI) o la API de AWS Device Farm para trabajar con las ejecuciones de prueba.
**Topics**
+ [Creación de una ejecución de prueba en Device Farm](how-to-create-test-run.md)
+ [Establecimiento del tiempo de espera de ejecución para ejecuciones de pruebas en AWS Device Farm](how-to-set-default-timeout-for-test-runs.md)
+ [Simulación de conexiones y condiciones de red para ejecuciones de AWS Device Farm](how-to-simulate-network-connections-and-conditions.md)
+ [Detención de una ejecución en AWS Device Farm](how-to-stop-test-runs.md)
+ [Visualización de una lista de ejecuciones en AWS Device Farm](how-to-view-runs-list.md)
+ [Creación de un grupo de dispositivos en AWS Device Farm](how-to-create-device-pool.md)
+ [Análisis de los resultados de las pruebas en AWS Device Farm](analyzing-results.md)
# Creación de una ejecución de prueba en Device Farm
Puede usar la consola Device Farm o la API de Device Farm para crear una ejecución de prueba. AWS CLI También puede utilizar un complemento admitido, como, por ejemplo, los complementos Jenkins o Gradle para Device Farm. Para obtener más información acerca de los complementos, consulte [Herramientas y complementos](aws-device-farm-tools-plugins.md). Para obtener información acerca de las ejecuciones, consulte [Ejecuciones](test-runs.md).
**Topics**
+ [Requisitos previos](#how-to-create-test-run-prerequisites)
+ [Creación de una ejecución de prueba (consola)](#how-to-create-test-run-console)
+ [Creación de una ejecución de prueba (AWS CLI)](#how-to-create-test-run-cli)
+ [Creación de una ejecución de prueba (API)](#how-to-create-test-run-api)
+ [Siguientes pasos](#how-to-create-test-run-console-next-steps)
## Requisitos previos
Debe tener un proyecto en Device Farm. Siga las instrucciones de [Creación de un proyecto en AWS Device Farm](how-to-create-project.md) y, a continuación, vuelva a esta página.
## Creación de una ejecución de prueba (consola)
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. Si ya dispone de un proyecto, puede cargar las pruebas en él. En caso contrario, seleccione **Nuevo proyecto**, indique un **Nombre del proyecto** y seleccione **Crear**.
1. Abra el proyecto y, a continuación, seleccione **Crear ejecución**.
1. (Opcional) En **Configuración de ejecución**, en la sección **Nombre de ejecución**, escriba un nombre para la ejecución. Si no se proporciona ningún nombre, la consola de Device Farm asignará a la ejecución el nombre “My Device Farm run” de forma predeterminada.
1. (Opcional) En **Configuración de ejecución**, en la sección **Tiempo de espera del trabajo**, puede especificar el tiempo de espera de la ejecución de la prueba. Si utiliza un número ilimitado de ranuras de prueba, confirme que **Sin medidor** esté seleccionado en **Método de facturación**.
1. En **Configuración de ejecución**, en la sección **Tipo de ejecución**, seleccione el tipo de ejecución. Seleccione **Aplicación Android** si no tiene ninguna aplicación lista para probarla o si está probando una aplicación en Android (.apk). Seleccione **Aplicación iOS** si está probando una aplicación iOS (.ipa). Seleccione **Aplicación web** si desea probar aplicaciones web.
1. En **Seleccionar aplicación**, en la sección **Opciones de selección de aplicaciones**, elija **Seleccionar aplicación de muestra proporcionada por Device Farm** si no tiene ninguna aplicación disponible para probarla. Si va a traer su propia aplicación, seleccione **Cargar aplicación propia** y elija el archivo de su aplicación. Si carga una aplicación iOS, asegúrese de elegir **Dispositivo iOS**, en lugar de un simulador.
1. En **Configurar prueba**, seleccione uno de los marcos de prueba disponibles.
**nota**
Si no hay ninguna prueba disponible, elija **Integrado: fuzzing** para ejecutar un conjunto de pruebas integrado estándar. Si elige **Integrado: fuzzing** y aparecen los cuadros **Recuento de eventos**, **Acelerador de eventos** y **Semilla aleatorizadora**, puede cambiar los valores o conservarlos.
Para obtener más información acerca de los conjuntos de pruebas disponibles, consulte [Marcos de pruebas y pruebas integradas en AWS Device Farm](test-types.md).
1. Si no ha elegido **Integrado: fuzzing**, seleccione **Elegir archivo** en **Seleccionar paquete de prueba**. Busque y elija el archivo que contiene las pruebas.
1. Para su entorno de prueba, seleccione **Ejecutar la prueba en nuestro entorno estándar** o **Ejecutar la prueba en un entorno personalizado**. Para obtener más información, consulte [Entornos de prueba de AWS Device Farm](test-environments.md).
1. Si está utilizando un entorno de pruebas personalizado, también puede hacer lo siguiente:
+ Si desea editar la especificación de prueba predeterminada en un entorno de pruebas personalizado, seleccione **Editar** para actualizar la especificación YAML predeterminada.
+ Si ha modificado la especificación de prueba, seleccione **Guardar como nuevo** para actualizarla.
+ Puede configurar las variables de entorno. Las variables que se proporcionan aquí tendrán prioridad sobre las que se puedan configurar en el proyecto principal.
1. En **Seleccionar dispositivos**, realice una de las siguientes acciones:
+ Para elegir un grupo de dispositivos integrados donde ejecutar las pruebas, en **Grupo de dispositivos**, elija **Dispositivos principales**.
+ Para crear su propio grupo de dispositivos donde ejecutar las pruebas, siga las instrucciones de [Creación de un grupo de dispositivos](how-to-create-device-pool.md) y, a continuación, regrese a esta página.
+ Si ha creado su propio grupo de dispositivos antes, en **Grupo de dispositivos**, elija su grupo de dispositivos.
+ Elija **Seleccionar dispositivos manualmente** y, a continuación, los dispositivos deseados en los que los desea ejecutar. Esta configuración no se guardará.
Para obtener más información, consulte [Compatibilidad de dispositivos en AWS Device Farmdispositivos](devices.md).
1. (Opcional) Para añadir una configuración adicional, abra el menú desplegable **Configuración adicional**. En esta sección, puede hacer una de las siguientes acciones:
+ Para proporcionar un ARN de rol de ejecución o anular uno configurado en el proyecto principal, utilice el campo ARN del rol de ejecución.
+ Para proporcionar otros datos para que Device Farm los utilice durante la ejecución, junto a **Agregar datos adicionales**, **seleccione Elegir archivo** y, a continuación, busque el archivo .zip que contiene los datos.
+ Para instalar una aplicación adicional que Device Farm utilizará durante la ejecución, junto a **Instalar otras aplicaciones**, seleccione **Elegir archivo** y, a continuación, busque y seleccione el archivo .apk o .ipa que contiene la aplicación. Repita la acción para las demás aplicaciones que desee instalar. Puede cambiar el orden de instalación arrastrando y soltando las aplicaciones después de cargarlas.
+ Para especificar si las opciones de wifi, Bluetooth, GPS o NFC estarán habilitadas durante la ejecución, junto a **Definir estados de radio**, seleccione las casillas correspondientes.
+ Para preestablecer la latitud y la longitud del dispositivo para la ejecución, junto a **Ubicación del dispositivo**, escriba las coordenadas.
+ Para preestablecer la configuración regional del dispositivo para la ejecución, seleccione la configuración regional en **Configuración regional del dispositivo**.
+ Seleccione **Habilitar grabación de video** para grabar video durante la prueba.
+ Seleccione **Habilitar la captura de datos de rendimiento de aplicaciones** para capturar datos de desempeño en el dispositivo.
**nota**
Por el momento, la configuración del estado de radio y la configuración regional del dispositivo solo está disponible en pruebas nativas de Android.
**nota**
Si tiene dispositivos privados, también se muestra la opción Configuración específica para dispositivos privados.
1. En la parte inferior de la página, elija **Crear ejecución** para programar la ejecución.
Device Farm comenzará la ejecución tan pronto como los dispositivos estén disponibles, normalmente en unos minutos. Durante la ejecución de la prueba, la consola de Device Farm mostrará un icono pendiente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-calendar.png) en la tabla de ejecución. Cada dispositivo en ejecución también empezará con el icono de pendiente y, después, pasará al icono de ejecución ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-progress.png) cuando comience la prueba. Al finalizar cada prueba, aparece un icono con el resultado de la prueba junto al nombre del dispositivo. Cuando se hayan completado todas las pruebas, el icono de pendiente situado junto a la ejecución pasará a ser el icono del resultado de la prueba.
Si necesita detener la ejecución de prueba, consulte [Detención de una ejecución en AWS Device Farm](how-to-stop-test-runs.md).
## Creación de una ejecución de prueba (AWS CLI)
Puede usarlo para crear una ejecución de prueba AWS CLI .
**Topics**
+ [Paso 1: Elegir un proyecto](#how-to-create-test-run-cli-step1)
+ [Paso 2: Elegir un grupo de dispositivos](#how-to-create-test-run-cli-step2)
+ [Paso 3: Cargar el archivo de la aplicación](#how-to-create-test-run-cli-step3)
+ [Paso 4: Cargar el paquete de scripts de pruebas](#how-to-create-test-run-cli-step4)
+ [Paso 5: Cargar la especificación de prueba personalizada (opcional)](#how-to-create-test-run-cli-step5)
+ [Paso 6: Programar una ejecución de prueba](#how-to-create-test-run-cli-step6)
### Paso 1: Elegir un proyecto
Debe asociar la ejecución de prueba a un proyecto de Device Farm.
1. Para ver una lista de sus proyectos de Device Farm, ejecute **list-projects**. Si no dispone de ningún proyecto, consulte [Creación de un proyecto en AWS Device Farm](how-to-create-project.md).
Ejemplo:
```
aws devicefarm list-projects
```
La respuesta incluye una lista de proyectos de Device Farm.
```
{
"projects": [
{
"name": "MyProject",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"created": 1503612890.057
}
]
}
```
1. Seleccione un proyecto para asociarlo a la ejecución de prueba y anote su nombre de recurso de Amazon (ARN).
### Paso 2: Elegir un grupo de dispositivos
Debe elegir un grupo de dispositivos para asociárselo a la ejecución de prueba.
1. Para ver los grupos de dispositivos, ejecute **list-device-pools** especificando el ARN del proyecto.
Ejemplo:
```
aws devicefarm list-device-pools --arn arn:MyProjectARN
```
La respuesta incluye los grupos de dispositivos integrados de Device Farm, tales como **Top Devices**, así como todos los grupos de dispositivos creados previamente para este proyecto:
```
{
"devicePools": [
{
"rules": [
{
"attribute": "ARN",
"operator": "IN",
"value": "[\"arn:aws:devicefarm:us-west-2::device:example1\",\"arn:aws:devicefarm:us-west-2::device:example2\",\"arn:aws:devicefarm:us-west-2::device:example3\"]"
}
],
"type": "CURATED",
"name": "Top Devices",
"arn": "arn:aws:devicefarm:us-west-2::devicepool:example",
"description": "Top devices"
},
{
"rules": [
{
"attribute": "PLATFORM",
"operator": "EQUALS",
"value": "\"ANDROID\""
}
],
"type": "PRIVATE",
"name": "MyAndroidDevices",
"arn": "arn:aws:devicefarm:us-west-2:605403973111:devicepool:example2"
}
]
}
```
1. Elija un grupo de dispositivos y anote su ARN.
También puede crear un grupo de dispositivos y, a continuación, volver a este paso. Para obtener más información, consulte [Crear un grupo de dispositivos (AWS CLI)](how-to-create-device-pool.md#how-to-create-device-pool-cli).
### Paso 3: Cargar el archivo de la aplicación
Para crear la solicitud de carga y obtener una URL de carga prefirmada de Amazon Simple Storage Service (Amazon S3), necesita lo siguiente:
+ El ARN de su proyecto.
+ El nombre del archivo de aplicación.
+ El tipo de carga.
Para obtener más información, consulte [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html).
1. Para cargar un archivo, ejecute **create-upload** con los parámetros `–-project-arn`, `--name` y `--type`.
En este ejemplo se crea una carga para una aplicación Android:
```
aws devicefarm create-upload -–project-arn arn:MyProjectArn -–name MyAndroid.apk -–type ANDROID_APP
```
La respuesta incluye el ARN de carga de la aplicación y una URL prefirmada.
```
{
"upload": {
"status": "INITIALIZED",
"name": "MyAndroid.apk",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Anote el ARN de carga de la aplicación y la URL prefirmada.
1. Cargar el archivo de la aplicación mediante la URL prefirmada de Amazon S3. En este ejemplo se utiliza **curl** para cargar un archivo .apk de Android:
```
curl -T MyAndroid.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
Para obtener más información, consulte [Carga de objetos mediante prefirmado URLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html) en la Guía del *usuario de Amazon Simple Storage Service*.
1. Para comprobar el estado de la carga de la aplicación, ejecute **get-upload** y especifique el ARN de carga de la aplicación.
```
aws devicefarm get-upload –-arn arn:MyAppUploadARN
```
Espere hasta que el estado contenido en la respuesta sea **SUCCEEDED** antes de cargar el paquete de scripts de pruebas.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyAndroid.apk",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
### Paso 4: Cargar el paquete de scripts de pruebas
A continuación, cargue el paquete de scripts de pruebas.
1. Para crear la solicitud de carga y obtener una URL de carga prefirmada de Amazon S3, ejecute **create-upload** con los parámetros `–-project-arn`, `--name` y `--type`.
En este ejemplo se crea una carga de paquete de pruebas de Appium Java TestNG:
```
aws devicefarm create-upload –-project-arn arn:MyProjectARN -–name MyTests.zip –-type APPIUM_JAVA_TESTNG_TEST_PACKAGE
```
La respuesta incluye el ARN de carga del paquete de pruebas y una URL prefirmada.
```
{
"upload": {
"status": "INITIALIZED",
"name": "MyTests.zip",
"created": 1535738627.195,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Anote el ARN de carga del paquete de pruebas y la URL prefirmada.
1. Cargue el archivo del paquete de scripts de pruebas mediante la URL prefirmada de Amazon S3. En este ejemplo se utiliza **curl** para cargar un archivo comprimido de scripts de Appium TestNG:
```
curl -T MyTests.zip "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
1. Para comprobar el estado de la carga del paquete de scripts de pruebas, ejecute **get-upload** y especifique el ARN de carga del paquete de pruebas del paso 1.
```
aws devicefarm get-upload –-arn arn:MyTestsUploadARN
```
Espere a que el estado contenido en la respuesta sea **SUCCEEDED** antes de continuar al paso siguiente, que es opcional.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyTests.zip",
"created": 1535738627.195,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
### Paso 5: Cargar la especificación de prueba personalizada (opcional)
Si utiliza las pruebas en un entorno de pruebas estándar, omita este paso.
Device Farm mantiene un archivo de especificación de prueba predeterminado para cada tipo de prueba admitido. A continuación, descargue la especificación de prueba predeterminada y utilícela para crear una carga de especificación de prueba personalizada con el fin de ejecutar las pruebas en un entorno de pruebas personalizado. Para obtener más información, consulte [Entornos de prueba de AWS Device Farm](test-environments.md).
1. Para encontrar el ARN de carga de la especificación de prueba predeterminada, ejecute **list-uploads** y especifique el ARN del proyecto.
```
aws devicefarm list-uploads --arn arn:MyProjectARN
```
La respuesta contiene una entrada para cada especificación de prueba predeterminada:
```
{
"uploads": [
{
{
"status": "SUCCEEDED",
"name": "Default TestSpec for Android Appium Java TestNG",
"created": 1529498177.474,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
]
}
```
1. Seleccione la especificación de prueba predeterminada de la lista. Anote su ARN de carga.
1. Para descargar la especificación de prueba predeterminada, ejecute **get-upload** y especifique el ARN de carga.
Ejemplo:
```
aws devicefarm get-upload –-arn arn:MyDefaultTestSpecARN
```
La respuesta contiene una URL prefirmada en la que podrá descargar la especificación de prueba predeterminada.
1. En este ejemplo se utiliza **curl** para descargar la especificación de prueba predeterminada y guardarla como `MyTestSpec.yml`:
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyTestSpec.yml
```
1. Puede editar la especificación de prueba predeterminada de tal forma que satisfaga sus requisitos de pruebas y, a continuación, utilizar la especificación de prueba modificada en futuras ejecuciones de prueba. Omita este paso si desea usar la especificación de prueba predeterminada tal cual en un entorno de pruebas personalizado.
1. Para crear una carga de la especificación de prueba personalizada, ejecute **create-upload** especificando el nombre de la especificación de prueba, su tipo y el ARN del proyecto.
En este ejemplo se crea una carga para una especificación de prueba personalizada de Appium Java TestNG:
```
aws devicefarm create-upload --name MyTestSpec.yml --type APPIUM_JAVA_TESTNG_TEST_SPEC --project-arn arn:MyProjectARN
```
La respuesta incluye el ARN de carga de la especificación de prueba y la URL prefirmada:
```
{
"upload": {
"status": "INITIALIZED",
"category": "PRIVATE",
"name": "MyTestSpec.yml",
"created": 1535751101.221,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Anote el ARN de carga de la especificación de prueba y la URL prefirmada.
1. Cargue el archivo de la especificación de prueba mediante la URL prefirmada de Amazon S3. En este ejemplo, se utiliza **curl** para cargar una especificación de prueba de Appium NG JavaTest:
```
curl -T MyTestSpec.yml "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
1. Para comprobar el estado de la carga de la especificación de prueba, ejecute **get-upload** y especifique el ARN de carga.
```
aws devicefarm get-upload –-arn arn:MyTestSpecUploadARN
```
Espere hasta que el estado contenido en la respuesta sea **SUCCEEDED** antes de programar la ejecución de prueba.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyTestSpec.yml",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
Para actualizar la especificación de prueba personalizada, ejecute **update-upload** especificando el ARN de carga de la especificación de prueba. Para obtener más información, consulte [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html).
### Paso 6: Programar una ejecución de prueba
Para programar una ejecución de prueba con AWS CLI, ejecute**schedule-run**, especificando:
+ El ARN del proyecto del [paso 1](#how-to-create-test-run-cli-step1).
+ El ARN del grupo de dispositivos del [paso 2](#how-to-create-test-run-cli-step2).
+ El ARN de carga de la aplicación del [paso 3](#how-to-create-test-run-cli-step3).
+ El ARN de carga del paquete de prueba del [paso 4](#how-to-create-test-run-cli-step4).
Si ejecuta las pruebas en un entorno de pruebas personalizado, también necesita el ARN de la especificación de prueba del [paso 5](#how-to-create-test-run-cli-step5).
**Para programar una ejecución en un entorno de pruebas estándar**
+ Ejecute **schedule-run** especificando el ARN del proyecto, el ARN del grupo de dispositivos, el ARN de carga de la aplicación y la información del paquete de pruebas.
Ejemplo:
```
aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
```
La respuesta contiene un ARN de ejecución que puede utilizar para comprobar el estado de la ejecución de prueba.
```
{
"run": {
"status": "SCHEDULING",
"appUpload": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345appEXAMPLE",
"name": "MyTestRun",
"radios": {
"gps": true,
"wifi": true,
"nfc": true,
"bluetooth": true
},
"created": 1535756712.946,
"totalJobs": 179,
"completedJobs": 0,
"platform": "ANDROID_APP",
"result": "PENDING",
"devicePoolArn": "arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-12345devicepoolEXAMPLE",
"jobTimeoutMinutes": 150,
"billingMethod": "METERED",
"type": "APPIUM_JAVA_TESTNG",
"testSpecArn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345specEXAMPLE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
}
```
Para obtener más información, consulte [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html).
**Para programar una ejecución en un entorno de pruebas personalizado**
+ Los pasos son prácticamente los mismos que para el entorno de pruebas estándar, pero se incluye un atributo `testSpecArn` adicional incluido en el parámetro `--test`.
Ejemplo:
```
aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test testSpecArn=arn:MyTestSpecUploadARN,type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
```
**Para comprobar el estado de la ejecución de prueba**
+ Utilice el comando **get-run** y especifique el ARN de la ejecución:
```
aws devicefarm get-run --arn arn:aws:devicefarm:us-west-2:111122223333:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE
```
Para obtener más información, consulte [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html). Para obtener información sobre el uso de Device Farm con AWS CLI, consulte[AWS CLIReferencia de ](cli-ref.md).
## Creación de una ejecución de prueba (API)
Los pasos son los mismos que los descritos en la AWS CLI sección. Consulte [Creación de una ejecución de prueba (AWS CLI)](#how-to-create-test-run-cli).
Para llamar a la API [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html), se requiere la información siguiente:
+ Un ARN de proyecto. Consulte [Crear un proyecto (API)](how-to-create-project.md#how-to-create-project-api) y [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html).
+ Un ARN de carga de una aplicación. Consulte [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
+ Un ARN de carga de paquete de pruebas. Consulte [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
+ Un ARN de grupos de dispositivos. Consulte [Creación de un grupo de dispositivos](how-to-create-device-pool.md) y [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html).
**nota**
Si ejecuta las pruebas en un entorno de pruebas personalizado, también necesita el ARN de carga de la especificación de prueba. Para obtener más información, consulte [Paso 5: Cargar la especificación de prueba personalizada (opcional)](#how-to-create-test-run-cli-step5) y [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
Para obtener más información acerca del uso de la API de Device Farm, consulte [Automatización de Device Farm](api-ref.md).
## Siguientes pasos
En la consola de Device Farm, el icono de reloj ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-calendar.png) se convertirá en un icono de resultado, como el icono de ejecución correcta ![\[The test succeeded.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-success.png), cuando se complete la ejecución. Tan pronto como se completan las pruebas, aparece un informe de la ejecución. Para obtener más información, consulte [Informes en AWS Device FarmInformes](reports.md).
Para usar el informe, siga las instrucciones que se indican en [Visualización de informes de pruebas en Device Farm](how-to-use-reports.md).
# Establecimiento del tiempo de espera de ejecución para ejecuciones de pruebas en AWS Device Farm
Puede establecer un valor por el tiempo durante el cual se debería llevar a cabo una ejecución de prueba antes de detener la ejecución de una prueba en cada uno de los dispositivos. El tiempo de espera de ejecución predeterminado es de 150 minutos por dispositivo, pero puede establecer un valor de tan solo 5 minutos. Puede usar la consola de AWS Device Farm o la API de AWS Device Farm para configurar el tiempo de espera de la ejecución. AWS CLI
**importante**
La opción de tiempo de espera de ejecución se debe establecer en la *duración máxima* de una ejecución de prueba, con cierto tiempo de reserva. Por ejemplo, si las pruebas tardan 20 minutos por dispositivo, debe elegir un tiempo de espera de 30 minutos por dispositivo.
Si la ejecución supera el tiempo de espera, se forzará la parada de la ejecución en ese dispositivo. Estarán disponibles los resultados parciales, si es posible. Se le facturará por la ejecución hasta ese momento, si está utilizando la opción de facturación con medidor. Para obtener más información, consulte los [precios de Device Farm](https://aws.amazon.com/device-farm/pricing/).
Puede que desee utilizar esta característica si sabe cuánto tiempo se supone que tardará en llevase a cabo una ejecución de prueba en cada dispositivo. Al especificar el tiempo de espera de una ejecución de prueba, puede evitar la situación en la que una ejecución de prueba se atasca por algún motivo y usted sigue siendo facturado por minutos de dispositivo aunque no haya ninguna prueba en ejecución. En otras palabras, el uso de la característica del tiempo de espera de ejecución le permite parar la ejecución de prueba si esta tarda más de lo previsto.
Puede establecer el tiempo de espera de ejecución en dos lugares: en el nivel del proyecto y en el nivel de la ejecución de prueba.
## Requisitos previos
1. Realice los pasos que se indican en [Configuración](setting-up.md).
1. Crear un proyecto en Device Farm. Siga las instrucciones de [Creación de un proyecto en AWS Device Farm](how-to-create-project.md) y, a continuación, vuelva a esta página.
## Establecimiento del tiempo de espera de ejecución para un proyecto
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación de Device Farm, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. Si ya tiene un proyecto, selecciónelo de la lista. De lo contrario, seleccione **Nuevo proyecto**, introduzca un nombre para el proyecto y, a continuación, seleccione **Enviar**.
1. Seleccione **Configuración del proyecto**.
1. En la pestaña **General**, en **Tiempo de espera de ejecución**, escriba un valor o use la barra del control deslizante.
1. Seleccione **Guardar**.
Ahora, todas las ejecuciones de prueba del proyecto usarán el valor de tiempo de espera de ejecución que ha especificado, a menos que anule el valor de tiempo de espera al programar una ejecución.
## Establecimiento del tiempo de espera de ejecución para una ejecución de prueba
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación de Device Farm, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. Si ya tiene un proyecto, selecciónelo de la lista. De lo contrario, seleccione **Nuevo proyecto**, introduzca un nombre para el proyecto y, a continuación, seleccione **Enviar**.
1. Seleccione **Crear una nueva ejecución**.
1. Siga los pasos para elegir una aplicación, configurar la prueba, seleccionar los dispositivos y especificar el estado de un dispositivo.
1. En la pestaña **Revisar e iniciar ejecución**, en **Establecer el tiempo de espera de ejecución**, escriba un valor o use la barra del control deslizante.
1. Seleccione **Confirmar e iniciar ejecución**.
# Simulación de conexiones y condiciones de red para ejecuciones de AWS Device Farm
Puedes usar el modelado de la red para simular las conexiones y las condiciones de la red mientras pruebas tus aplicaciones web, iOS y Android en Device Farm. Por ejemplo, puedes simular una conectividad a Internet intermitente o con pérdidas.
Cuando se crea una ejecución usando la configuración de red predeterminada, todos los dispositivos tienen una conexión wifi libre y completa con acceso a Internet. Cuando utilizas la configuración de la red, puedes cambiar la conexión Wi-Fi para especificar un perfil de red, como **3G** o con **pérdida**, WiFi que controle el rendimiento, el retraso, la fluctuación y las pérdidas tanto del tráfico entrante como saliente.
**Topics**
+ [Configuración de la forma de red al programar una ejecución de prueba](#network-shaping-how-to-choose-a-curated-profile-when-scheduling-a-test-run)
+ [Creación de un perfil de red](#network-shaping-how-to-create-a-network-profile)
+ [Cambio de las condiciones de red durante la prueba](#change-network-conditions-during-test)
## Configuración de la forma de red al programar una ejecución de prueba
Cuando programe una ejecución, puede elegir cualquiera de los perfiles mantenidos por Device Farm o bien puede crear y administrar el suyo propio.
1. Desde cualquier proyecto de Device Farm, seleccione **Crear una nueva ejecución**.
Si aún no tiene ningún proyecto, consulte [Creación de un proyecto en AWS Device Farm](how-to-create-project.md).
1. Elija la aplicación y, a continuación, seleccione **Siguiente**.
1. Configure la prueba y, a continuación, seleccione **Siguiente**.
1. Seleccione los dispositivos y, a continuación, seleccione **Siguiente**.
1. En la sección **Configuración de ubicación y red**, seleccione un perfil de red o seleccione **Crear perfil de red** para crear el suyo propio.
![\[Perfil de red para una ejecución de prueba\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-set-up-network-profile.png)
1. Seleccione **Siguiente**.
1. Revise y comience la ejecución de prueba.
## Creación de un perfil de red
Al crear una ejecución de prueba, se puede crear un perfil de red.
1. Seleccione **Crear un nuevo perfil de red**.
![\[Creación de un perfil de red\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-create-a-new-network-profile.png)
1. Escriba un nombre y la configuración del perfil de red.
1. Seleccione **Crear**.
1. Finalice la creación de la ejecución de prueba y comience la ejecución.
Una vez creado el perfil de red, podrá verlo y administrarlo en la página **Configuración del proyecto**.
![\[Perfiles de red en la configuración del proyecto\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-network-profiles-in-project-settings.png)
## Cambio de las condiciones de red durante la prueba
Puede llamar a una API desde su host de dispositivos mediante un marco como Appium, con el fin de simular condiciones de red dinámicas como un ancho de banda reducido durante la ejecución de prueba. Para obtener más información, consulte [CreateNetworkProfile](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateNetworkProfile.html).
# Detención de una ejecución en AWS Device Farm
Es posible que desee parar una ejecución después de haberla iniciado. Por ejemplo, si observa un problema mientras está ejecutando las pruebas, puede que desee reiniciar la ejecución con un script de prueba actualizado.
Puedes usar la consola o la API de AWS CLI Device Farm para detener una ejecución.
**Topics**
+ [Parar una ejecución (consola)](#how-to-stop-run-console)
+ [Detener una ejecución (AWS CLI)](#how-to-stop-test-run-cli)
+ [Detener una ejecución (API)](#how-to-stop-test-run-api)
## Parar una ejecución (consola)
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación de Device Farm, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. Seleccione el proyecto en el que tiene una ejecución de prueba activa.
1. En la página **Pruebas automatizadas**, seleccione la ejecución de prueba.
El icono de ejecución pendiente o en curso debe aparecer a la izquierda del nombre del dispositivo.
![\[Device Farm - Parar una ejecución de prueba\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-stop-run.png)
1. Seleccione **Detener ejecución**.
Transcurrido un breve periodo de tiempo, junto al nombre de dispositivo aparece un icono con un círculo rojo con un símbolo menos en su interior. Cuando se detiene la ejecución, el color del icono cambia de rojo a negro.
**importante**
Si una prueba ya se ha ejecutado, Device Farm no puede detenerla. Si una prueba está en curso, Device Farm la detiene. El total de minutos que se le facturarán aparece en la sección **Dispositivos**. Además, se le facturará el total de minutos que Device Farm tarde en ejecutar el conjunto de configuración y el conjunto de eliminación. Para obtener más información, consulte los [precios de Device Farm](https://aws.amazon.com/device-farm/faq/#pricing).
En la siguiente imagen se muestra un ejemplo de la sección **Dispositivos** después de que una ejecución de prueba se haya parado correctamente.
![\[Device Farm - Página Detalles de una ejecución detenida\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-stop-run-view-details.png)
## Detener una ejecución (AWS CLI)
Puede ejecutar el siguiente comando para detener la ejecución de la prueba especificada, donde *myARN* está el nombre de recurso de Amazon (ARN) de la ejecución de la prueba.
```
$ aws devicefarm stop-run --arn myARN
```
Debería ver una salida similar a esta:
```
{
"run": {
"status": "STOPPING",
"name": "Name of your run",
"created": 1458329687.951,
"totalJobs": 7,
"completedJobs": 5,
"deviceMinutes": {
"unmetered": 0.0,
"total": 0.0,
"metered": 0.0
},
"platform": "ANDROID_APP",
"result": "PENDING",
"billingMethod": "METERED",
"type": "BUILTIN_EXPLORER",
"arn": "myARN",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
}
```
Para obtener el ARN de la ejecución, use el comando `list-runs`. El resultado debería ser similar al siguiente:
```
{
"runs": [
{
"status": "RUNNING",
"name": "Name of your run",
"created": 1458329687.951,
"totalJobs": 7,
"completedJobs": 5,
"deviceMinutes": {
"unmetered": 0.0,
"total": 0.0,
"metered": 0.0
},
"platform": "ANDROID_APP",
"result": "PENDING",
"billingMethod": "METERED",
"type": "BUILTIN_EXPLORER",
"arn": "Your ARN will be here",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
]
}
```
Para obtener información sobre el uso de Device Farm con AWS CLI, consulte[AWS CLIReferencia de ](cli-ref.md).
## Detener una ejecución (API)
+ Realice la prueba de [StopRun](../../latest/APIReference/API_StopRun.html)funcionamiento de la operación.
Para obtener más información acerca del uso de la API de Device Farm, consulte [Automatización de Device Farm](api-ref.md).
# Visualización de una lista de ejecuciones en AWS Device Farm
Puedes usar la consola o la API de Device Farm para ver una lista de las ejecuciones de un proyecto. AWS CLI
**Topics**
+ [Visualización de una lista de ejecuciones (consola)](#how-to-view-runs-list-console)
+ [Visualización de una lista de ejecuciones (AWS CLI)](#how-to-view-runs-list-cli)
+ [Visualización de una lista de ejecuciones (API)](#how-to-view-runs-list-api)
## Visualización de una lista de ejecuciones (consola)
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación de Device Farm, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. En la lista de proyectos, elija el proyecto que se corresponde con la lista que desea ver.
**sugerencia**
Puede utilizar la barra de búsqueda para filtrar la lista de proyectos por nombre.
## Visualización de una lista de ejecuciones (AWS CLI)
+ Ejecute el comando [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-runs.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-runs.html).
Para ver información sobre una única ejecución, ejecute el comando [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html).
Para obtener información sobre el uso de Device Farm con AWS CLI, consulte[AWS CLIReferencia de ](cli-ref.md).
## Visualización de una lista de ejecuciones (API)
+ Llame a la API [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListRuns.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListRuns.html).
Para ver información sobre una única ejecución, llame a la API [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_GetRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_GetRun.html).
Para obtener más información sobre la API de Device Farm, consulte [Automatización de Device Farm](api-ref.md).
# Creación de un grupo de dispositivos en AWS Device Farm
Puede usar la consola o la API de Device Farm para crear un grupo de dispositivos. AWS CLI
**Topics**
+ [Requisitos previos](#how-to-create-device-pool-prerequisites)
+ [Crear un grupo de dispositivos (consola)](#how-to-create-device-pool-console)
+ [Crear un grupo de dispositivos (AWS CLI)](#how-to-create-device-pool-cli)
+ [Crear un grupo de dispositivos (API)](#how-to-create-device-pool-api)
## Requisitos previos
+ Cree una ejecución en la consola de Device Farm. Siga las instrucciones en [Creación de una ejecución de prueba en Device Farm](how-to-create-test-run.md). Cuando llegue a la página **Seleccionar dispositivos**, continúe con las instrucciones de esta sección.
## Crear un grupo de dispositivos (consola)
1. Elija un proyecto en la página **Proyectos**. En la página **Detalles del proyecto**, elija **Configuración del proyecto**. En la pestaña **Grupos de dispositivos**, elija **Crear grupo de dispositivos**.
1. En **Nombre**, escriba un nombre que permita identificar fácilmente este grupo de dispositivos.
1. En **Descripción**, escriba una descripción que permita identificar fácilmente este grupo de dispositivos.
1. Si desea utilizar uno o varios criterios de selección para los dispositivos de este grupo de dispositivos, haga lo siguiente:
1. Seleccione **Crear grupo de dispositivos dinámico**.
1. Seleccione **Agregar una regla**.
1. En **Campo** (primera lista desplegable), seleccione una de las siguientes opciones:
+ Para incluir los dispositivos por el nombre del fabricante, seleccione **Fabricante del dispositivo**.
+ Para incluir los dispositivos por factor de forma (tablet o teléfono), elija **Factor de forma**.
+ Para incluir los dispositivos por su estado de disponibilidad en función de la carga, elija **Disponibilidad**.
+ Para incluir solo dispositivos públicos o privados, elija **Tipo de flota**.
+ Para incluir los dispositivos por sistema operativo, elija **Plataforma**.
+ Algunos dispositivos tienen una etiqueta o descripción adicional acerca del dispositivo. Para buscar los dispositivos en función del contenido de sus etiquetas, seleccione **Etiquetas de instancia**.
+ Para incluir los dispositivos por versión del sistema operativo, elija **Versión del sistema operativo**.
+ Para incluir los dispositivos por modelo, elija **Modelo**.
1. En **Operador** (segunda lista desplegable), elija una operación lógica (IGUAL QUE, CONTIENE, etc.) para incluir los dispositivos en función de la consulta. Por ejemplo, puede optar por *Availability EQUALS AVAILABLE* incluir los dispositivos que actualmente tienen ese `Available` estado.
1. En **Valor** (tercera lista desplegable), escriba o seleccione el valor que desea especificar para los valores de **Campo** y **Operador**. Los valores están limitados en función del **campo** que elija. Por ejemplo, si elige **Plataforma** para **Campo**, entonces las únicas selecciones disponibles serán **ANDROID** e **IOS**. De forma similar, si selecciona **Factor de forma** para **Campo**, entonces las únicas selecciones disponibles serán **TELÉFONO** y **TABLET**.
1. Para añadir otra regla, seleccione **Agregar una regla**.
Después de crear la primera regla, en la lista de dispositivos se selecciona la casilla situada junto a cada uno de los dispositivos que coincide con la regla. Después de crear o modificar reglas, en la lista de dispositivos se selecciona la casilla situada junto a cada uno de los dispositivos que coincide con las reglas combinadas. Los dispositivos con casillas seleccionados se incluyen en el grupo de dispositivos. Los dispositivos cuyas casillas no están seleccionadas se excluyen.
1. En **Número máximo de dispositivos**, introduzca la cantidad de dispositivos que desea usar en su grupo de dispositivos. Si no especifica el número máximo de dispositivos, Device Farm seleccionará todos los dispositivos de la flota que coincidan con las reglas que ha creado. Para evitar cargos adicionales, establezca este número en una cantidad que coincida con sus requisitos reales de ejecución en paralelo y variedad de dispositivos.
1. Para eliminar una etiqueta, elija **Eliminar regla**.
1. Si desea incluir o excluir dispositivos individuales de forma manual, haga lo siguiente:
1. Seleccione **Crear grupo de dispositivos estático**.
1. Seleccione o desmarque la casilla situada junto a cada dispositivo. Puede seleccionar o borrar las casillas solo si no tiene reglas especificadas.
1. Si desea incluir o excluir todos los dispositivos que se muestran, seleccione o borre la casilla situada en la fila de encabezado de columna de la lista. Si solo quiere ver las instancias de dispositivos privados, elija **Ver solo las instancias de dispositivos privados**.
**importante**
Aunque puede utilizar las casillas de la fila de encabezados de columna para cambiar la lista de dispositivos que se muestran, eso no significa que los restantes dispositivos mostrados sean los únicos incluidos o excluidos. Para confirmar qué dispositivos se incluyen o excluyen, asegúrese de borrar el contenido de todas las casillas de la fila de encabezados de columna y, a continuación, examine las casillas.
1. Seleccione **Crear**.
## Crear un grupo de dispositivos (AWS CLI)
**sugerencia**
Si no especifica el número máximo de dispositivos, Device Farm seleccionará todos los dispositivos de la flota que coincidan con las reglas que ha creado. Para evitar cargos adicionales, establezca este número en una cantidad que coincida con sus requisitos reales de ejecución en paralelo y variedad de dispositivos.
+ Ejecute el comando [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html).
Para obtener información sobre el uso de Device Farm con AWS CLI, consulte[AWS CLIReferencia de ](cli-ref.md).
## Crear un grupo de dispositivos (API)
**sugerencia**
Si no especifica el número máximo de dispositivos, Device Farm seleccionará todos los dispositivos de la flota que coincidan con las reglas que ha creado. Para evitar cargos adicionales, establezca este número en una cantidad que coincida con sus requisitos reales de ejecución en paralelo y variedad de dispositivos.
+ Llame a la API [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html).
Para obtener más información acerca del uso de la API de Device Farm, consulte [Automatización de Device Farm](api-ref.md).
# Análisis de los resultados de las pruebas en AWS Device Farm
En el entorno de pruebas estándar, puede utilizar la consola de Device Farm para ver informes de cada prueba de la ejecución de prueba. Ver los informes lo ayuda a entender qué pruebas se han superado o no, y proporciona detalles sobre el rendimiento y el comportamiento de su aplicación en las diferentes configuraciones de dispositivos.
Device Farm también recopila otros artefactos, como archivos, registros e imágenes, que puede descargar cuando la ejecución de prueba se ha completado. Esta información puede ayudarlo a analizar el comportamiento de su aplicación en dispositivos reales, identificar problemas o errores y diagnosticarlos.
**Topics**
+ [Visualización de informes de pruebas en Device Farm](how-to-use-reports.md)
+ [Descarga de artefactos en Device Farm](artifacts.md)
# Visualización de informes de pruebas en Device Farm
Puede utilizar la consola de Device Farm para ver los informes de las pruebas. Para obtener más información, consulte [Informes en AWS Device FarmInformes](reports.md).
**Topics**
+ [Requisitos previos](#how-to-use-reports-prerequisites)
+ [Visualización de informes](#how-to-use-reports-viewing-reports)
+ [Estados de los resultados de las pruebas de Device Farm](how-to-use-reports-displaying-results.md)
## Requisitos previos
Configure una ejecución de prueba y compruebe que se haya completado.
1. Para crear una ejecución, consulte [Creación de una ejecución de prueba en Device Farm](how-to-create-test-run.md) y, a continuación, vuelva a esta página.
1. Compruebe que la ejecución se haya completado. Durante la ejecución de prueba, Device Farm muestra un icono de pendiente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-calendar.png) en la consola para las ejecuciones que están en curso. Cada dispositivo en ejecución también empezará con el icono de pendiente y, después, pasará al icono ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-progress.png) de ejecución cuando comience la prueba. Al finalizar cada prueba, aparece un icono con el resultado de la prueba junto al nombre del dispositivo. Cuando se hayan completado todas las pruebas, el icono de pendiente situado junto a la ejecución pasará a ser el icono del resultado de la prueba. Para obtener más información, consulte [Estados de los resultados de las pruebas de Device Farm](how-to-use-reports-displaying-results.md).
## Visualización de informes
Puede ver los resultados de la prueba en la consola de Device Farm.
**Topics**
+ [Visualización de la página de resumen de la ejecución de prueba](#how-to-use-reports-console-summary)
+ [Visualización de informes de problemas únicos](#how-to-use-reports-console-unique-problems)
+ [Visualización de informes de dispositivo](#how-to-use-reports-console-by-device)
+ [Visualización de informes de conjuntos de pruebas](#how-to-use-reports-console-by-suite)
+ [Consultar los informes de pruebas](#how-to-use-reports-console-by-test)
+ [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log)
### Visualización de la página de resumen de la ejecución de prueba
1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. En el panel de navegación, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.
1. En la lista de proyectos, elija el que desee incluir en la ejecución.
**sugerencia**
Utilice la barra de búsqueda para filtrar la lista de proyectos por nombre.
1. Elija una ejecución completada para ver su página de resumen de informe.
1. La página de resumen de la ejecución de prueba muestra información general de los resultados de las pruebas.
+ La sección **Problemas únicos** muestra una lista con las advertencias y errores únicos. Para ver los problemas únicos, siga las instrucciones de [Visualización de informes de problemas únicos](#how-to-use-reports-console-unique-problems).
+ La sección **Dispositivos** muestra el número total de pruebas, según su resultado, para cada dispositivo.
![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)
En este ejemplo, hay varios dispositivos. En la primera entrada de la tabla, el dispositivo Google Pixel 4 XL que ejecuta la versión 10 de Android informa de tres pruebas satisfactorias que tardaron 02:36 minutos en ejecutarse.
Para ver los resultados por dispositivo, siga las instrucciones de [Visualización de informes de dispositivo](#how-to-use-reports-console-by-device).
+ La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución, agrupadas por dispositivo.
+ En la sección **Resultado del análisis**, puede descargar el resultado del análisis.
### Visualización de informes de problemas únicos
1. En **Problemas únicos**, seleccione el problema que desee ver.
1. Elija el dispositivo. El informe muestra información sobre el problema.
La sección **Video** muestra una grabación en video descargable de la prueba.
La sección **Resultado** muestra el resultado de la prueba. El estado se representa como un icono de resultado. Para obtener más información, consulte [Estados de una prueba individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
La sección **Registros** muestra toda la información que Device Farm ha registrado durante la prueba. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).
La pestaña **Archivos** muestra una lista de todos los archivos asociados de la prueba (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.
La pestaña **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la prueba.
### Visualización de informes de dispositivo
+ En la sección **Dispositivos**, seleccione el dispositivo.
La sección **Video** muestra una grabación en video descargable de la prueba.
La sección **Conjuntos** muestra una tabla que contiene información sobre los conjuntos para el dispositivo.
En esta tabla, la columna **Resultados de las pruebas** resume el número de pruebas según su resultado para cada uno de los conjuntos de pruebas que se ejecutan en el dispositivo. Estos datos también tienen un componente gráfico. Para obtener más información, consulte [Estados de varias pruebas](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Para ver los resultados por conjunto, siga las instrucciones de [Visualización de informes de conjuntos de pruebas](#how-to-use-reports-console-by-suite).
La sección **Registros** muestra toda la información que Device Farm ha registrado para el dispositivo durante la ejecución. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).
La sección **Archivos** muestra una lista de conjuntos para el dispositivo y todos los archivos asociados (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.
La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución para el dispositivo, agrupadas por conjunto.
### Visualización de informes de conjuntos de pruebas
1. En la sección **Dispositivos**, seleccione el dispositivo.
1. En la sección **Conjuntos**, seleccione el conjunto de la tabla.
La sección **Video** muestra una grabación en video descargable de la prueba.
La sección **Pruebas** muestra una tabla que contiene información sobre las pruebas del conjunto.
En la tabla, la columna **Resultados de las pruebas** muestra el resultado. Estos datos también tienen un componente gráfico. Para obtener más información, consulte [Estados de varias pruebas](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Para ver los resultados por prueba, siga las instrucciones de [Consultar los informes de pruebas](#how-to-use-reports-console-by-test).
La sección **Registros** muestra toda la información que Device Farm ha registrado durante la ejecución para el conjunto. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).
La sección **Archivos** muestra una lista de pruebas para el conjunto y todos los archivos asociados (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.
La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución para el conjunto, agrupadas por prueba.
### Consultar los informes de pruebas
1. En la sección **Dispositivos**, seleccione el dispositivo.
1. En la sección **Conjuntos**, seleccione el conjunto.
1. En la sección **Pruebas**, seleccione la prueba.
1. La sección **Video** muestra una grabación en video descargable de la prueba.
La sección **Resultado** muestra el resultado de la prueba. El estado se representa como un icono de resultado. Para obtener más información, consulte [Estados de una prueba individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
La sección **Registros** muestra toda la información que Device Farm ha registrado durante la prueba. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).
La pestaña **Archivos** muestra una lista de todos los archivos asociados de la prueba (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.
La pestaña **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la prueba.
### Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe
En la sección de **Registros**, se muestra lo siguiente:
+ **Fuente** representa la fuente de una entrada de registro. Los valores posibles son:
+ **Herramienta** representa una entrada de registro creada por Device Farm. Estas entradas de log suelen crearse durante los eventos de comienzo y parada.
+ **Dispositivo** representa una entrada de registro creada por el dispositivo. Para Android, estas entradas de log son compatibles con logcat. Para iOS, estas entradas de registro son compatibles con syslog.
+ **Prueba** representa una entrada de registro creada por una prueba o su marco de pruebas.
+ **Tiempo** representa el tiempo transcurrido entre la primera entrada de registro y esta entrada de registro. La hora se expresa en *MM:SS.SSS* formato, donde *M* representa los minutos y *S* los segundos.
+ **PID** representa el identificador de proceso (PID) que creó la entrada de registro. Todas las entradas de registro creadas por una aplicación en un dispositivo tienen el mismo PID.
+ **Nivel** representa el nivel de registro para la entrada de registro. Por ejemplo, para `Logger.debug("This is a message!")`, el valor de **Nivel** que se registra es `Debug`. Estos son los valores posibles:
+ **Alerta**
+ **Critical**
+ **Debug**
+ **Emergencia**
+ **Error**
+ **Con errores**
+ **Con error**
+ **Información**
+ **Interno**
+ **Aviso**
+ **Passed**
+ **Skipped**
+ **Detenida**
+ **Detallado**
+ **Con advertencia**
+ **Advertencia**
+ **Etiqueta** representa los metadatos arbitrarios para la entrada de registro. Por ejemplo, logcat de Android puede usar esto para describir qué parte del sistema creó la entrada de log (por ejemplo, `ActivityManager`).
+ **Mensaje** representa el mensaje o los datos para la entrada de registro. Por ejemplo, para `Logger.debug("Hello, World!")`, el valor de **Mensaje** que se registra es `"Hello, World!"`.
Para mostrar solo una parte de la información:
+ Para mostrar todas las entradas de registro que coinciden con un valor para una columna específica, escriba el valor en la barra de búsqueda. Por ejemplo, para mostrar todas las entradas de registro cuyo valor de **Fuente** es `Harness`, escriba **Harness** en la barra de búsqueda.
+ Para quitar todos los caracteres de un cuadro de encabezado de columna, elija la **X** en ese cuadro de encabezado de la columna. Eliminar todos los caracteres de un cuadro de encabezado de columna es lo mismo que escribir **\$1** en ese cuadro de encabezado de columna.
Para descargar toda la información de registro del dispositivo, incluyendo todos los conjuntos y las pruebas que se han ejecutado, seleccione **Descargar registros**.
# Estados de los resultados de las pruebas de Device Farm
La consola de Device Farm muestra iconos que le ayudan a evaluar rápidamente el estado de la ejecución de prueba completada. Para obtener más información sobre las pruebas en Device Farm, consulte [Informes en AWS Device FarmInformes](reports.md).
**Topics**
+ [Estados de una prueba individual](#how-to-use-reports-displaying-results-individual)
+ [Estados de varias pruebas](#how-to-use-reports-displaying-results-summary)
## Estados de una prueba individual
Para los informes que describen una prueba individual, Device Farm muestra un icono que representa el estado del resultado de la prueba:
| Description (Descripción) | Icono |
| --- | --- |
| La prueba se ha completado correctamente. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-success.png) |
| La prueba no se ha completado correctamente. | ![\[The test failed.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-failure.png) |
| Device Farm se saltó la prueba. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-skipped.png) |
| La prueba se ha parado. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-stopped.png) |
| Device Farm ha devuelto una advertencia. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-warning.png) |
| Device Farm ha devuelto un error. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-error.png) |
## Estados de varias pruebas
Si selecciona una ejecución finalizada, Device Farm mostrará un gráfico resumido que muestra el porcentaje de pruebas en varios estados.
![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-summary-results-graph.png)
Por ejemplo, este gráfico de resultados de ejecución de prueba muestra 4 pruebas paradas, 1 prueba fallida y 10 pruebas completadas correctamente.
Los gráficos siempre están etiquetados y codificados por colores.
# Descarga de artefactos en Device Farm
Device Farm recopila artefactos como informes, archivos de registro e imágenes, de cada prueba de la ejecución.
Puede descargar los artefactos creados durante la ejecución de prueba:
**Archivos**
Archivos generados durante la ejecución de prueba, como los informes de Device Farm. Para obtener más información, consulte [Visualización de informes de pruebas en Device Farm](how-to-use-reports.md).
**Registros**
Salida de cada prueba de la ejecución de prueba.
**Capturas de pantalla**
Imágenes de las pantallas registradas para cada prueba de la ejecución de prueba.
![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in Nube de AWS.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/hierarchy.png)
## Descarga de artefactos (consola)
1. En la página de la ejecución de prueba, seleccione un dispositivo móvil en **Dispositivos**.
1. Para descargar un archivo, selecciónelo en **Archivos**.
1. Para descargar los registros de la ejecución de prueba, en **Registros**, seleccione **Descargar registros**.
1. Para descargar una captura de pantalla, seleccione una captura de pantalla de **Capturas de pantalla**.
Para obtener más información acerca de cómo descargar artefactos en un entorno de pruebas personalizado, consulte [Descarga de artefactos en un entorno de prueba personalizado](using-artifacts-custom.md).
## Descarga de artefactos (AWS CLI)
Puede utilizarla AWS CLI para enumerar los artefactos de las pruebas realizadas.
**Topics**
+ [Paso 1: Obtener los nombres de recurso de Amazon (ARN)](#artifacts-cli-step1)
+ [Paso 2: Crear una lista con los artefactos](#artifacts-cli-step2)
+ [Paso 3: Descargar los artefactos](#artifacts-cli-step3)
### Paso 1: Obtener los nombres de recurso de Amazon (ARN)
Los artefactos se pueden enumerar por ejecución, trabajo, conjunto de pruebas o prueba. Necesita el ARN correspondiente. Esta tabla muestra el ARN de entrada para cada uno de los comandos de la AWS CLI lista:
| AWS CLI Comando List | ARN requerido |
| --- | --- |
| list-projects | Este comando devuelve todos los proyectos y no requiere un ARN. |
| list-runs | project |
| list-jobs | run |
| list-suites | job |
| list-tests | suite |
Por ejemplo, para encontrar un ARN de prueba, ejecute **list-tests** con el ARN del conjunto de pruebas como parámetro de entrada.
Ejemplo:
```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```
La respuesta incluye un ARN de prueba para cada prueba del conjunto de pruebas.
```
{
"tests": [
{
"status": "COMPLETED",
"name": "Tests.FixturesTest.testExample",
"created": 1537563725.116,
"deviceMinutes": {
"unmetered": 0.0,
"total": 1.89,
"metered": 1.89
},
"result": "PASSED",
"message": "testExample passed",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:test:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 1,
"errored": 0,
"total": 1
}
}
]
}
```
### Paso 2: Crear una lista con los artefactos
El comando AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) devuelve una lista de artefactos, como archivos, capturas de pantalla y registros. Cada artefacto tiene una URL que le permite descargar el archivo.
+ Llame a **list-artifacts** especificando el ARN de una ejecución, un trabajo, un conjunto de pruebas o una prueba. Especifique un tipo de archivo, registro o captura de pantalla.
En este ejemplo, se devuelve una URL de descarga para cada artefacto disponible de una prueba individual:
```
aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
```
La respuesta contiene una URL de descarga para cada artefacto.
```
{
"artifacts": [
{
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"extension": "txt",
"type": "APPIUM_JAVA_OUTPUT",
"name": "Appium Java Output",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:artifact:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
}
]
}
```
### Paso 3: Descargar los artefactos
+ Descargue el artefacto mediante la dirección URL del paso anterior. En este ejemplo se utiliza **curl** para descargar un archivo de salida de Android Appium Java:
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyArtifactName.txt
```
## Descarga de artefactos (API)
El [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)método de la API Device Farm devuelve una lista de artefactos, como archivos, capturas de pantalla y registros. Cada artefacto tiene una URL que le permite descargar el archivo.
# Descarga de artefactos en un entorno de prueba personalizado
En un entorno de pruebas personalizado, Device Farm recopila artefactos como informes personalizados, archivos de registro e imágenes. Estos artefactos de prueba están disponibles para cada dispositivo de la ejecución de prueba.
Puede descargar estos artefactos creados durante la ejecución de prueba:
**Salida de la especificación de prueba**
La salida de la ejecución de los comandos en el archivo YAML de la especificación de prueba.
**Artefactos de clientes**
Archivo comprimido que contiene los artefactos de la ejecución de prueba. Se configura en la sección **artifacts (artefactos)** del archivo YAML de la especificación de prueba.
**Script del shell de la especificación de prueba**
Archivo de script del shell intermedio creado a partir del archivo YAML. Dado que se utiliza en la ejecución de prueba, el script del shell se puede usar para depurar el archivo YAML.
**Archivo de la especificación de prueba**
Archivo YAML utilizado en la ejecución de prueba.
Para obtener más información, consulte [Descarga de artefactos en Device Farm](artifacts.md).
![\[Jerarquía de operaciones de Device Farm en un entorno de pruebas personalizado\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/hierarchy.png)