Tester le code de la plate-forme avec atest

Android Studio for Platform (ASfP) s'intègre à l'outil de ligne de commande atest, ce qui vous permet d'exécuter des tests sur votre appareil ou émulateur connecté directement depuis l'IDE.

Prérequis

  • Ouvrez un projet ASfP avec votre code source AOSP.
  • Compilez et flashez votre code sur un appareil ou un émulateur.
  • Initialisez votre environnement de compilation à l'aide de source build/envsetup.sh et lunch.

Exécuter des tests

Vous pouvez exécuter des tests à l'aide de atest dans ASfP de plusieurs manières :

  • Icônes d'exécution dans la marge : cliquez sur l'icône Exécuter .

    à côté d'une classe ou d'une méthode de test dans l'éditeur pour exécuter ce test spécifique.

  • Menu contextuel : effectuez un clic droit sur un fichier de test, une classe ou une méthode dans la fenêtre "Project" (Projet) ou l'éditeur, puis sélectionnez Run 'atest' (Exécuter "atest").

  • Utiliser le terminal : ouvrez le terminal intégré dans ASfP (Afficher > Fenêtres d'outil > Terminal), puis exécutez directement les commandes atest. Exemple : bash atest MyTestModule atest MyTestClass#myTestMethod

Afficher les résultats des tests

Les résultats des tests s'affichent dans la fenêtre d'outil Exécuter d'ASfP. Cette fenêtre affiche la progression du test, son état (réussite ou échec), ainsi que les journaux et les résultats de chaque test.

Configurations de test

Lorsque vous exécutez un test à partir de la marge ou du menu contextuel, ASfP crée automatiquement une configuration d'exécution ou de débogage temporaire. Vous pouvez modifier et enregistrer ces configurations pour exécuter à nouveau rapidement des tests avec des options ou des indicateurs spécifiques :

  1. Accédez à Run > Edit Configurations (Exécuter > Modifier les configurations).
  2. Recherchez la configuration atest que vous souhaitez modifier ou créez-en une en cliquant sur le bouton +, puis en sélectionnant atest.
  3. Spécifiez le module de test, la classe et la méthode, et ajoutez les options de ligne de commande atest nécessaires.

Conseils pour les tests

  • Tests ciblés : exécutez uniquement les tests spécifiques dont vous avez besoin pour gagner du temps. Utilisez le format Module:Class#Method ou d'autres filtres atest.
  • Utilisez les instantanés de l'émulateur : pour exécuter les tests plus rapidement sur les émulateurs, envisagez d'utiliser des instantanés pour revenir rapidement à un état stable connu.
  • Vérifiez les journaux : utilisez les journaux de la fenêtre d'outil Exécuter pour diagnostiquer les échecs de tests.