Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest , IDeviceTest , IMultiDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest en implements IRemoteTest , IDeviceTest , IMultiDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest

java.lang.Object
com.android.tradefed.testtype.suite.ITestSuite


Classe abstraite utilisée pour exécuter Test Suite. Cette classe fournit la base de la manière dont la Suite sera exécutée. Chaque implémentation peut définir la liste des tests via la méthode loadTests() .

Résumé

Classes imbriquées

enum ITestSuite.RetryStrategy

Stratégie de nouvelle tentative à utiliser lors de la réexécution de certains tests.

Des champs

public static final String ABI_OPTION

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

Constructeurs publics

ITestSuite ()

Méthodes publiques

void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
getAbis ( ITestDevice device)

Obtient l'ensemble des ABI pris en charge par les tests de compatibilité AbiUtils#getAbisSupportedByCompatibility() et le périphérique testé.

IBuildInfo getBuildInfo ()

La mise en œuvre d' ITestSuite peut nécessiter les informations de construction pour charger les tests.

ITestDevice getDevice ()

Faites tester l'appareil.

ModuleDefinition getDirectModule ()

Renvoie le ModuleDefinition à exécuter directement, ou null s'il n'y en a pas encore (lorsque l'ITestSuite n'a pas encore été partitionnée).

final String getRequestedAbi ()

Renvoie l'abi demandé avec l'option -a ou --abi.

getRequiredTokens ()

Renvoie la liste des jetons requis par le test.

long getRuntimeHint ()

Renvoie la durée d'exécution attendue du test en millisecondes.

abstract loadTests ()

Méthode abstraite pour charger la configuration des tests qui sera exécutée.

void reportNotExecuted ( ITestInvocationListener listener, String message)

Signalez les tests non exécutés à l'auditeur principal fourni.

void reportNotExecuted ( ITestInvocationListener listener)

Signalez les tests non exécutés à l'auditeur principal fourni.

final void run ( ITestInvocationListener listener)

Méthode d'exécution générique pour tous les tests chargés depuis loadTests() .

void setAbiName (String abiName)

Définissez la valeur de mAbiName

void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

Exécutez la suite de tests en mode collecteur uniquement, cela nécessite que tous les sous-tests implémentent également cette interface.

void setConfiguration ( IConfiguration configuration)

Injecte l' IConfiguration en cours d'utilisation.

void setDevice ( ITestDevice device)

Injectez l'appareil à tester.

void setDeviceInfos ( deviceInfos) setDeviceInfos ( deviceInfos)

void setInvocationContext ( IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

Obtenez l' Injector de guice actuel à partir de l'invocation.

final void setMaxRunLimit (int maxRunLimit)

Définissez le nombre maximal de tentatives d'exécution pour chaque module.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour le test.

void setPrimaryAbiRun (boolean primaryAbiRun)

Définir la valeur de mPrimaryAbiRun

void setShouldMakeDynamicModule (boolean dynamicModule)

Lors du partage distribué, nous ne pouvons pas avoir ModuleDefinition qui partage les tests dans un pool sinon le sharding intra-module ne fonctionnera pas, nous autorisons donc à le désactiver.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

Définit les ISystemStatusChecker partir de la configuration pour le test.

split (int shardCountHint)

Version alternative de split() qui fournit également le shardCount qui est tenté d'être exécuté.

Méthodes protégées

createModuleListeners ()

Renvoie la liste de ITestInvocationListener applicable au niveau ModuleListener .

boolean filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)

Appliquez le filtre de métadonnées à la configuration et voyez si la configuration doit s'exécuter.

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

Appliquez le filtrage de la liste blanche des coureurs, en supprimant tout coureur qui n'était pas sur la liste blanche.

getAbisForBuildTargetArch ()

Renvoie les abis pris en charge par l'architecture cible de build de l'hôte.

getHostAbis ()

Renvoie la machine hôte abis.

Des champs

ABI_OPTION

public static final String ABI_OPTION

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

Constructeurs publics

ITestSuite

public ITestSuite ()

Méthodes publiques

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)

Paramètres
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)

Paramètres
filters MultiMap

getAbis

public  getAbis ( ITestDevice device)

Obtient l'ensemble des ABI pris en charge par les tests de compatibilité AbiUtils#getAbisSupportedByCompatibility() et le périphérique testé.

Paramètres
device ITestDevice

Retour
L'ensemble des ABI sur lesquels exécuter les tests

Jette
DeviceNotAvailableException

getBuildInfo

public IBuildInfo getBuildInfo ()

La mise en œuvre d' ITestSuite peut nécessiter les informations de construction pour charger les tests.

Retour
IBuildInfo

getDevice

public ITestDevice getDevice ()

Faites tester l'appareil.

Retour
ITestDevice l' ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Renvoie le ModuleDefinition à exécuter directement, ou null s'il n'y en a pas encore (lorsque l'ITestSuite n'a pas encore été partitionnée).

Retour
ModuleDefinition

getRequestedAbi

public final String getRequestedAbi ()

