À 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.

Configurer des suites

Dans Tradefed, une suite fait référence à une configuration dans laquelle plusieurs tests sont exécutés sous un exécuteur de test commun qui pilote l'exécution globale.

Dans Tradefed, les suites sont gérées par la classe ITestSuite, qui permet d'ajouter et de supprimer des tests indépendamment de la façon dont ils sont exécutés.

Définitions

Suite : ensemble de modules de test configurés pour s'exécuter sous une même configuration de niveau supérieur afin de signaler leurs résultats sous une seule invocation.
Configuration de premier niveau : configuration appliquée aux appareils avant l'exécution de l'un des modules de test.
Configuration principale : configuration XML Tradefed au niveau de la suite qui décrit les modules à exécuter et la configuration de premier niveau à utiliser.
Configuration au niveau du module : configuration appliquée aux appareils juste avant l'exécution du module. Il s'agit également de configurations spécifiques aux modules.
Configuration du module : fait référence à la configuration XML AndroidTest.xml Tradefed qui décrit les modules et la configuration au niveau du module à effectuer.
Module : unité de test composée d'une étape de configuration (configuration au niveau du module), d'une étape d'exécution du test et d'une étape de démontage.
Nouvelle tentative au sein du module : nouvelle tentative automatique effectuée par le harnais à l'intérieur du module.
Nouvelle tentative d'exécution de la suite : réexécution complète des tests de la suite qui ont échoué précédemment.

Structure ITestSuite

Dans Tradefed, ITestSuite fait référence à la classe de base commune qui pilote l'exécution d'une suite. Il est partagé par toutes les principales suites de tests, en particulier la suite de tests de compatibilité Android (CTS) et la suite de tests du fournisseur Android (VTS), et garantit une expérience d'exécution cohérente dans toutes les suites.

Nous appelons parfois ITestSuite le lanceur de suite.

Le lanceur de suite suit les étapes suivantes lors de l'exécution :

Chargez la configuration du module et déterminez quel ensemble doit s'exécuter.
Exécutez chaque module :
1. Exécutez la configuration au niveau du module.
2. Exécutez les tests de module.
3. Exécutez la suppression au niveau du module.
Signalez les résultats.

Configuration de premier niveau

Du point de vue de Tradefed, ITestSuite n'est qu'un test parmi d'autres. Il s'agit d'un test complexe, mais qui reste un test comme les autres IRemoteTest. Ainsi, lorsque vous spécifiez le lanceur de suite dans une configuration Tradefed, Tradefed suit le schéma habituel de la configuration : exécution de build_provider, target_preparer, test (notre suite dans ce cas) et target_cleaner.

Cette séquence dans la configuration Tradefed contenant ITestSuite est la configuration de premier niveau.

Exemple :

<configuration description="Common config for Compatibility suites">

    <build_provider class="com.android.compatibility.common.tradefed.build.CompatibilityBuildProvider" />
    <!-- Setup applied before the suite: so everything running in the suite will
    have this setup beforehand -->
    <target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
        <option name="run-command" value="settings put global package_verifier_enable 0" />
        <option name="teardown-command" value="settings put global package_verifier_enable 1"/>
    </target_preparer>

    <!-- Our ITestSuite implementation -->
    <test class="com.android.compatibility.common.tradefed.testtype.suite.CompatibilityTestSuite" />

    <result_reporter class="com.android.compatibility.common.tradefed.result.ConsoleReporter" />
</configuration>

Métadonnées du module

Nous appelons métadonnées du module les informations supplémentaires spécifiées dans le module de test AndroidTest.xml. Ces métadonnées vous permettent de spécifier des informations supplémentaires sur le module, et les modules peuvent être filtrés à l'aide des métadonnées.

Exemple de métadonnées :

<option name="config-descriptor:metadata" key="component" value="framework" />
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />

Exemple de filtre sur les métadonnées :

--module-metadata-include-filter component=framework

La commande ci-dessus exécuterait tous les modules avec un framework comme métadonnées component.

Exemple complet de AndroidTest.xml :

<configuration description="Config for CTS Gesture test cases">
    <option name="test-suite-tag" value="cts" />
    <!-- Metadata -->
    <option name="config-descriptor:metadata" key="component" value="framework" />
    <option name="config-descriptor:metadata" key="parameter" value="instant_app" />
    <!-- End: metadata -->
    <target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
        <option name="cleanup-apks" value="true" />
        <option name="test-file-name" value="CtsGestureTestCases.apk" />
    </target_preparer>
    <test class="com.android.tradefed.testtype.AndroidJUnitTest" >
        <option name="package" value="android.gesture.cts" />
        <option name="runtime-hint" value="10m50s" />
    </test>
</configuration>

Module paramétré

parameter est un type de métadonnées spécial.

<option name="config-descriptor:metadata" key="parameter" value="instant_app" />

Ces métadonnées indiquent que le module doit être exécuté dans un mode différent, par exemple en tant qu'application instantanée, au lieu d'un mode d'application standard.

Tous les modes ou paramètres possibles sont décrits par ModuleParameters et ont un gestionnaire associé dans ModuleParametersHelper qui vous permet de modifier la configuration du module pour qu'il s'exécute dans le mode spécifique.

Par exemple, le mode Application instantanée force l'installation de l'APK en mode instantané.

Pour que la paramétrisation ait lieu, la ligne de commande doit l'activer avec :

--enable-parameterized-modules

Il est également possible d'exécuter un seul mode donné avec :

--enable-parameterized-modules --module-parameter <Mode>

--enable-parameterized-modules --module-parameter INSTANT_APP

Lorsqu'une version paramétrée d'un module s'exécute, elle indique ses résultats sous un nom de module paramétré, par exemple CtsGestureTestCases[instant] au lieu de la base CtsGestureTestCases.