Tests d'instrumentation

Commencez par lire Tester votre application sur developer.android.com. Notez que la façon dont les tests d'instrumentation sont utilisés dans les tests de plate-forme présente quelques différences.

En résumé, un test d'instrumentation fournit un environnement d'exécution de test spécial lancé via la commande am instrument, où le processus d'application ciblé est redémarré et initialisé avec un contexte d'application de base, et un thread d'instrumentation est lancé dans la VM du processus d'application. Votre code de test démarre l'exécution sur ce thread d'instrumentation et est fourni avec une instance Instrumentation qui fournit un accès au contexte de l'application et aux API pour manipuler le processus d'application testé.

Concepts clés

• Une instrumentation doit être déclarée dans un package d'application, avec une balise <instrumentation> imbriquée sous la balise <manifest> du fichier manifeste du package d'application.
• Un fichier manifeste de package d'application peut techniquement contenir plusieurs balises <instrumentation>, bien qu'il ne soit pas couramment utilisé de cette manière.
• Chaque <instrumentation> doit contenir les éléments suivants :
  • un attribut android:name: il doit s'agir du nom d'une sous-classe de Instrumentation incluse dans l'application de test, qui est généralement le lanceur de test utilisé, par exemple : android.support.test.runner.AndroidJUnitRunner
  • Vous devez définir un attribut android:targetPackage. Sa valeur doit être définie sur le package d'application testé.

Résumé des étapes

1. Vous trouverez ci-dessous des destinations courantes pour les tests hermétiques de services de framework:

   frameworks/base/core/tests/coretests
   frameworks/base/services/tests/servicestests
   

   Si vous ajoutez un tout nouveau module d'instrumentation pour votre composant, consultez

   • Tests d'instrumentation automatique: un exemple complet
   • Instrumentation ciblant une application: un exemple complet

2. Suivez la convention existante si vous ajoutez des tests dans l'un des emplacements ci-dessus. Si vous configurez un nouveau module de test, veuillez suivre la configuration de AndroidManifest.xml et Android.mk dans l'un des emplacements ci-dessus.

3. Pour obtenir un exemple, consultez frameworks/base/core/tests/coretests/. Notez que ces lignes installent des applications supplémentaires:

   <option name="test-file-name" value="FrameworksCoreTests.apk" />
   <option name="test-file-name" value="BstatsTestApp.apk" />
   

4. N'oubliez pas de marquer votre test comme @SmallTest, @MediumTest ou @LargeTest

5. Créez le module de test avec m, par exemple :

   m FrameworksCoreTests
   

6. Exécutez les tests:

   • La solution la plus simple consiste à utiliser Atest comme suit:

     atest FrameworksCoreTests
     

   • Pour des tests plus complexes, utilisez le harnais de test de la Trade Federation:

   m tradefed-all
   tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
   

7. Si vous n'utilisez pas Tradefed, installez et exécutez manuellement les tests:

   1. Installez l'APK généré:

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

   Conseil :Vous pouvez utiliser adb shell pm list instrumentation pour trouver les instrumentations dans l'APK que vous venez d'installer.

   1. Exécutez les tests avec différentes options:

      1. tous les tests de l'APK

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

      2. tous les tests d'un package Java spécifique

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

      3. tous les tests d'une classe spécifique ;

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

      4. une méthode de test spécifique

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

Votre test peut effectuer une assertion explicite sur la réussite ou l'échec à l'aide des API JUnit. De plus, toute exception non détectée entraînera également une défaillance fonctionnelle.

Pour émettre des métriques de performances, votre code de test peut appeler Instrumentation#sendStatus pour envoyer une liste de paires clé-valeur. Il est important de noter que:

1. Les métriques peuvent être des entiers ou des nombres à virgule flottante.
2. Les valeurs non numériques seront supprimées.
3. Votre APK de test peut être un test fonctionnel ou un test de métriques. Toutefois, le mélange des deux n'est pas actuellement pris en charge.