Tester le code de la plate-forme avec atest
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 play_circle.
à 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 :
- Accédez à Run > Edit Configurations (Exécuter > Modifier les configurations).
- Recherchez la configuration
atest que vous souhaitez modifier ou créez-en une en cliquant sur le bouton +, puis en sélectionnant atest.
- 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.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[],[],null,["Android Studio for Platform (ASfP) integrates with the `atest` command-line\ntool, letting you run tests on your connected device or emulator directly from\nthe IDE.\n\nPrerequisites\n\n- Open an ASfP project with your AOSP source code.\n- Successfully build and flash your code to a device or emulator.\n- Initialize your build environment using `source build/envsetup.sh` and `lunch`.\n\nRun tests\n\nYou can run tests using `atest` in ASfP in several ways:\n\n- **Gutter run icons:** Click the **Run** icon play_circle\n\n next to a test class or method in the editor to run that specific test.\n- **Right-click menu:** Right-click on a test file, class, or method in the\n Project window or editor and select **Run 'atest'**.\n\n- **Using the terminal:** Open the integrated terminal in ASfP (**View \\\u003e Tool\n Windows \\\u003e Terminal** ) and run `atest` commands directly. For example: `bash\n atest MyTestModule\n atest MyTestClass#myTestMethod`\n\nView test results\n\nTest results are displayed in the **Run** tool window within ASfP. This window\nshows the test progress, pass or fail status, and provides logs and output for\neach test.\n\nTest configurations\n\nWhen you run a test from the gutter or right-click menu, ASfP automatically\ncreates a temporary run or debug configuration. You can modify and save these\nconfigurations to quickly re-run tests with specific options or flags:\n\n1. Go to **Run \\\u003e Edit Configurations**.\n2. Find the `atest` configuration you want to modify or create a new one by clicking the **+** button and selecting **atest**.\n3. Specify the test module, class, method, and add any necessary `atest` command-line options.\n\nTips for testing\n\n- **Targeted testing:** Run only the specific tests you need to save time. Use the format `Module:Class#Method` or other `atest` filters.\n- **Use emulator snapshots:** For faster test runs on emulators, consider using snapshots to quickly revert to a known good state.\n- **Check logs:** Use the logs in the **Run** tool window to diagnose any test failures."]]
