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

  1. 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

  2. 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.

  3. 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" />
    
  4. No olvide marcar su prueba como @SmallTest , @MediumTest o @LargeTest

  5. Construya el módulo de prueba con m, por ejemplo:

    m FrameworksCoreTests
    
  6. Ejecute las pruebas:

    m tradefed-all
    tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
    
  7. Si no usa Tradefed, instale y ejecute las pruebas manualmente:

    1. Instala el apk generado:
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
    
    1. Ejecute las pruebas con varias opciones:

      1. todas las pruebas en la apk

        adb shell am instrument -w com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      2. 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
        
      3. 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
        
      4. 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:

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