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 Test runner para executável em execução no destino e análise do resultado do teste de kernel.

---

Classe de base para o 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(Set<String> filters) Adiciona o Set de filtros de quais testes excluir.
void	addAllIncludeFilters(Set<String> filters) Adiciona o 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()
Set<String>	getExcludeFilters() Retorna o Set atual dos filtros de exclusão.
Set<String>	getIncludeFilters() Retorna o Set atual dos filtros de inclusão.
final long	getRuntimeHint() Retorna o tempo de execução esperado do teste em milissegundos.
Set<String>	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 a IConfiguration em uso.
FailureDescription	shouldAbortRun(TestDescription description) Verifica se o testRun deve ser encerrado antecipadamente.
final Collection<IRemoteTest>	split(int shardHint) Versão alternativa de split() que também fornece o shardCount, cuja tentativa de execução está em andamento.

Métodos protegidos
boolean	doesRunBinaryGenerateTestResults()
boolean	doesRunBinaryGenerateTestRuns()
Map<String, String>	getAllTestCommands() Converter mBinaryPaths em mTestCommands para consistência.
IConfiguration	getConfiguration() Retorna a configuração do teste.
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

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

Construtores públicos

ExecutableBaseTest

public ExecutableBaseTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Adiciona o Set de filtros de quais testes excluir.

Parâmetros
filters	Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Adiciona o Set de filtros de quais testes incluir.

Parâmetros
filters	Set

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

Retorna o Set atual dos filtros de exclusão.

Retorna
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Retorna o Set atual dos filtros de inclusão.

Retorna
Set<String>

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

Retorna
Set<String>

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
IOException

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

dividir

public final Collection<IRemoteTest> split (int shardHint)

Versão alternativa de split() que também fornece o shardCount, cuja tentativa de execução está em andamento. Isso é útil para alguns executores de teste que, em alguns cenários, não conseguem decidir sem um critério explícito.

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

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

Converter mBinaryPaths em mTestCommands para manter a consistência.

Retorna
Map<String, String>	Um MapLinkedHashMap<string, string=""> de testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Retorna a configuração do teste.

Retorna
IConfiguration	um IConfiguration

getFilterDescriptions

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

Parâmetros
testCommands	Map

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