HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.HostTest

Subclasses diretas conhecidas JarHostTest JarHostTest Executor de testes para testes JUnit do lado do host.

---

Um executor de testes para testes baseados em host do JUnit. Se o teste a ser executado implementar IDeviceTest esse executor vai transmitir uma referência ao dispositivo.

Resumo

Constantes
String	SET_OPTION_DESC
String	SET_OPTION_NAME

Construtores públicos
HostTest()

Métodos públicos
void	addAllExcludeAnnotation( notAnnotations) Adiciona um ERROR(/Set) de anotações a serem excluídas se um teste for marcado com ele.
void	addAllExcludeFilters( filters) Adiciona o ERROR(/Set) de filtros de quais testes excluir.
void	addAllIncludeAnnotation( annotations) Adiciona um ERROR(/Set) de anotações para incluir se um teste for marcado com ele.
void	addAllIncludeFilters( filters) Adiciona o ERROR(/Set) de filtros de quais testes incluir.
void	addExcludeAnnotation(String notAnnotation) Adiciona uma anotação para excluir se um teste for marcado com ela.
void	addExcludeFilter(String filter) Adiciona um filtro de quais testes excluir.
void	addIncludeAnnotation(String annotation) Adiciona uma anotação para incluir se um teste for marcado com ela.
void	addIncludeFilter(String filter) Adiciona um filtro de quais testes incluir.
void	clearExcludeAnnotations() Exclui todas as anotações de exclusão rastreadas no momento.
void	clearExcludeFilters() Exclui todos os filtros de exclusão rastreados no momento.
void	clearIncludeAnnotations() Exclui todas as anotações de inclusão rastreadas no momento.
void	clearIncludeFilters() Exclui todos os filtros de inclusão rastreados no momento.
int	countTestCases() Retorna o número de casos de teste em todas as classes que fazem parte dos testes
IAbi	getAbi()
	getClassNames()
ITestDevice	getDevice() Pegue o dispositivo em teste.
	getExcludeAnnotations() Retorna o ERROR(/Set) atual de anotações a serem excluídas.
	getExcludeFilters() Retorna o ERROR(/Set) atual dos filtros de exclusão.
	getIncludeAnnotations() Retorna o ERROR(/Set) atual de anotações a serem incluídas.
	getIncludeFilters() Retorna o ERROR(/Set) atual dos filtros de inclusão.
long	getRuntimeHint() Retorna o tempo de execução esperado do teste em milissegundos.
void	run(TestInformation testInfo, ITestInvocationListener listener) Executa os testes e informa o resultado ao listener.
void	setAbi(IAbi abi)
void	setBuild(IBuildInfo buildInfo)
void	setCollectTestsOnly(boolean shouldCollectTest) Ativa ou desativa o modo de coleta de testes
void	setConfiguration(IConfiguration configuration) Injeta o IConfiguration em uso.
void	setDevice(ITestDevice device) Injete o dispositivo em teste.
static void	setOptionToLoadedObject(Object testObj, keyValueOptions) Auxiliar para os executores de dispositivos usarem para definir opções da mesma forma que o HostTest, de set-option.
void	setTestInformation(TestInformation testInfo)
	split(Integer shardCount, TestInformation testInfo) Dividimos por indivíduo por classe ou método de teste.

Métodos protegidos
HostTest	createHostTest(Class<?> classObj) Auxiliar para criar uma instância de HostTest ao fazer sharding.
IBuildInfo	getBuild() Receba as informações de build recebidas pelo HostTest.
ClassLoader	getClassLoader() Retorna o carregador de classes padrão.
final	getClasses()
File	getJarFile(String jarName, TestInformation testInfo) Inspecione vários locais onde o artefato geralmente está localizado para diferentes casos de uso e encontre nosso jar.
boolean	hasJUnit4Annotation(Class<?> classObj) Ajuda a determinar se estamos lidando com uma classe de teste com anotações do Junit4.
Object	loadObject(Class<?> classObj) carregue o objeto da classe e defina as informações de teste (dispositivo, build).
void	setClassName(String className) Limpe e defina um nome de classe para ser executado.
boolean	shouldTestRun(AnnotatedElement annotatedElement) Verifica se um elemento com anotação passa pelo filtro.

