Se usó la API de Cloud Translation para traducir esta página.

Pruebas de instrumentación

Primero lea Pruebe su aplicación en developer.android.com. Tenga en cuenta que existen algunas diferencias en cómo se utilizan las pruebas de instrumentación en las pruebas de plataforma.

En resumen, una prueba de instrumentación proporciona un entorno de ejecución de prueba especial que se inicia a través del comando am instrument , donde el proceso de la aplicación de destino se reinicia e inicializa con el contexto básico de la aplicación, y se inicia un subproceso de instrumentación dentro de la máquina virtual del proceso de la aplicación. Su código de prueba comienza a ejecutarse en este subproceso de instrumentación y se proporciona con una instancia de Instrumentation que brinda acceso al contexto de la aplicación y las API para manipular el proceso de la aplicación bajo prueba.

Conceptos clave

una instrumentación debe declararse en un paquete de aplicación, con una etiqueta <instrumentation> anidada debajo de la etiqueta <manifest> del manifiesto del paquete de aplicación.
un manifiesto de paquete de aplicación técnicamente puede contener múltiples etiquetas <instrumentation> , aunque no se usa comúnmente de esta manera.
cada <instrumentation> debe contener:
- un atributo android:name : debe ser el nombre de una subclase de Instrumentation que se incluye en la aplicación de prueba, que suele ser el corredor de prueba que se usa, por ejemplo: android.support.test.runner.AndroidJUnitRunner
- se debe definir un atributo android:targetPackage . Su valor debe establecerse en el paquete de aplicación bajo prueba.

Resumen de pasos

A continuación, se muestran los destinos comunes para las pruebas herméticas contra los servicios del marco:
```
frameworks/base/core/tests/coretests
frameworks/base/services/tests/servicestests
```
Si está agregando un nuevo módulo de instrumentación para su componente, consulte
- Pruebas de autoinstrumentación: un ejemplo completo
- Instrumentación dirigida a una aplicación: un ejemplo completo
Siguiendo la convención existente si está agregando pruebas en una de las ubicaciones anteriores. Si está configurando un nuevo módulo de prueba, siga la configuración de AndroidManifest.xml y Android.mk en una de las ubicaciones anteriores.
Consulte frameworks/base/core/tests/coretests/ para ver un ejemplo. Tenga en cuenta que estas líneas instalan aplicaciones adicionales:
```
<option name="test-file-name" value="FrameworksCoreTests.apk" />
<option name="test-file-name" value="BstatsTestApp.apk" />
```
No olvide marcar su prueba como @SmallTest , @MediumTest o @LargeTest
Construya el módulo de prueba con m, por ejemplo:
```
m FrameworksCoreTests
```
Ejecute las pruebas:
- La solución más simple es usar Atest así:
```
atest FrameworksCoreTests
```
- O para pruebas más complejas, utilice el arnés de prueba de la Federación de Comercio :
```
m tradefed-all
tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
```

Si no usa Tradefed, instale y ejecute las pruebas manualmente:

Instala el apk generado:

adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk

Ejecute las pruebas con varias opciones:

todas las pruebas en la apk

adb shell am instrument -w com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

todas las pruebas bajo un paquete Java específico

adb shell am instrument -w -e package android.animation \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

todas las pruebas bajo una clase específica

adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

un método de prueba específico

adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest#testCancel \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

Su prueba puede hacer una afirmación explícita al pasar o fallar usando las API de JUnit ; además, cualquier excepción no detectada también provocará un error funcional.

Para emitir métricas de rendimiento, su código de prueba puede llamar a Instrumentation#sendStatus para enviar una lista de pares clave-valor. Es importante tener en cuenta que:

las métricas pueden ser números enteros o coma flotante
cualquier valor no numérico será descartado
su apk de prueba puede ser pruebas funcionales o pruebas de métricas, sin embargo, actualmente no se admite la combinación de ambas