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

Définition du module

public class ModuleDefinition
extends Object implements ITestCollector

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

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

Résumé

Des champs
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` Cette propriété est définie sur true si les résultats du module de test ont été mis en cache.
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` ID du module : le nom qui sera utilisé pour 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, provenant généralement du fichier de configuration Xml TF à partir duquel le module a été chargé.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`MODULE_TEST_COUNT`
`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`	`SPARSE_MODULE` Cette propriété est définie sur true si seuls les événements au niveau du module sont signalés.
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Constructeurs publics
`ModuleDefinition ()`
`ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Constructeur
`ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `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.
`IConfiguration`	`getModuleConfiguration ()`
`IInvocationContext`	`getModuleInvocationContext ()` Renvoie le `IInvocationContext` associé au module.
	`getRequiredTokens ( TestInformation testInfo)`
`long`	`getRuntimeHint ()` Renvoie la durée approximative d'exécution de tous les tests du module.
`boolean`	`hasModuleFailed ()` Renvoie True si un testRunFailure a été appelé sur le module *
`int`	`neededDevices ()` Renvoie le nombre d'appareils censés exécuter ce test.
`int`	`numTests ()` Renvoie le nombre actuel d' `IRemoteTest` en attente d'exécution.
`final void`	`reportNotExecuted ( ITestInvocationListener listener, String message)` Signaler les modules complètement non exécutés.
`final void`	`run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` `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.
`final void`	`run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` `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.
`Throwable`	`runPreparation (boolean includeSuitePreparers)` Exécutez les préparateurs du test, y compris les préparateurs de niveau suite si spécifié.
`void`	`setBuild ( IBuildInfo build)` Injectez le `IBuildInfo` à utiliser lors des tests.
`void`	`setCollectTestsOnly (boolean collectTestsOnly)` Active ou désactive le mode de collecte de tests
`void`	`setDevice ( ITestDevice device)` Injectez le `ITestDevice` à utiliser lors des tests.
`void`	`setEnableDynamicDownload (boolean enableDynamicDownload)` S'il faut ou non activer le téléchargement dynamique au niveau du module.
`void`	`setLogSaver ( ILogSaver logSaver)` Transmettez l'économiseur de journal d'invocation au module afin qu'il puisse l'utiliser si nécessaire.
`final void`	`setMergeAttemps (boolean mergeAttempts)` Définit si nous devons ou non fusionner les résultats.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Injectez la liste des `IMetricCollector` à utiliser par le module.
`void`	`setRecoverVirtualDevice (boolean recoverVirtualDevice)` Les ensembles doivent récupérer le périphérique virtuel.
`final void`	`setRetryDecision ( IRetryDecision decision)` Définit le `IRetryDecision` à utiliser pour la nouvelle tentative intra-module.
`boolean`	`shouldRecoverVirtualDevice ()` Renvoie si nous devons récupérer le périphérique virtuel.
`String`	`toString ()`
`void`	`transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)` Copiez quelques-unes de la configuration au niveau de la suite

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

Des champs

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

Cette propriété est définie sur true si les résultats du module de test ont été mis en cache.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

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

MODULE_ISOLÉ

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, provenant généralement du fichier de configuration Xml TF à partir duquel le module a été chargé.

MODULE_PARAMETERISATION

public static final String MODULE_PARAMETERIZATION

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

TEMPS DE PRÉPARATION

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

SPARSE_MODULE

public static final String SPARSE_MODULE

Cette propriété est définie sur true si seuls les événements au niveau du module sont signalés.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEMPS DE TEST

public static final String TEST_TIME

Constructeurs publics

Définition du module

public ModuleDefinition ()

Définition du module

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` qui doivent être exécutés.
`preparersPerDevice`	: liste des `ITargetPreparer` à utiliser pour configurer l'appareil.
`multiPreparers`
`moduleConfig`	`IConfiguration` : l' `IConfiguration` de la configuration du module sous-jacent.

Définition du module

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` qui doivent être exécutés.
`preparersPerDevice`	: liste des `ITargetPreparer` à utiliser pour configurer l'appareil.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration` : l' `IConfiguration` de la configuration du module sous-jacent.

Méthodes publiques

comparer aux

public int compareTo (ModuleDefinition moduleDef)

Paramètres
`moduleDef`	`ModuleDefinition`

Retour
`int`

obtenirId

public String getId ()

Renvoie le nom unique du module.

Retour
`String`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Retour
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Renvoie le IInvocationContext associé au module.

Retour
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Paramètres
`testInfo`	`TestInformation`

Retour

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée approximative d'exécution de tous les tests du module.

Retour
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Renvoie True si un testRunFailure a été appelé sur le module *

Retour
`boolean`

Appareils nécessaires

public int neededDevices ()

Renvoie le nombre d'appareils censés exécuter ce test.

Retour
`int`

numTests

public int numTests ()

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

Retour
`int`

rapportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

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

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

courir

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` : les `TestInformation` du module.
`listener`	`ITestInvocationListener` : le `ITestInvocationListener` où rapporter les résultats.
`moduleLevelListeners`	: La liste des auditeurs au niveau du module.
`failureListener`	`TestFailureListener` : un écouteur particulier pour collecter les logs sur testFail. Peut être nul.
`maxRunLimit`	`int` : le nombre maximum d'exécutions pour chaque scénario de test.

Jetés
`DeviceNotAvailableException`	en cas de mise hors ligne de l'appareil.

courir

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` : le `ITestInvocationListener` où rapporter les résultats.
`moduleLevelListeners`	: La liste des auditeurs au niveau du module.
`failureListener`	`TestFailureListener` : un écouteur particulier pour collecter les logs sur testFail. Peut être nul.

Jetés
`DeviceNotAvailableException`	en cas de mise hors ligne de l'appareil.

courir

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` : le `ITestInvocationListener` où rapporter les résultats.

Jetés
`DeviceNotAvailableException`	en cas de mise hors ligne de l'appareil.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Exécutez les préparateurs du test, y compris les préparateurs de niveau suite si spécifié.

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

Retour
`Throwable`	`Throwable` toute exception levée lors de l'exécution des préparateurs.

setBuild

public void setBuild (IBuildInfo build)

Injectez le IBuildInfo à utiliser lors des tests.

Paramètres
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Active ou désactive le mode de collecte de tests

définirDevice

public void setDevice (ITestDevice device)

Injectez le ITestDevice à utiliser lors des tests.

Paramètres
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

S'il faut ou non activer le téléchargement dynamique au niveau du module.

Paramètres
`enableDynamicDownload`	`boolean`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Transmettez l'économiseur de journal d'invocation 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 nous devons ou non fusionner les résultats.

Paramètres
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

Injectez la liste des IMetricCollector à utiliser par le module.

Paramètres
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Les ensembles doivent récupérer le périphérique virtuel.

Paramètres
`recoverVirtualDevice`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Définit le IRetryDecision à utiliser pour la nouvelle tentative intra-module.

Paramètres
`decision`	`IRetryDecision`

devraitRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Renvoie si nous devons récupérer le périphérique virtuel.

Retour
`boolean`

versChaîne

public String toString ()

Retour
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copiez quelques-unes de la configuration au niveau de la suite

Paramètres
`mSuiteConfiguration`	`IConfiguration`

Méthodes protégées

aTests

protected boolean hasTests ()

Renvoie True si le module a toujours IRemoteTest à exécuter dans son pool. Faux sinon.

Retour
`boolean`