A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad 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

Sottoclassi dirette note

ExecutableHostTest, ExecutableTargetTest

ExecutableHostTest	Test runner per l'eseguibile in esecuzione sull'host.
ExecutableTargetTest	Test runner per l'eseguibile in esecuzione sulla destinazione.

Sottoclassi indirette note

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Test runner per l'esecuzione di moduli di test KUnit sul dispositivo.
KernelTargetTest	Test runner per l'esecuzione di eseguibili sulla destinazione e l'analisi del risultato del test del kernel.

Classe base per lo stile eseguibile dei test. Ad esempio: binari, script della shell.

Riepilogo

Costanti
`String`	`NO_BINARY_ERROR`

Costruttori pubblici
`ExecutableBaseTest()`

Metodi pubblici
`void`	`addAllExcludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da escludere.
`void`	`addAllIncludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da includere.
`void`	`addExcludeFilter(String filter)` Aggiunge un filtro per i test da escludere.
`void`	`addIncludeFilter(String filter)` Aggiunge un filtro per i test da includere.
`void`	`clearExcludeFilters()` Elimina tutti i filtri di esclusione attualmente monitorati.
`void`	`clearIncludeFilters()` Elimina tutti i filtri di inclusione attualmente monitorati.
`abstract String`	`findBinary(String binary)` Cerca il file binario per poterlo eseguire.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di esclusione.
	`getIncludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di inclusione.
`final long`	`getRuntimeHint()` Restituisce il tempo di esecuzione previsto del test in millisecondi.
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Esegue i test e comunica il risultato al listener.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Esegue effettivamente il binario nel percorso specificato.
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` Attiva o disattiva la modalità di raccolta dei test
`void`	`setConfiguration(IConfiguration configuration)` Inserisce il `IConfiguration` in uso.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Controlla se testRun deve terminare in anticipo.
`final`	`split(int shardHint)` Versione alternativa di `split()` che fornisce anche il valore shardCount che viene tentato di eseguire.

Metodi protetti
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` Converti mBinaryPaths in mTestCommands per coerenza.
`IConfiguration`	`getConfiguration()` Restituisce la configurazione di test.
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

Costanti

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

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

Costruttori pubblici

ExecutableBaseTest

public ExecutableBaseTest ()

Metodi pubblici

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri dei test da escludere.

Parametri
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri dei test da includere.

Parametri
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

findBinary

public abstract String findBinary (String binary)

Cerca il file binario per poterlo eseguire.

Parametri
`binary`	`String`: il percorso del file binario o semplicemente il nome del file binario.

Ritorni
`String`	Il percorso del file binario o null se non trovato.

Lanci
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Ritorni
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Ritorni
`boolean`

getExcludeFilters

public  getExcludeFilters ()

Restituisce l'ERROR(/Set) corrente dei filtri di esclusione.

Ritorni

getIncludeFilters

public  getIncludeFilters ()

Restituisce l'ERROR(/Set) corrente dei filtri di inclusione.

Ritorni

getRuntimeHint

public final long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione partizionata

Ritorni
`long`

reportDependencies

public  reportDependencies ()

Ritorni

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e comunica il risultato al listener.

Parametri
`testInfo`	`TestInformation`: l'oggetto `TestInformation` contenente informazioni utili per eseguire i test.
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` dei risultati del test

Lanci
`DeviceNotAvailableException`

runBinary

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

Esegue effettivamente il binario nel percorso specificato.

Parametri
`binaryPath`	`String`: il percorso del file binario.
`listener`	`ITestInvocationListener`: il listener a cui segnalare i risultati.
`description`	`TestDescription`: il test in corso.

Lanci
`DeviceNotAvailableException`

setAbi

public final void setAbi (IAbi abi)

Parametri
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta dei test

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce il IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Controlla se testRun deve terminare in anticipo.

Parametri
`description`	`TestDescription`: il test in corso.

Ritorni
`FailureDescription`	FailureDescription se il ciclo di esecuzione deve terminare.

suddivisione

public final  split (int shardHint)

Versione alternativa di split() che fornisce anche il valore shardCount che viene tentato di eseguire. Ciò è utile per alcuni test runner che a volte non possono decidere in modo arbitrario.

Parametri
`shardHint`	`int`: il numero di shard tentato.

Ritorni
	una raccolta di test secondari da eseguire separatamente o `null` se il test non è attualmente suddivisibile

Metodi protetti

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Ritorni
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Ritorni
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

Converti mBinaryPaths in mTestCommands per coerenza.

Ritorni
	una mappa`ERROR(/LinkedHashMap)`<string, string=""> di testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione di test.

Ritorni
`IConfiguration`	un IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

Parametri
`testCommands`

Ritorni
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Parametri
`context`	`IInvocationContext`

Ritorni
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Ritorni
`long`	il timeout applicato a ogni binario per la sua esecuzione.

isTestFailed

protected boolean isTestFailed (String testName)

Parametri
`testName`	`String`

Ritorni
`boolean`