À 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, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Sous-classes directes connues

JarHostTest

JarHostTest Exécuteur de tests pour les tests JUnit côté hôte.

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( notAnnotations)` Ajoute un `ERROR(/Set)` d'annotations à exclure si un test est marqué avec.
`void`	`addAllExcludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeAnnotation( annotations)` Ajoute un `ERROR(/Set)` d'annotations à inclure si un test est marqué avec.
`void`	`addAllIncludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des 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 celle-ci.
`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()` Supprimez toutes les annotations d'inclusion actuellement suivies.
`void`	`clearIncludeFilters()` Supprimez tous les filtres "Inclure" actuellement suivis.
`int`	`countTestCases()` Renvoie le nombre de scénarios de test dans toutes les classes faisant partie des tests.
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Obtenez l'appareil à tester.
	`getExcludeAnnotations()` Renvoie le `ERROR(/Set)` actuel des annotations à exclure.
	`getExcludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'exclusion.
	`getIncludeAnnotations()` Renvoie le `ERROR(/Set)` actuel des annotations à inclure.
	`getIncludeFilters()` Renvoie le `ERROR(/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 communique les résultats au listener.
`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 à tester.
`static void`	`setOptionToLoadedObject(Object testObj, 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)`
	`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)` Helper 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`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Inspectez plusieurs emplacements où l'artefact est généralement situé 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)` charger l'objet de classe et définir les informations de test (appareil, build).
`void`	`setClassName(String className)` Effacez, puis définissez le nom d'une classe à 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 ( notAnnotations)

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

Paramètres
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute le 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.

Paramètres
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute le 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.

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 celle-ci.

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

Supprimez toutes les annotations d'inclusion actuellement suivies.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres "Inclure" 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  getClassNames ()

Renvoie

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil à tester.

Renvoie
`ITestDevice`	le `ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

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

Renvoie

getExcludeFilters

public  getExcludeFilters ()

Renvoie le ERROR(/Set) actuel des filtres d'exclusion.

Renvoie

getIncludeAnnotations

public  getIncludeAnnotations ()

Renvoie le ERROR(/Set) actuel des annotations à inclure.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie le ERROR(/Set) actuel des filtres d'inclusion.

Renvoie

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`

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et communique les résultats au listener.

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 à tester.

Paramètres
`device`	`ITestDevice` : `ITestDevice` à utiliser

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 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`	: liste des options mises en forme comme l'exige HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Paramètres
`testInfo`	`TestInformation`

split

public  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é.
`testInfo`	`TestInformation` : `TestInformation` parent

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

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

Paramètres
`classObj`	`Class`

Renvoie
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Obtenez les informations de compilation reçues par HostTest.

Renvoie
`IBuildInfo`	le `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 est généralement situé 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)

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)

charger l'objet de classe et définir 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`

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é.