Constantes

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Valor constante: "Opções a serem transmitidas para a classe em teste. A chave e o valor precisam ser separados por dois-pontos ":". Por exemplo, se a classe em teste aceitar "--iteration 1" de uma linha de comando, ela precisará ser transmitida como "--set-option iteration:1" ou "--set-option iteration:key=value" para transmitir opções ao mapa. Valores que contêm ":" ou "=" podem ser precedidos por uma barra invertida. É possível segmentar uma classe específica ao especificá-la. " --set-option ::""

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Valor da constante: "set-option"

Construtores públicos

HostTest

public HostTest ()

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Adiciona um ERROR(/Set) de anotações a serem excluídas se um teste for marcado com ele.

Parâmetros
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Parâmetros
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Adiciona um ERROR(/Set) de anotações para incluir se um teste for marcado com ele.

Parâmetros
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parâmetros
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Adiciona uma anotação para excluir se um teste for marcado com ela.

Parâmetros
notAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes excluir.

Parâmetros
filter	String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Adiciona uma anotação para incluir se um teste for marcado com ela.

Parâmetros
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

Adiciona um filtro de quais testes incluir.

Parâmetros
filter	String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Exclui todas as anotações de exclusão rastreadas no momento.

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Exclui todas as anotações de inclusão rastreadas no momento.

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

Retorna o número de casos de teste em todas as classes que fazem parte dos testes

Retorna
int

getAbi

public IAbi getAbi ()

Retorna
IAbi

getClassNames

public  getClassNames ()

Retorna

getDevice

public ITestDevice getDevice ()

Pegue o dispositivo em teste.

Retorna
ITestDevice	o ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

Retorna o ERROR(/Set) atual de anotações a serem excluídas.

Retorna

getExcludeFilters

public  getExcludeFilters ()

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

Retorna

getIncludeAnnotations

public  getIncludeAnnotations ()

Retorna o ERROR(/Set) atual de anotações a serem incluídas.

Retorna

getIncludeFilters

public  getIncludeFilters ()

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

Retorna

getRuntimeHint

public 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

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

setAbi

public void setAbi (IAbi abi)

Parâmetros
abi	IAbi

setBuild

public void setBuild (IBuildInfo buildInfo)

Parâmetros
buildInfo	IBuildInfo

setCollectTestsOnly

public 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

setDevice

public void setDevice (ITestDevice device)

Injete o dispositivo em teste.

Parâmetros
device	ITestDevice: o ITestDevice a ser usado

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Auxiliar para os executores de dispositivos usarem para definir opções da mesma forma que o HostTest, de set-option.

Parâmetros
testObj	Object: o objeto que vai receber as opções.
keyValueOptions	: a lista de opções formatada conforme exigido por HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parâmetros
testInfo	TestInformation

dividido

public  split (Integer shardCount, 
                TestInformation testInfo)

Dividimos por indivíduo por classe ou método de teste.

Parâmetros
shardCount	Integer: a contagem de fragmentos tentada.
testInfo	TestInformation: o TestInformation principal

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

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Auxiliar para criar uma instância de HostTest ao fazer sharding. Substituição para retornar qualquer filho de HostTest.

Parâmetros
classObj	Class

Retorna
HostTest

getBuild

protected IBuildInfo getBuild ()

Receba as informações de build recebidas pelo HostTest.

Retorna
IBuildInfo	o IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

Retorna o carregador de classes padrão.

Retorna
ClassLoader

getClasses

protected final  getClasses ()

Retorna

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspecione vários locais onde o artefato geralmente está localizado para diferentes casos de uso e encontre nosso jar.

Parâmetros
jarName	String
testInfo	TestInformation

Retorna
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Ajuda a determinar se estamos lidando com uma classe de teste com anotações do Junit4.

Parâmetros
classObj	Class

Retorna
boolean

loadObject

protected Object loadObject (Class<?> classObj)

carregue o objeto da classe e defina as informações de teste (dispositivo, build).

Parâmetros
classObj	Class

Retorna
Object

setClassName

protected void setClassName (String className)

Limpe e defina um nome de classe para ser executado.

Parâmetros
className	String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Verifique se um elemento com anotação passa pelo filtro. Exposto para testes de unidade.

Retorna
boolean	"false" se o teste não puder ser executado.