HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.HostTest


Exécuteur de test pour les tests basés sur l'hôte JUnit. Si le test à exécuter implémente IDeviceTest, ce lanceur transmettra une référence à l'appareil.

Résumé

Champs

public static final String SET_OPTION_DESC

public static final String SET_OPTION_NAME

Constructeurs publics

HostTest()

Méthodes publiques

void addAllExcludeAnnotation( notAnnotations)

Ajoute un ERROR(/Set) d'annotations à exclure si un test est marqué avec celui-ci.

void addAllExcludeFilters( filters)

Ajoute les ERROR(/Set) des filtres des tests à exclure.

void addAllIncludeAnnotation( annotations)

Ajoute un ERROR(/Set) d'annotations à inclure si un test est marqué avec celui-ci.

void addAllIncludeFilters( filters)

Ajoute les ERROR(/Set) des filtres des tests à inclure.

void addExcludeAnnotation(String notAnnotation)

Ajoute une annotation pour exclure si un test est marqué avec cet élément.

void addExcludeFilter(String filter)

Ajoute un filtre des tests à exclure.

void addIncludeAnnotation(String annotation)

Ajoute une annotation pour inclure si un test est marqué avec lui.

void addIncludeFilter(String filter)

Ajoute un filtre des tests à inclure.

void clearExcludeAnnotations()

Supprimez toutes les annotations d'exclusion actuellement suivies.

void clearExcludeFilters()

Supprimer tous les filtres d'exclusion actuellement suivis

void clearIncludeAnnotations()

Supprimez toutes les annotations d'inclusion actuellement suivies.

void clearIncludeFilters()

Supprimez tous les filtres d'inclusion actuellement suivis.

int countTestCases()

Afficher le nombre de scénarios de test pour toutes les classes faisant partie des tests

IAbi getAbi()

getClassNames()
ITestDevice getDevice()

Obtenez l'appareil à tester.

getExcludeAnnotations()

Renvoie l'ERROR(/Set) actuel des annotations à exclure.

getExcludeFilters()

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

getIncludeAnnotations()

Renvoie la ERROR(/Set) actuelle des annotations à inclure.

getIncludeFilters()

Renvoie la ERROR(/Set) actuelle des filtres d'inclusion.

long getRuntimeHint()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

Exécute les tests et transmet les résultats à l'écouteur.

void setAbi(IAbi abi)

void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

Active ou désactive le mode de collecte de test

void setConfiguration(IConfiguration configuration)

Injecte le IConfiguration utilisé.

void setDevice(ITestDevice device)

Injectez l'appareil testé.

static void setOptionToLoadedObject(Object testObj, keyValueOptions)

Outil d'assistance à utiliser par les exécuteurs d'appareils pour définir des options de la même manière que HostTest, à partir de set-option.

void setTestInformation(TestInformation testInfo)
split(Integer shardCount, TestInformation testInfo)

Nous effectuons une répartition par personne, par classe de test ou par méthode.

Méthodes protégées

HostTest createHostTest(Class<?> classObj)

Assistant permettant de créer une instance HostTest lors du fractionnement.

IBuildInfo getBuild()

Obtenez les informations de compilation reçues par HostTest.

ClassLoader getClassLoader()

Renvoie le chargeur de classe par défaut.

final getClasses()
File getJarFile(String jarName, TestInformation testInfo)

Inspectez les différents emplacements où se trouve généralement l'artefact pour différents cas d'utilisation afin de trouver notre pot.

boolean hasJUnit4Annotation(Class<?> classObj)

Outil permettant de déterminer si nous avons affaire à une classe de test avec des annotations Junit4.

Object loadObject(Class<?> classObj)

charger l'objet de classe et définir les informations du test (appareil, build).

void setClassName(String className)

Effacez le nom de la classe, puis définissez-en un à exécuter.

boolean shouldTestRun(AnnotatedElement annotatedElement)

Vérifiez si un élément avec une annotation passe le filtre.

Champs

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Constructeurs publics

Test de l'hôte

public HostTest ()

