À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

Exécuter des tests CTS automatisés (Android 11 ou version ultérieure)
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous avez le choix entre deux options pour exécuter des tests automatisés CTS:

Trade Federation est un framework d'application et de test qui vous permet d'exécuter des tests à partir de la ligne de commande. Fondamentalement, le framework vous permet d'annoter des tests à l'aide de l'annotation @Test, et l'application trouve et exécute ces tests.
OmniLab Android Test Station est une application qui vous permet d'exécuter des tests dans une IUG.

Cette page explique comment exécuter des tests automatisés à l'aide de Trade Federation. Pour obtenir des instructions sur l'exécution de tests à l'aide du banc d'essai Android OmniLab, consultez la section Station de test Android OmniLab.

Exécuter tous les tests CTS automatisés

La Trade Federation contient la console CTS, une interface de ligne de commande permettant d'exécuter des tests. Pour exécuter l'ensemble de tests CTS automatisé complet:

Assurez-vous d'avoir suivi les instructions de la section Configurer les tests automatisés CTS.
Sur votre station de travail de test, lancez la console CTS en exécutant le script cts-tradefed à partir du dossier dans lequel le package CTS a été décompressé:
```
./android-cts/tools/cts-tradefed
```
La console CTS affiche un curseur pour vous permettre de saisir des commandes CTS (cts-tradefed >).
Le plan de test cts contient tous les tests CTS automatisés. Exécutez la commande suivante pour exécuter le plan de test cts:
```
run cts
```
Les tests CTS automatisés s'exécutent. Remarques :
- Android 13 et versions ultérieures sont compatibles avec les tests multiappareils. Ces tests ne s'exécutent automatiquement que lorsque le sharding est utilisé. Pour en savoir plus sur le sharding, consultez Améliorer le temps d'exécution des tests. Si vous souhaitez exécuter ces tests manuellement, consultez Exécuter des tests multiappareils.
- Chaque fois que vous exécutez CTS, appuyez sur Ctrl+C pour arrêter la console CTS existante, puis exécutez à nouveau la console CTS.
- Vous ne pouvez pas exécuter plusieurs versions de CTS sur un même hôte, car chacune s'ouvre avec un serveur de code d'emplacement ouvert (OLC) existant.
Afficher les résultats du test. Pour en savoir plus, consultez Interpréter les résultats du CTS.
S'il s'agit de votre premier test, il est possible que certains échouent en raison de problèmes hors de votre contrôle. Par exemple, une connexion réseau peut être lente ou un signal GPS peut être faible. Relancez les tests jusqu'à ce que tous les modules de test soient terminés et que le nombre d'échecs des tests soit le même entre les deux dernières sessions de nouvelle tentative:
```
run retry --retry session_number`
```
Remarque:Pour en savoir plus sur l'implémentation de la nouvelle fonctionnalité de nouvelle tentative CTS, consultez la section Utiliser la nouvelle tentative de la suite.
Remarque:Pour savoir comment exécuter une session de nouvelle tentative sur Android 10 ou version antérieure, consultez la section Exécuter des tests automatisés CTS (AOSP 10 ou version antérieure).
Une fois que les échecs des tests sont cohérents entre les tentatives, concentrez-vous sur le débogage des tests restants. Pour en savoir plus sur le dépannage des résultats des tests, consultez les pages Trier les échecs des tests et Résoudre les problèmes liés aux tests CTS.

Exécuter le CTS pour les appareils multiécrans

Si votre appareil fonctionne sous Android 11 ou 12 et qu'il comporte plusieurs écrans, vous devez exécuter le plan de test cts-foldable séparément:

run cts-foldable

Les scénarios de test réussis ou échoués pour le mode d'écran alternatif sont ajoutés à la valeur de display_mode, par exemple testcase1[display_mode=0].

Exécuter des tests multiappareils

Exécutez la commande suivante pour exécuter le plan de test cts-multidevice:

run cts-multidevice

Exécuter des plans de test individuels

Au lieu d'exécuter tous les plans de test en même temps, vous pouvez exécuter des plans de test individuels. Cette option est utile pour gagner du temps et vous concentrer sur un ensemble de tests spécifique. Pour exécuter un plan de test individuel:

Identifiez le nom du plan de test que vous souhaitez exécuter en exécutant la commande list modules.

Remarque :Pour savoir comment identifier le module sur Android 10 ou version antérieure, consultez Exécuter des tests automatisés CTS (Android 10 ou version antérieure).

Exécutez le plan de test:

run cts --plan test_module_or_plan_name

Améliorer le temps d'exécution des tests

Si vous souhaitez améliorer le temps d'exécution des tests, vous pouvez les répartir sur plusieurs appareils. Le fractionnement nécessite que l'hôte connecte au moins deux appareils, mais six appareils ou plus sont recommandés pour plus d'efficacité.

Pour fractionner des tests sur Android 11 ou version ultérieure, exécutez:

run cts --shard-count number_of_shards

De plus, avant d'exécuter vos tests de validation, vous pouvez améliorer le temps d'exécution des tests à l'aide de la commande run cts-dev du CTS. Cette commande ignore les conditions préalables, la collecte d'informations sur l'appareil et tous les vérificateurs d'état du système. Il n'exécute également les tests que sur une seule ABI.