A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad 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

Sottoclassi dirette note

ExecutableHostTest, ExecutableTargetTest

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

Sottoclassi indirette note

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Esecutore di test 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 shell.

Riepilogo

Costanti
`String`	`NO_BINARY_ERROR`

Costruttori pubblici
`ExecutableBaseTest()`

Metodi pubblici
`void`	`addAllExcludeFilters(Set<String> filters)` Aggiunge il `Set` dei filtri dei test da escludere.
`void`	`addAllIncludeFilters(Set<String> filters)` Aggiunge il `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()`
`Set<String>`	`getExcludeFilters()` Restituisce l'attuale `Set` dei filtri di esclusione.
`Set<String>`	`getIncludeFilters()` Restituisce l'`Set` corrente dei filtri di inclusione.
`final long`	`getRuntimeHint()` Restituisce la durata prevista del test in millisecondi.
`Set<String>`	`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)` Esegui effettivamente il file 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 Collection<IRemoteTest>`	`split(int shardHint)` Versione alternativa di `split()` che fornisce anche il valore shardCount che viene tentato di eseguire.

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

Costanti

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Valore costante: "Binary %s does not exist."

Costruttori pubblici

ExecutableBaseTest

public ExecutableBaseTest ()

Metodi pubblici

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da escludere.

Parametri
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da includere.

Parametri
`filters`	`Set`

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.

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

Genera
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Resi
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Resi
`boolean`

getExcludeFilters

public Set<String> getExcludeFilters ()

Restituisce l'attuale Set dei filtri di esclusione.

Resi
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Restituisce l'Set corrente dei filtri di inclusione.

Resi
`Set<String>`

getRuntimeHint

public final long getRuntimeHint ()

Restituisce la durata prevista del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione suddivisa in shard

Resi
`long`

reportDependencies

public Set<String> reportDependencies ()

Resi
`Set<String>`

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

Genera
`DeviceNotAvailableException`

runBinary

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

Esegui effettivamente il file 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.

Genera
`DeviceNotAvailableException`
`IOException`

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.

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

ripartire

public final Collection<IRemoteTest> split (int shardHint)

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

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

Resi
`Collection<IRemoteTest>`	una raccolta di test secondari da eseguire separatamente o `null` se il test non è attualmente suddivisibile

Metodi protetti

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Resi
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Resi
`boolean`

getAllTestCommands

protected Map<String, String> getAllTestCommands ()

Converti mBinaryPaths in mTestCommands per coerenza.

Resi
`Map<String, String>`	una mappa`LinkedHashMap`<string, string=""> di testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione di test.

Resi
`IConfiguration`	un IConfiguration

getFilterDescriptions

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

Parametri
`testCommands`	`Map`

Resi
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Parametri
`context`	`IInvocationContext`

Resi
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

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

isTestFailed

protected boolean isTestFailed (String testName)

Parametri
`testName`	`String`

Risultati
`boolean`