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

ExecutableBaseTest

public abstract class ExecutableBaseTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDiscoverDependencies, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest

Sous-classes directes connues

ExecutableHostTest, ExecutableTargetTest

ExecutableHostTest	Exécuteur de tests pour les exécutables s'exécutant sur l'hôte.
ExecutableTargetTest	Exécuteur de test pour l'exécutable s'exécutant sur la cible.

Sous-classes indirectes connues

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Lanceur de test pour exécuter les modules de test KUnit sur l'appareil.
KernelTargetTest	Test Runner pour l'exécutable s'exécutant sur la cible et analysant le résultat du test du noyau.

Classe de base pour le style exécutable des tests. Par exemple : binaires, scripts shell.

Résumé

Constantes
`String`	`NO_BINARY_ERROR`

Constructeurs publics
`ExecutableBaseTest()`

Méthodes publiques
`void`	`addAllExcludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre pour exclure certains tests.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre pour inclure certains tests.
`void`	`clearExcludeFilters()` Supprimez tous les filtres d'exclusion actuellement suivis.
`void`	`clearIncludeFilters()` Supprimez tous les filtres "Inclure" actuellement suivis.
`abstract String`	`findBinary(String binary)` Recherchez le binaire pour pouvoir l'exécuter.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'exclusion.
	`getIncludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'inclusion.
`final long`	`getRuntimeHint()` Renvoie la durée d'exécution attendue du test en millisecondes.
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et communique les résultats au listener.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Exécute le binaire au chemin d'accès indiqué.
`final void`	`setAbi(IAbi abi)`
`final 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.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Vérifiez si le testRun doit se terminer plus tôt.
`final`	`split(int shardHint)` Version alternative de `split()` qui fournit également le shardCount qui est tenté d'être exécuté.

Méthodes protégées
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` Convertissez mBinaryPaths en mTestCommands pour plus de cohérence.
`IConfiguration`	`getConfiguration()` Renvoie la configuration du test.
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

Constantes

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Constant Value: "Binary %s does not exist."

Constructeurs publics

ExecutableBaseTest

public ExecutableBaseTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute le ERROR(/Set) des filtres des tests à exclure.

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute le ERROR(/Set) des filtres des tests à inclure.

Paramètres
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

Paramètres
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres "Inclure" actuellement suivis.

findBinary

public abstract String findBinary (String binary)

Recherchez le binaire pour pouvoir l'exécuter.

Paramètres
`binary`	`String` : chemin d'accès du binaire ou simplement son nom.

Renvoie
`String`	Chemin d'accès au binaire ou valeur nulle si introuvable.

Génère
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Renvoie
`boolean`

getExcludeFilters

public  getExcludeFilters ()

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

Renvoie

getIncludeFilters

public  getIncludeFilters ()

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

Renvoie

getRuntimeHint

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

reportDependencies

public  reportDependencies ()

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`

runBinary

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

Exécute le binaire au chemin d'accès indiqué.

Paramètres
`binaryPath`	`String` : chemin d'accès du binaire.
`listener`	`ITestInvocationListener` : écouteur auquel les résultats doivent être signalés.
`description`	`TestDescription` : test en cours.

Génère
`DeviceNotAvailableException`

setAbi

public final void setAbi (IAbi abi)

Paramètres
`abi`	`IAbi`

setCollectTestsOnly

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

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Vérifiez si le testRun doit se terminer plus tôt.

Paramètres
`description`	`TestDescription` : test en cours.

Renvoie
`FailureDescription`	FailureDescription si la boucle d'exécution doit se terminer.

split

public final  split (int shardHint)

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

Méthodes protégées

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Renvoie
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Renvoie
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

Convertissez mBinaryPaths en mTestCommands pour plus de cohérence.

Renvoie
	Map`ERROR(/LinkedHashMap)`<string, string=""> de testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration du test.

Renvoie
`IConfiguration`	IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

Paramètres
`testCommands`

Renvoie
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Paramètres
`context`	`IInvocationContext`

Renvoie
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Renvoie
`long`	le délai d'inactivité appliqué à chaque binaire pour son exécution.

isTestFailed

protected boolean isTestFailed (String testName)

Paramètres
`testName`	`String`

Renvoie
`boolean`