Renvoie l'abi demandé avec l'option -a ou --abi.

Retour
String

getRequiredTokens

public  getRequiredTokens ()

Renvoie la liste des jetons requis par le test. Renvoie null si aucun jeton n'est pris en charge.

Retour

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée d'exécution attendue du test en millisecondes. L'heure est utilisée pour équilibrer la charge de l'exécution partitionnée

Retour
long

loadTests

public abstract  loadTests ()

Méthode abstraite pour charger la configuration des tests qui sera exécutée. Chaque test est défini par une IConfiguration et un nom unique sous lequel il rapportera les résultats.

Retour

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener, 
                String message)

Signalez les tests non exécutés à l'auditeur principal fourni. Ils doivent être signalés comme ayant échoué avec le message NOT_EXECUTED_FAILURE .

Paramètres
listener ITestInvocationListener : l'écouteur principal où signaler les résultats non exécutés.

message String : le message à associer à l'échec non exécuté.

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener)

Signalez les tests non exécutés à l'auditeur principal fourni. Ils doivent être signalés comme ayant échoué avec le message NOT_EXECUTED_FAILURE .

Paramètres
listener ITestInvocationListener : l'écouteur principal où signaler les résultats non exécutés.

courir

public final void run ( ITestInvocationListener listener)

Méthode d'exécution générique pour tous les tests chargés depuis loadTests() .

Paramètres
listener ITestInvocationListener : l' ITestInvocationListener des résultats de test

Jette
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

Définissez la valeur de mAbiName

Paramètres
abiName String

setBuild

public void setBuild ( IBuildInfo buildInfo)

Paramètres
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Exécutez la suite de tests en mode collecteur uniquement, cela nécessite que tous les sous-tests implémentent également cette interface.

setConfiguration

public void setConfiguration ( IConfiguration configuration)

Injecte l' IConfiguration en cours d'utilisation.

Paramètres
configuration IConfiguration

setDevice

public void setDevice ( ITestDevice device)

Injectez l'appareil à tester.

Paramètres
device ITestDevice : l' ITestDevice à utiliser

setDeviceInfos

public void setDeviceInfos ( deviceInfos)

Paramètres
deviceInfos

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

Paramètres
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

Obtenez l' Injector de guice actuel à partir de l'appel. Cela devrait nous permettre de continuer l'injection d'objets des modules.

Paramètres
injector Injector

setMaxRunLimit

public final void setMaxRunLimit (int maxRunLimit)

Définissez le nombre maximal de tentatives d'exécution pour chaque module.

Paramètres
maxRunLimit int

setMetricCollectors

public void setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour le test.

Paramètres
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Définir la valeur de mPrimaryAbiRun

Paramètres
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Lors du partage distribué, nous ne pouvons pas avoir ModuleDefinition qui partage les tests dans un pool, sinon le sharding intra-module ne fonctionnera pas, nous autorisons donc à le désactiver.

Paramètres
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Définit les ISystemStatusChecker partir de la configuration pour le test.

Paramètres
systemCheckers

Divisé

public  split (int shardCountHint)

Version alternative de split() qui fournit également le shardCount qui est tenté d'être exécuté. Ceci est utile pour certains coureurs de test qui ne peuvent parfois pas décider arbitrairement.

Paramètres
shardCountHint int : le nombre de partitions tentées.

Retour
une collection de sous-tests à exécuter séparément ou null si le test n'est pas actuellement partageable

Méthodes protégées

createModuleListeners

protected  createModuleListeners ()

Renvoie la liste de ITestInvocationListener applicable au niveau ModuleListener . Ces écouteurs seront réutilisés pour chaque module, ils ne seront pas ré-instanciés donc ils ne doivent pas prendre un état interne.

Retour

filterByConfigMetadata

protected boolean filterByConfigMetadata ( IConfiguration config, 
                MultiMap <String, String> include, 
                MultiMap <String, String> exclude)

Appliquez le filtre de métadonnées à la configuration et voyez si la configuration doit s'exécuter.

Paramètres
config IConfiguration : l' IConfiguration cours d'évaluation.

include MultiMap : les métadonnées incluent le filtre

exclude MultiMap : le filtre d'exclusion des métadonnées

Retour
boolean Vrai si le module doit s'exécuter, false dans le cas contraire.

filterByRunnerType

protected boolean filterByRunnerType ( IConfiguration config, 
                 allowedRunners)

Appliquez le filtrage de la liste blanche des coureurs, en supprimant tous les coureurs qui n'étaient pas sur la liste blanche. Si une configuration a plusieurs coureurs, certains peuvent être supprimés et la configuration fonctionnera toujours.

Paramètres
config IConfiguration : l' IConfiguration cours d'évaluation.

allowedRunners : La liste blanche du coureur actuel.

Retour
boolean Vrai si le module de configuration est autorisé à s'exécuter, false dans le cas contraire.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Renvoie les abis pris en charge par l'architecture cible de build hôte. Exposé pour les tests.

Retour

getHostAbis

protected  getHostAbis ()

Renvoie la machine hôte abis.

Retour