À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

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

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

Sous-classes directes connues

JarHostTest

JarHostTest Lanceur de test pour les tests JUnit côté hôte.

Un exécuteur de test pour les tests hôtes 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 à exclure si un test est marqué avec elle.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre des tests à exclure.
`void`	`addIncludeAnnotation(String annotation)` Ajoute une annotation à inclure si un test est marqué avec elle.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre des tests à inclure.
`void`	`clearExcludeAnnotations()` Supprimez toutes les annotations d'exclusion actuellement suivies.
`void`	`clearExcludeFilters()` Supprimez 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 l'`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 des tests
`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 plusieurs emplacements où l'artefact se trouve généralement pour différents cas d'utilisation afin de trouver notre fichier JAR.
`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)` chargez l'objet de classe et définissez les informations de 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

HostTest

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 à exclure si un test est marqué avec elle.

Paramètres
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre des 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 ()

Obtenez l'appareil à tester.

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 des tests

setConfiguration

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 formatées comme l'exige l'option set-option HostTest.

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
	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 ()

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  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 d'aide 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 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é pour les tests unitaires.

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