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

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 test pour l'exécutable 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	Exécuteur de test pour exécuter les modules de test KUnit sur l'appareil.
KernelTargetTest	Exécuteur de test pour l'exécutable s'exécutant sur la cible et analysant le résultat du test du kernel.

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

Résumé

Constantes
`String`	`NO_BINARY_ERROR`

Constructeurs publics
`ExecutableBaseTest()`

Méthodes publiques
`void`	`addAllExcludeFilters(Set<String> filters)` Ajoute le `Set` des filtres des tests à exclure.
`void`	`addAllIncludeFilters(Set<String> filters)` Ajoute le `Set` de filtres pour les 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 d'inclusion actuellement suivis.
`abstract String`	`findBinary(String binary)` Recherchez le binaire pour pouvoir l'exécuter.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
`Set<String>`	`getExcludeFilters()` Renvoie le `Set` actuel des filtres d'exclusion.
`Set<String>`	`getIncludeFilters()` Renvoie le `Set` actuel des filtres d'inclusion.
`final long`	`getRuntimeHint()` Renvoie la durée d'exécution attendue du test en millisecondes.
`Set<String>`	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et signale le résultat à l'écouteur.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Exécutez 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 Collection<IRemoteTest>`	`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()`
`Map<String, String>`	`getAllTestCommands()` Convertissez mBinaryPaths en mTestCommands pour plus de cohérence.
`IConfiguration`	`getConfiguration()` Renvoie la configuration du test.
`TestDescription[]`	`getFilterDescriptions(Map<String, String> testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

Constantes

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Valeur constante : "Le binaire %s n'existe pas."

Constructeurs publics

ExecutableBaseTest

public ExecutableBaseTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
`filters`	`Set`

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 d'inclusion 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 le binaire est introuvable.

Génère
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Renvoie
`boolean`

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
`Set<String>`

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 Set<String> reportDependencies ()

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`

runBinary

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

Exécutez 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`
`IOException`

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 Collection<IRemoteTest> 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ées.

Renvoie
`Collection<IRemoteTest>`	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 Map<String, String> getAllTestCommands ()

Convertissez mBinaryPaths en mTestCommands pour plus de cohérence.

Renvoie
`Map<String, String>`	Map`LinkedHashMap`<string, string=""> de testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration du test.

Renvoie
`IConfiguration`	IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions (Map<String, String> testCommands)

Paramètres
`testCommands`	`Map`

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`