Méthodes publiques

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Ajoute un ERROR(/Set) d'annotations à exclure si un test est marqué avec celui-ci.

Paramètres
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à exclure.

Paramètres
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Ajoute un ERROR(/Set) d'annotations à inclure si un test est marqué avec celui-ci.

Paramètres
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à inclure.

Paramètres
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Ajoute une annotation pour exclure si un test est marqué avec cet élément.

Paramètres
notAnnotation String

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre indiquant les tests à exclure.

Paramètres
filter String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Ajoute une annotation à inclure si un test est marqué avec elle.

Paramètres
annotation String

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre des tests à inclure.

Paramètres
filter String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Supprimez toutes les annotations d'exclusion actuellement suivies.

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Supprimez toutes les annotations d'inclusion actuellement suivies.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

countTestCases

public int countTestCases ()

Afficher le nombre de scénarios de test pour toutes les classes faisant partie des tests

Renvoie
int

getAbi

public IAbi getAbi ()

Renvoie
IAbi

getClassNames

public  getClassNames ()

Renvoie

getDevice

public ITestDevice getDevice ()

Faites tester l'appareil.

Renvoie
ITestDevice l'/le/la ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

Renvoie l'ERROR(/Set) actuel des annotations à exclure.

Renvoie

getExcludeFilters

public  getExcludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

Renvoie

getIncludeAnnotations

public  getIncludeAnnotations ()

Renvoie la ERROR(/Set) actuelle des annotations à inclure.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'inclusion.

Renvoie

getRuntimeHint

public long getRuntimeHint ()

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

Renvoie
long

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et transmet les résultats à l'écouteur.

Paramètres
testInfo TestInformation: objet TestInformation contenant des informations utiles pour exécuter des tests.

listener ITestInvocationListener: ITestInvocationListener des résultats des tests

Génère
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Paramètres
abi IAbi

setBuild

public void setBuild (IBuildInfo buildInfo)

Paramètres
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte de test

Définir une configuration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration utilisé.

Paramètres
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil testé.

Paramètres
device ITestDevice: ITestDevice à utiliser

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Outil d'assistance à utiliser par les exécuteurs d'appareils pour définir des options de la même manière que HostTest, à partir de set-option.

Paramètres
testObj Object: objet qui recevra les options.

keyValueOptions : liste des options au format HostTest set-option requis.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Paramètres
testInfo TestInformation

split

public  split (Integer shardCount, 
                TestInformation testInfo)

Nous effectuons une répartition par personne, par classe de test ou par méthode.

Paramètres
shardCount Integer: nombre de partitions tentées.

testInfo TestInformation: TestInformation parent

Renvoie
un ensemble de sous-tests à exécuter séparément ou null si le test n'est pas actuellement partitionnable

Méthodes protégées

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Assistant permettant de créer une instance HostTest lors du fractionnement. Remplacement pour renvoyer n'importe quel enfant de HostTest.

Paramètres
classObj Class

Renvoie
HostTest

getBuild

protected IBuildInfo getBuild ()

Permet d'obtenir les informations sur le build reçues par HostTest.

Renvoie
IBuildInfo l'/le/la IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

Renvoie le chargeur de classe par défaut.

Renvoie
ClassLoader

getClasses

protected final  getClasses ()

Renvoie

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspectez plusieurs emplacements où l'artefact se trouve généralement pour différents cas d'utilisation afin de trouver notre fichier JAR.

Paramètres
jarName String

testInfo TestInformation

Renvoie
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Outil permettant de déterminer si nous avons affaire à une classe de test avec des annotations Junit4.

Paramètres
classObj Class

Renvoie
boolean

loadObject

protected Object loadObject (Class<?> classObj)

charger l'objet de classe et définir les informations du test (appareil, build).

Paramètres
classObj Class

Renvoie
Object

setClassName

protected void setClassName (String className)

Effacez le nom de la classe, puis définissez-en un à exécuter.

Paramètres
className String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Vérifiez si un élément avec une annotation passe le filtre. Exposée pour les tests unitaires.

Renvoie
boolean "false" si le test ne doit pas être exécuté.