À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IsolatedHostTest

public class IsolatedHostTest
extends Object implements IBuildReceiver, IConfigurationReceiver, IRemoteTest, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Implémente un runner TradeFed qui utilise un sous-processus pour exécuter les tests dans un environnement à faible dépendance au lieu de les exécuter dans le processus principal.

Ce programme d'exécution suppose que tous les fichiers JAR configurés se trouvent dans le même répertoire de test et lance le sous-processus dans ce répertoire. Étant donné qu'il doit choisir un répertoire de travail pour le sous-processus, et que de nombreux tests bénéficient de ce répertoire en tant que répertoire de test, il s'agissait du meilleur compromis disponible.

Résumé

Constructeurs publics
`IsolatedHostTest()`

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.
`String`	`compileClassPath()` Crée un chemin d'accès aux classes pour le sous-processus qui inclut les fichiers JAR nécessaires à l'exécution des tests.
`List<String>`	`compileCommandArgs(String classpath, File artifactsDir)` Assemble les arguments de commande pour exécuter le programme d'exécution de sous-processus.
`void`	`deleteTempFiles()`
`File`	`getCoverageExecFile()`
`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.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et signale le résultat à l'écouteur.
`void`	`setBuild(IBuildInfo build)`
`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`	`setDebug(boolean debug)`
`Collection<IRemoteTest>`	`split(int shardCount)` Version alternative de `split()` qui fournit également le shardCount qui est tenté d'être exécuté.
`void`	`uploadTestArtifacts(File logDir, ITestInvocationListener listener)`
`boolean`	`useRavenwoodResources()`
`boolean`	`useRobolectricResources()`

Méthodes protégées
`String`	`compileLdLibraryPathInner(String androidHostOut)` Nous appelons cette version à partir du test unitaire et transmettons directement ANDROID_HOST_OUT.
`File`	`getJarFile(String jarName, TestInformation testInfo)` Copié depuis HostTest pour imiter son harnais de test unitaire.
`void`	`setServer(ServerSocket server)`

Constructeurs publics

IsolatedHostTest

public IsolatedHostTest ()

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.

compileClassPath

public String compileClassPath ()

Crée un chemin d'accès aux classes pour le sous-processus qui inclut les fichiers JAR nécessaires à l'exécution des tests.

Renvoie
`String`	Chaîne spécifiant le chemin de classe séparé par des deux-points.

compileCommandArgs

public List<String> compileCommandArgs (String classpath, 
                File artifactsDir)

Assemble les arguments de commande pour exécuter le programme d'exécution de sous-processus.

Paramètres
`classpath`	`String`
`artifactsDir`	`File`

Renvoie
`List<String>`

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

Renvoie
`File`

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>`

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`

setBuild

public void setBuild (IBuildInfo build)

Paramètres
`build`	`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`

setDebug

public void setDebug (boolean debug)

Paramètres
`debug`	`boolean`

split

public Collection<IRemoteTest> split (int shardCount)

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

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

Renvoie
`Collection<IRemoteTest>`	une collection de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement fragmentable.

uploadTestArtifacts

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

Paramètres
`logDir`	`File`
`listener`	`ITestInvocationListener`

useRavenwoodResources

public boolean useRavenwoodResources ()

Renvoie
`boolean`

useRobolectricResources

public boolean useRobolectricResources ()

Renvoie
`boolean`

Méthodes protégées

compileLdLibraryPathInner

protected String compileLdLibraryPathInner (String androidHostOut)

Nous appelons cette version à partir du test unitaire et transmettons directement ANDROID_HOST_OUT. Nous en avons besoin, car Java ne dispose d'aucune API permettant de définir des variables d'environnement.

Paramètres
`androidHostOut`	`String`

Renvoie
`String`

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Copié depuis HostTest pour imiter son harnais de test unitaire.

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`

setServer

protected void setServer (ServerSocket server)

Paramètres
`server`	`ServerSocket`