A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no 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

Subclasses diretas conhecidas

ExecutableHostTest, ExecutableTargetTest

ExecutableHostTest	Executor de testes para executável em execução no host.
ExecutableTargetTest	Executor de testes para executável em execução no destino.

Subclasses indiretas conhecidas

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Executor de testes para executar módulos de teste do KUnit no dispositivo.
KernelTargetTest	Executor de testes para executável em execução no destino e análise do resultado do teste do kernel.

Classe base para estilo executável de testes. Por exemplo: binários, scripts de shell.

Resumo

Constantes
`String`	`NO_BINARY_ERROR`

Construtores públicos
`ExecutableBaseTest()`

Métodos públicos
`void`	`addAllExcludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes excluir.
`void`	`addAllIncludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes incluir.
`void`	`addExcludeFilter(String filter)` Adiciona um filtro de quais testes excluir.
`void`	`addIncludeFilter(String filter)` Adiciona um filtro de quais testes incluir.
`void`	`clearExcludeFilters()` Exclui todos os filtros de exclusão rastreados no momento.
`void`	`clearIncludeFilters()` Exclui todos os filtros de inclusão rastreados no momento.
`abstract String`	`findBinary(String binary)` Pesquise o binário para poder executá-lo.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
	`getIncludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de inclusão.
`final long`	`getRuntimeHint()` Retorna o tempo de execução esperado do teste em milissegundos.
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Executa o binário no caminho especificado.
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` Ativa ou desativa o modo de coleta de testes
`void`	`setConfiguration(IConfiguration configuration)` Injeta o `IConfiguration` em uso.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Verifica se o testRun deve ser encerrado antecipadamente.
`final`	`split(int shardHint)` Versão alternativa de `split()` que também fornece o shardCount que está sendo tentado executar.

Métodos protegidos
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` Converter mBinaryPaths em mTestCommands para manter a consistência.
`IConfiguration`	`getConfiguration()` Retorna a configuração do teste.
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

Constantes

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Valor da constante: "O binário %s não existe."

Construtores públicos

ExecutableBaseTest

public ExecutableBaseTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes excluir.

Parâmetros
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes incluir.

Parâmetros
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes excluir.

Parâmetros
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Adiciona um filtro de quais testes incluir.

Parâmetros
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

Exclui todos os filtros de exclusão rastreados no momento.

clearIncludeFilters

public void clearIncludeFilters ()

Exclui todos os filtros de inclusão rastreados no momento.

findBinary

public abstract String findBinary (String binary)

Pesquise o binário para poder executá-lo.

Parâmetros
`binary`	`String`: o caminho do binário ou apenas o nome dele.

Retorna
`String`	O caminho para o binário ou nulo, se não for encontrado.

Gera
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Retorna
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Retorna
`boolean`

getExcludeFilters

public  getExcludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de exclusão.

Retorna

getIncludeFilters

public  getIncludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de inclusão.

Retorna

getRuntimeHint

public final long getRuntimeHint ()

Retorna o tempo de execução esperado do teste em milissegundos. O tempo é usado para balancear a carga da execução fragmentada.

Retorna
`long`

reportDependencies

public  reportDependencies ()

Retorna

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Executa os testes e informa o resultado ao listener.

Parâmetros
`testInfo`	`TestInformation`: o objeto `TestInformation` que contém informações úteis para executar testes.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` dos resultados do teste

Gera
`DeviceNotAvailableException`

runBinary

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

Executa o binário no caminho especificado.

Parâmetros
`binaryPath`	`String`: o caminho do binário.
`listener`	`ITestInvocationListener`: o listener em que os resultados serão informados.
`description`	`TestDescription`: o teste em andamento.

Gera
`DeviceNotAvailableException`

setAbi

public final void setAbi (IAbi abi)

Parâmetros
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de testes

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Verifica se o testRun deve ser encerrado antecipadamente.

Parâmetros
`description`	`TestDescription`: o teste em andamento.

Retorna
`FailureDescription`	FailureDescription se o loop de execução precisar ser encerrado.

dividido

public final  split (int shardHint)

Versão alternativa de split() que também fornece o shardCount que está sendo tentado executar. Isso é útil para alguns executores de teste que não podem decidir arbitrariamente às vezes.

Parâmetros
`shardHint`	`int`: a contagem de fragmentos tentada.

Retorna
	uma coleção de subtestes a serem executados separadamente ou `null` se o teste não puder ser fragmentado no momento.

Métodos protegidos

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Retorna
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Retorna
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

Converter mBinaryPaths em mTestCommands para manter a consistência.

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

getConfiguration

protected IConfiguration getConfiguration ()

Retorna a configuração do teste.

Retorna
`IConfiguration`	um IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

Parâmetros
`testCommands`

Retorna
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Parâmetros
`context`	`IInvocationContext`

Retorna
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Retorna
`long`	o tempo limite aplicado a cada binário para execução.

isTestFailed

protected boolean isTestFailed (String testName)

Parâmetros
`testName`	`String`

Retorna
`boolean`