À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

Conteneur pour la configuration de l'exécution du test. Cette classe est une aide pour préparer et exécuter les tests.

Résumé

Champs
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_ID` ID de module : nom qui permettra d'identifier de manière unique le module lors de testRunStart.
`public static final String`	`MODULE_ISOLATED` Cette propriété est définie sur "true" si le module s'exécutait sur un appareil fraîchement préparé.
`public static final String`	`MODULE_NAME` Le nom du module est le nom de base associé au module, généralement issu du fichier de configuration TF XML à partir duquel le module a été chargé.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Constructeurs publics
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Constructeur
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Constructeur

Méthodes publiques
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` Renvoie le nom unique du module.
`IInvocationContext`	`getModuleInvocationContext()` Renvoie l'`IInvocationContext` associé au module.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Indique le temps approximatif nécessaire pour exécuter tous les tests du module.
`boolean`	`hasModuleFailed()` Renvoie "True" si une méthode testRunFailure a été appelée sur le module.
`int`	`numTests()` Renvoie le nombre actuel de `IRemoteTest` en attente d'exécution.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Signalez les modules complètement non exécutés.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` Exécutez tous les `IRemoteTest` contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` Exécutez tous les `IRemoteTest` contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` Exécutez tous les `IRemoteTest` contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` Exécutez les préparateurs du test, y compris les préparateurs au niveau de la suite, le cas échéant.
`void`	`setBuild(IBuildInfo build)` Injectez le `IBuildInfo` à utiliser pendant les tests.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Active ou désactive le mode de collecte des tests
`void`	`setDevice(ITestDevice device)` Injectez le `ITestDevice` à utiliser lors des tests.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Indique si le téléchargement dynamique doit être activé ou non au niveau du module.
`void`	`setLogSaver(ILogSaver logSaver)` Transmettez l'outil de sauvegarde du journal d'appel au module afin qu'il puisse l'utiliser si nécessaire.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Définit si les résultats doivent être fusionnés ou non.
`void`	`setMetricCollectors( collectors)` Injectez la liste des `IMetricCollector` à utiliser par le module.
`final void`	`setRetryDecision(IRetryDecision decision)` Définit le `IRetryDecision` à utiliser pour les nouvelles tentatives intra-module.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Copier certains paramètres au niveau de la suite

Méthodes protégées
`boolean`	`hasTests()` Renvoie la valeur "True" si le module a encore des `IRemoteTest` à exécuter dans son pool.

Champs

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_ID

public static final String MODULE_ID

ID de module : nom qui permettra d'identifier de manière unique le module lors de testRunStart. Il s'agit généralement d'une combinaison de MODULE_ABI + MODULE_NAME.

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Cette propriété est définie sur "true" si le module s'exécutait sur un appareil fraîchement préparé.

MODULE_NAME

public static final String MODULE_NAME

Le nom du module est le nom de base associé au module, généralement issu du fichier de configuration TF XML à partir duquel le module a été chargé.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

PREPARATION_TIME

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Constructeurs publics

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Constructeur

Paramètres
`name`	`String`: nom unique de la configuration de test.
`tests`	: liste des `IRemoteTest` à exécuter.
`preparersPerDevice`	: liste des `ITargetPreparer` à utiliser pour configurer l'appareil.
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` de la configuration du module sous-jacent.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Constructeur

Paramètres
`name`	`String`: nom unique de la configuration de test.
`tests`	: liste des `IRemoteTest` à exécuter.
`preparersPerDevice`	: liste des `ITargetPreparer` à utiliser pour configurer l'appareil.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` de la configuration du module sous-jacent.

Méthodes publiques

compareTo

public int compareTo (ModuleDefinition moduleDef)

Paramètres
`moduleDef`	`ModuleDefinition`

Renvoie
`int`

getId

public String getId ()

Renvoie le nom unique du module.

Renvoie
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Renvoie l'IInvocationContext associé au module.

Renvoie
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens ()

Renvoie

getRuntimeHint

public long getRuntimeHint ()

Indique le temps approximatif nécessaire pour exécuter tous les tests du module.

Renvoie
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Renvoie "True" si une méthode testRunFailure a été appelée sur le module.

Renvoie
`boolean`

numTests

public int numTests ()

Renvoie le nombre actuel de IRemoteTest en attente d'exécution.

Renvoie
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Signalez les modules complètement non exécutés.

Paramètres
`listener`	`ITestInvocationListener`
`message`	`String`

Exécuter

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener)

Exécutez tous les IRemoteTest contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.

Paramètres
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener` où signaler les résultats.
`moduleLevelListeners`	: liste des écouteurs au niveau du module.
`failureListener`	`TestFailureListener`: écouteur particulier pour collecter les journaux sur testFail. Peut être null.

Génère
`DeviceNotAvailableException`	en cas de mise hors connexion de l'appareil.

Exécuter

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Exécutez tous les IRemoteTest contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.

Paramètres
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener` où signaler les résultats.

Génère
`DeviceNotAvailableException`	en cas de mise hors connexion de l'appareil.

Exécuter

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener, 
                int maxRunLimit)

Exécutez tous les IRemoteTest contenus dans le module et utilisez tous les préparateurs avant et après pour configurer et nettoyer l'appareil.

Paramètres
`moduleInfo`	`TestInformation`: `TestInformation` du module.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` où signaler les résultats.
`moduleLevelListeners`	: liste des écouteurs au niveau du module.
`failureListener`	`TestFailureListener`: écouteur particulier pour collecter les journaux sur testFail. Peut être null.
`maxRunLimit`	`int`: nombre maximal d'exécutions pour chaque test.

Génère
`DeviceNotAvailableException`	en cas de mise hors connexion de l'appareil.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Exécutez les préparateurs du test, y compris les préparateurs au niveau de la suite, le cas échéant.

Paramètres
`includeSuitePreparers`	`boolean`: définissez cette valeur sur `true` pour exécuter également les préparateurs au niveau de la suite.

Renvoie
`Throwable`	`Throwable` de toute exception générée lors de l'exécution des préparateurs.

setBuild

public void setBuild (IBuildInfo build)

Injectez le IBuildInfo à utiliser pendant les tests.

Paramètres
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Active ou désactive le mode de collecte des tests

setDevice

public void setDevice (ITestDevice device)

Injectez le ITestDevice à utiliser pendant les tests.

Paramètres
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Indique si le téléchargement dynamique doit être activé ou non au niveau du module.

Paramètres
`enableDynamicDownload`	`boolean`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Transmettez l'outil de sauvegarde du journal d'appel au module afin qu'il puisse l'utiliser si nécessaire.

Paramètres
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Définit si les résultats doivent être fusionnés ou non.

Paramètres
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

Injectez la liste des IMetricCollector à utiliser par le module.

Paramètres
`collectors`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Définit le IRetryDecision à utiliser pour les nouvelles tentatives intra-module.

Paramètres
`decision`	`IRetryDecision`

toString

public String toString ()

Renvoie
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copier certains paramètres au niveau de la suite

Paramètres
`mSuiteConfiguration`	`IConfiguration`

Méthodes protégées

hasTests

protected boolean hasTests ()

Renvoie la valeur "True" si le module a encore des IRemoteTest à exécuter dans son pool. Sinon, cette valeur est "false".

Renvoie
`boolean`