À 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 automatisés (Android 11 ou version ultérieure)

Deux options s'offrent à vous pour exécuter les 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 les 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 savoir comment exécuter des tests à l'aide d'OmniLab Android Test Harness, consultez OmniLab Android Test Station.

Exécuter tous les tests CTS automatisés

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

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 multi-appareils. Ces tests ne s'exécutent automatiquement que lorsque le partitionnement est utilisé. Pour en savoir plus sur le partitionnement, consultez Améliorer le temps d'exécution des tests. Si vous souhaitez exécuter ces tests manuellement, consultez Exécuter des tests multidétecteurs.
- Chaque fois que vous exécutez CTS, appuyez sur ctrl+c pour arrêter la console CTS existante, puis réexécutez la console CTS.
- Vous ne pouvez pas exécuter plusieurs versions CTS sur un même hôte, car chacune s'ouvre avec un serveur de code de localisation ouvert (OLC) existant.
Affichez les résultats du test. Pour en savoir plus, consultez Interpréter les résultats du CTS.
Si c'est votre premier test, il est possible que certains tests échouent en raison de problèmes indépendants de votre volonté. Par exemple, une connexion réseau peut être lente ou un signal GPS peut être faible. Relancez (réessayez) les tests jusqu'à ce que tous les modules de test soient terminés et que le nombre d'échecs de test soit le même entre les deux dernières sessions de relance :
```
run retry --retry session_number`
```
Remarque : Pour en savoir plus sur l'implémentation de la réexécution CTS, consultez Utiliser la réexécution de la suite.
Remarque : Pour savoir comment exécuter une session de réexécution sur Android 10 ou version antérieure, consultez Exécuter des tests CTS automatisés (AOSP 10 ou version antérieure).
Si les échecs de tests sont cohérents lors des nouvelles tentatives, concentrez-vous sur le débogage des tests ayant échoué. Pour savoir comment résoudre les problèmes liés aux résultats des tests, consultez Trier les échecs des tests et Résoudre les problèmes liés aux tests CTS.

Exécuter le CTS pour les appareils multiscreen

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 écran alternatif sont ajoutés à la valeur de display_mode, par exemple testcase1[display_mode=0].

Exécuter des tests multidétecteurs (Android 15 ou version antérieure)

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 se 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 CTS automatisés (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 sharding nécessite que l'hôte connecte au moins deux appareils, mais six appareils ou plus sont recommandés pour l'efficacité.

Pour fragmenter les tests sur Android 11 ou version ultérieure, exécutez la commande suivante :

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 en utilisant la commande CTS run cts-dev. 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 exécute également les tests sur une seule ABI.