HostTest

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

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

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

Résumé

Constantes

String SET_OPTION_DESC

String SET_OPTION_NAME

Constructeurs publics

HostTest()

Méthodes publiques

void addAllExcludeAnnotation(Set<String> notAnnotations)

Ajoute un Set d'annotations à exclure si un test est marqué avec.

void addAllExcludeFilters(Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

void addAllIncludeAnnotation(Set<String> annotations)

Ajoute un Set d'annotations à inclure si un test est marqué avec.

void addAllIncludeFilters(Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

void addExcludeAnnotation(String notAnnotation)

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

void addExcludeFilter(String filter)

Ajoute un filtre pour exclure certains tests.

void addIncludeAnnotation(String annotation)

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

void addIncludeFilter(String filter)

Ajoute un filtre pour inclure certains tests.

void clearExcludeAnnotations()

Supprime toutes les annotations d'exclusion actuellement suivies.

void clearExcludeFilters()

Supprimez tous les filtres d'exclusion actuellement suivis.

void clearIncludeAnnotations()

Supprime toutes les annotations d'inclusion actuellement suivies.

void clearIncludeFilters()

Supprimez tous les filtres d'inclusion actuellement suivis.

int countTestCases()

Renvoie le nombre de scénarios de test dans toutes les classes faisant partie des tests.

IAbi getAbi()

Set<String> getClassNames()
ITestDevice getDevice()

Obtenez l'appareil soumis aux tests.

Set<String> getExcludeAnnotations()

Renvoie le Set actuel des annotations à exclure.

Set<String> getExcludeFilters()

Renvoie le Set actuel des filtres d'exclusion.

Set<String> getIncludeAnnotations()

Renvoie le Set actuel des annotations à inclure.

Set<String> getIncludeFilters()

Renvoie le Set actuel des filtres d'inclusion.

long getRuntimeHint()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

Exécute les tests et signale le résultat à l'écouteur.

void setAbi(IAbi abi)

void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

void setConfiguration(IConfiguration configuration)

Injecte le IConfiguration en cours d'utilisation.

void setDevice(ITestDevice device)

Injectez l'appareil soumis aux tests.

static void setOptionToLoadedObject(Object testObj, List<String> keyValueOptions)

Assistant que les Device Runners peuvent utiliser pour définir les options de la même manière que HostTest, à partir de set-option.

void setTestInformation(TestInformation testInfo)
Collection<IRemoteTest> split(Integer shardCount, TestInformation testInfo)

Nous répartissons les résultats par personne, par classe de test ou par méthode.

Méthodes protégées

HostTest createHostTest(Class<?> classObj)

Assistance pour créer une instance HostTest lors du partitionnement.

IBuildInfo getBuild()

Obtenez les informations de compilation reçues par HostTest.

ClassLoader getClassLoader()

Renvoie le chargeur de classe par défaut.

final List<Class<?>> getClasses()
File getJarFile(String jarName, TestInformation testInfo)

Inspectez plusieurs emplacements où les artefacts sont généralement situés pour différents cas d'utilisation afin de trouver notre fichier JAR.

boolean hasJUnit4Annotation(Class<?> classObj)

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

Object loadObject(Class<?> classObj)

chargez l'objet de classe et définissez les informations de test (appareil, build).

void setClassName(String className)

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

void setMethodName(String methodName)

Définissez le nom de la méthode à exécuter.

boolean shouldTestRun(AnnotatedElement annotatedElement)

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

Constantes

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Valeur constante : "Options à transmettre à la classe testée. La clé et la valeur doivent être séparées par un deux-points (":"). Par exemple, si la classe testée accepte "--iteration 1" à partir d'une ligne de commande, elle doit être transmise sous la forme "--set-option iteration:1" ou "--set-option iteration:key=value" pour transmettre les options à mapper. Les valeurs contenant ":" ou "=" peuvent être échappées avec une barre oblique inverse. Vous pouvez cibler une classe spécifique en la spécifiant. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Valeur constante : "set-option"

Constructeurs publics

HostTest

public HostTest ()

Méthodes publiques

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

Ajoute un Set d'annotations à exclure si un test est marqué avec.

Paramètres
notAnnotations Set

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
filters Set

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

Ajoute un Set d'annotations à inclure si un test est marqué avec.

Paramètres
annotations Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
filters Set

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Paramètres
notAnnotation String

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
filter String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

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

Paramètres
annotation String

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

Paramètres
filter String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Supprime toutes les annotations d'exclusion actuellement suivies.

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Supprime toutes les annotations d'inclusion actuellement suivies.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

countTestCases

public int countTestCases ()

Renvoie le nombre de scénarios de test dans toutes les classes faisant partie des tests.

Renvoie
int

getAbi

public IAbi getAbi ()

Renvoie
IAbi

getClassNames

public Set<String> getClassNames ()

Renvoie
Set<String>

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil soumis aux tests.

Renvoie
ITestDevice l'/le/la ITestDevice

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

Renvoie le Set actuel des annotations à exclure.

Renvoie
Set<String>

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
Set<String>

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Renvoie le Set actuel des annotations à inclure.

Renvoie
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
Set<String>

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée d'exécution attendue du test en millisecondes. Ce temps est utilisé pour équilibrer la charge de l'exécution fragmentée.

Renvoie
long

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et signale le résultat à l'écouteur.

Paramètres
testInfo TestInformation : objet TestInformation contenant des informations utiles pour exécuter des tests.
listener ITestInvocationListener : ITestInvocationListener des résultats du test
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 des tests

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration en cours d'utilisation.

Paramètres
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil soumis aux tests.

Paramètres
device ITestDevice : ITestDevice à utiliser

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                List<String> keyValueOptions)

Assistant que les Device Runners peuvent utiliser pour définir les options de la même manière que HostTest, à partir de set-option.

Paramètres
testObj Object : objet qui recevra les options.
keyValueOptions List : liste des options mises en forme comme l'exige HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Paramètres
testInfo TestInformation

split

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

Nous répartissons les résultats par personne, par classe de test ou par méthode.

Paramètres
shardCount Integer : nombre de partitions tentées.
testInfo TestInformation : TestInformation parent
Renvoie
Collection<IRemoteTest> une collection de sous-tests à exécuter séparément ou null si le test n'est pas actuellement fragmentable.

Méthodes protégées

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Assistance pour créer une instance HostTest lors du partitionnement. Remplacement pour renvoyer n'importe quel enfant de HostTest.

Paramètres
classObj Class

Renvoie
HostTest

getBuild

protected IBuildInfo getBuild ()

Obtenez les informations de compilation 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 List<Class<?>> getClasses ()

Renvoie
List<Class<?>>

Génère
IllegalArgumentException

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspectez plusieurs emplacements où les artefacts sont généralement situés pour différents cas d'utilisation afin de trouver notre fichier JAR.

Paramètres
jarName String

testInfo TestInformation

Renvoie
File

Génère
FileNotFoundException

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Helper pour 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)

chargez l'objet de classe et définissez les informations de test (appareil, build).

Paramètres
classObj Class

Renvoie
Object

setClassName

protected void setClassName (String className)

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

Paramètres
className String

setMethodName

protected void setMethodName (String methodName)

Définissez le nom de la méthode à exécuter.

Cette option permet d'exécuter une méthode de test spécifique à partir d'une classe de test.

Paramètres
methodName String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

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