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

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	Outil d'exécution des tests pour l'exécutable exécuté sur l'hôte.
ExecutableTargetTest	Exécuteur de test pour l'exécutable exécuté sur la cible.

Sous-classes indirectes connues

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Lanceur de test pour exécuter des modules de test KUnit sur l'appareil.
KernelTargetTest	Exécuteur de test pour l'exécutable exécuté sur la cible et analysant le résultat du test du noyau.

Classe de base pour les tests exécutables. (binaires, scripts shell, par exemple)

Résumé

Champs
`public static final String`	`NO_BINARY_ERROR`

Constructeurs publics
`ExecutableBaseTest()`

Méthodes publiques
`void`	`addAllExcludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre des tests à exclure.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre des tests à inclure.
`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()`
	`getExcludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'exclusion.
	`getIncludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'inclusion.
`final long`	`getRuntimeHint()` Renvoie la durée d'exécution prévue du test en millisecondes.
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et transmet les résultats à l'écouteur.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Exécutez le binaire au chemin d'accès donné.
`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` utilisé.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Vérifiez si l'exécution du test doit s'arrêter prématurément.
`final`	`split(int shardHint)` Version alternative de `split()` qui fournit également le shardCount que vous essayez d'exécuter.

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

Champs

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Constructeurs publics

ExecutableBaseTest

public ExecutableBaseTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Paramètres
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre des tests à exclure.

Paramètres
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre des tests à inclure.

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 aucun binaire n'est trouvé.

Génère
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Renvoie
`boolean`

getExcludeFilters

public  getExcludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'inclusion.

Renvoie

getRuntimeHint

public final long getRuntimeHint ()

Renvoie la durée d'exécution prévue du test en millisecondes. L'heure est utilisée pour équilibrer la charge de l'exécution fractionnée.

Renvoie
`long`

reportDependencies

public  reportDependencies ()

Renvoie

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et transmet les résultats à l'écouteur.

Paramètres
`testInfo`	`TestInformation`: objet `TestInformation` contenant des informations utiles pour exécuter des tests.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` des résultats des tests

Génère
`DeviceNotAvailableException`

runBinary

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

Exécutez le binaire au chemin d'accès donné.

Paramètres
`binaryPath`	`String`: chemin d'accès du binaire.
`listener`	`ITestInvocationListener`: écouteur où signaler les résultats.
`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 utilisé.

Paramètres
`configuration`	`IConfiguration`

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Vérifiez si l'exécution du test doit s'arrêter prématurément.

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

Renvoie
`FailureDescription`	FailureDescription si la boucle d'exécution doit s'arrêter.

split

public final  split (int shardHint)

Version alternative de split() qui fournit également le shardCount que vous essayez d'exécuter. Cela est utile pour certains outils d'exécution de tests qui ne peuvent pas toujours prendre une décision arbitraire.

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

Renvoie
	Ensemble de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement partitionnable

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
	une Map`ERROR(/LinkedHashMap)`<chaîne, chaîne=""> de testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration de test.

Renvoie
`IConfiguration`	un 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`