À 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 à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. 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.

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 lanceur 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( 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.
`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.
	`compileCommandArgs(String classpath, File artifactsDir)` Assemble les arguments de commande pour exécuter le runner de sous-processus.
`void`	`deleteTempFiles()`
`File`	`getCoverageExecFile()`
	`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.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et communique les résultats au listener.
`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)`
	`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é à partir de HostTest pour imiter son harnais de test unitaire.
`void`	`setServer(ServerSocket server)`

Constructeurs publics

IsolatedHostTest

public IsolatedHostTest ()

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.

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  compileCommandArgs (String classpath, 
                File artifactsDir)

Assemble les arguments de commande pour exécuter le runner de sous-processus.

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

Renvoie

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

Renvoie
`File`

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

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`

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

Renvoie
	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é à partir de HostTest pour imiter son harnais de test unitaire.

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`

setServer

protected void setServer (ServerSocket server)

Paramètres
`server`	`ServerSocket`