HostTest

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

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


Um executor 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

Campos

public static final String SET_OPTION_DESC

public static final String SET_OPTION_NAME

Construtores públicos

HostTest()

Métodos públicos

void addAllExcludeAnnotation( notAnnotations)

Adiciona uma ERROR(/Set) de anotações para excluir se um teste for marcado com ela.

void addAllExcludeFilters( filters)

Adiciona o ERROR(/Set) de filtros de quais testes serão excluídos.

void addAllIncludeAnnotation( annotations)

Adiciona uma ERROR(/Set) de anotações para incluir se um teste está marcado com ela.

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 serão excluídos.

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()

Excluir todas as anotações de exclusão atualmente rastreadas.

void clearExcludeFilters()

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

void clearIncludeAnnotations()

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

void clearIncludeFilters()

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

int countTestCases()

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

IAbi getAbi()

getClassNames()
ITestDevice getDevice()

Pegue o dispositivo em teste.

getExcludeAnnotations()

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

getExcludeFilters()

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

getIncludeAnnotations()

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

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)

Assistente 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)

Auxílio para criar uma instância do HostTest ao fazer fragmentação.

IBuildInfo getBuild()

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

ClassLoader getClassLoader()

Retorna o carregador de classe 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 para encontrar o jarro.

boolean hasJUnit4Annotation(Class<?> classObj)

Ajudante para determinar se estamos lidando com uma classe de teste com anotações Junit4.

Object loadObject(Class<?> classObj)

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

void setClassName(String className)

Limpe e defina o nome da classe a ser executada.

boolean shouldTestRun(AnnotatedElement annotatedElement)

Verifique se um elemento com anotação passa pelo filtro.

Campos

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Construtores públicos

Teste do host

public HostTest ()

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Adiciona uma ERROR(/Set) de anotações para excluir testes se estiverem marcados com ele.

Parâmetros
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes serão excluídos.

Parâmetros
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Adiciona uma ERROR(/Set) de anotações para incluir se um teste está marcado com ela.

Parâmetros
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes serão incluídos.

Parâmetros
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Parâmetros
notAnnotation String

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes serão excluídos.

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 ()

Excluir todas as anotações de exclusão que estão sendo rastreadas.

clearExcludeFilters

public void clearExcludeFilters ()

Excluir todos os filtros de exclusão que estão sendo rastreados.

ClearIncludeAnnotations

public void clearIncludeAnnotations ()

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

clearIncludeFilters

public void clearIncludeFilters ()

Exclua 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 a 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 execução fragmentada

Retorna
long

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Executa os testes e informa o resultado ao ouvinte.

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 que os Device Runners definam opções da mesma forma que o HostTest, usando set-option.

Parâmetros
testObj Object: o objeto que receberá as opções.

keyValueOptions : a lista de opções formatadas conforme a opção "set-option" do HostTest exige.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parâmetros
testInfo TestInformation

dividir

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

testInfo TestInformation: o TestInformation pai

Retorna
uma coleção de subtestes a serem executados separadamente ou null se o teste não puder ser dividido em fragmentos

Métodos protegidos

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Auxílio para criar uma instância do HostTest ao fazer fragmentação. Modifique para retornar qualquer filho de HostTest.

Parâmetros
classObj Class

Retorna
HostTest

getBuild

protected IBuildInfo getBuild ()

Receber as informações do build recebidas pelo HostTest.

Retorna
IBuildInfo o IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

Retorna o classloader 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 para encontrar o jarro.

Parâmetros
jarName String

testInfo TestInformation

Retorna
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

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

Parâmetros
classObj Class

Retorna
boolean

loadObject

protected Object loadObject (Class<?> classObj)

carregue o objeto de classe e defina as informações do 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)

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

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