Teste de Instrumentação

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

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

Subclasses diretas conhecidas AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest Um teste que executa um pacote de teste de instrumentação em determinado dispositivo usando o android.support.test.runner.AndroidJUnitRunner. Teste de Cobertura de Código Um teste que executa um pacote de teste de instrumentação em um determinado dispositivo e gera o relatório de cobertura de código.

---

Um teste que executa um pacote de teste de instrumentação em determinado dispositivo.

Resumo

Campos
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug

Construtores públicos
InstrumentationTest ()

Métodos públicos
void	addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) Permite adicionar mais ouvintes personalizados ao runner
void	addInstrumentationArg (String key, String value) Adicione um argumento para fornecer ao executar os testes de instrumentação.
IAbi	getAbi ()
IConfiguration	getConfiguration () Obtém o IConfiguration para este teste.
String	getCoverageTarget () Obtenha o coverageTarget definido anteriormente por meio setCoverageTarget(String) .
boolean	getDebug () Obtenha a configuração de depuração de instrumentação.
ITestDevice	getDevice () Coloque o dispositivo em teste.
String	getForceAbi ()
long	getMaxTimeout () Retorna o tempo limite máximo definido para a instrumentação.
String	getPackageName () Obtenha o pacote de manifesto do Android para ser executado.
String	getRunName () Obtenha o nome de execução de teste personalizado que será fornecido ao ouvinte
String	getRunnerName () Obtém o executor de instrumentação do Android a ser usado.
void	run ( TestInformation testInfo, ITestInvocationListener listener) Executa os testes e relata o resultado para o ouvinte.
void	setAbi ( IAbi abi)
void	setClassName (String testClassName) Opcionalmente, defina o nome da classe de teste para execução.
void	setCollectTestsOnly (boolean shouldCollectTest) Habilita ou desabilita o modo de coleta de teste
void	setCollectsTestsShellTimeout (int timeout) Este método está obsoleto. Este método é um não-op
void	setConfiguration ( IConfiguration config) Injeta o IConfiguration em uso.
void	setCoverageTarget (String coverageTarget) Defina a meta de cobertura deste teste.
void	setDebug (boolean debug) Defina a configuração de depuração de instrumentação.
void	setDevice ( ITestDevice device) Injete o dispositivo em teste.
void	setEnforceFormat (boolean enforce) Defina True se aplicarmos o formato de saída AJUR da instrumentação.
void	setForceAbi (String abi) Define a opção force-abi.
void	setInstallFile (File installFile) Defina o arquivo opcional a ser instalado que contém os testes.
void	setIsolatedStorage (boolean isolatedStorage) Defina se deve ou não usar o armazenamento isolado.
void	setMethodName (String testMethodName) Opcionalmente, defina o método de teste a ser executado.
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) Define a lista de IMetricCollector s definidos para a execução de teste.
void	setPackageName (String packageName) Defina o pacote de manifesto do Android para ser executado.
void	setReRunUsingTestFile (boolean reRunUsingTestFile) Define a opção --rerun-from-file.
void	setRerunMode (boolean rerun) Opcionalmente, defina o modo de reexecução.
void	setRunName (String runName) Defina o nome de execução de teste personalizado que será fornecido ao ouvinte
void	setRunnerName (String runnerName) Opcionalmente, defina o executor de instrumentação do Android a ser usado.
void	setShellTimeout (long timeout) Opcionalmente, defina o tempo máximo (em milissegundos) esperando a saída do shell do dispositivo.
void	setTestFilePathOnDevice (String testFilePathOnDevice) Opcionalmente, defina o caminho para um arquivo localizado no dispositivo que deve conter uma lista de classes e métodos de teste separados por linha (formato: com.foo.Class#method) a serem executados.
void	setTestPackageName (String testPackageName) Define o filtro do pacote de teste.
void	setTestSize (String size) Opcionalmente, defina o tamanho do teste a ser executado.
void	setTestTimeout (long timeout) Opcionalmente, defina o tempo máximo (em milissegundos) para cada execução de teste individual.
void	setTestsToRun ( tests) setTestsToRun ( tests) Defina a coleção de testes que devem ser executados por este InstrumentationTest.
void	setWindowAnimation (boolean windowAnimation)

Métodos protegidos
static	excludeNonExecuted ( TestRunResult results) Filtre "NOT_EXECUTED" para rastrear o que precisa ser executado novamente.
String	getClassName () Obtenha o nome da classe para executar.
ListInstrumentationParser	getListInstrumentationParser () Obtenha o ListInstrumentationParser usado para analisar consultas 'pm list instrumentation'.
String	getMethodName () Obtenha o método de teste para ser executado.
String	getTestPackageName () Obtenha o pacote java de teste para ser executado.
String	queryRunnerName () Consulte o dispositivo para um executor de teste usar.
void	setRunnerArgs (IRemoteAndroidTestRunner runner)

Campos

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

Construtores públicos

Teste de Instrumentação

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite adicionar mais ouvintes personalizados ao runner

Parâmetros
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Adicione um argumento para fornecer ao executar os testes de instrumentação.

Parâmetros
key	String : o nome do argumento
value	String : o valor do argumento

getAbi

public IAbi getAbi ()

Devoluções
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Obtém o IConfiguration para este teste.

Devoluções
IConfiguration

getCoverageTget

public String getCoverageTarget ()

Obtenha o coverageTarget definido anteriormente por meio setCoverageTarget(String) .

Devoluções
String

getDebug

public boolean getDebug ()

Obtenha a configuração de depuração de instrumentação.

Devoluções
boolean	A configuração de depuração booleana.

getDevice

public ITestDevice getDevice ()

Coloque o dispositivo em teste.

Devoluções
ITestDevice	o ITestDevice

getForceAbi

public String getForceAbi ()

Devoluções
String

getMaxTimeout

public long getMaxTimeout ()

Retorna o tempo limite máximo definido para a instrumentação.

Devoluções
long

getPackageName

public String getPackageName ()

Obtenha o pacote de manifesto do Android para ser executado.

Devoluções
String

getRunName

public String getRunName ()

Obtenha o nome de execução de teste personalizado que será fornecido ao ouvinte

Devoluções
String

getRunnerName

public String getRunnerName ()

Obtém o executor de instrumentação do Android a ser usado.

Devoluções
String

corre

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Executa os testes e relata o resultado para o ouvinte.

Parâmetros
testInfo	TestInformation : O objeto TestInformation contendo informações úteis para executar testes.
listener	ITestInvocationListener : o ITestInvocationListener dos resultados do teste

Lança
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parâmetros
abi	IAbi

setClassName

public void setClassName (String testClassName)

Opcionalmente, defina o nome da classe de teste para execução.

Parâmetros
testClassName	String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita ou desabilita o modo de coleta de teste

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Este método está obsoleto.
Este método é um não-op

Defina o tempo máximo em ms para permitir o 'tempo máximo para resposta de saída do shell' ao coletar testes.

Parâmetros
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

Injeta o IConfiguration em uso.

Parâmetros
config	IConfiguration

definir Meta de Cobertura

public void setCoverageTarget (String coverageTarget)

Defina a meta de cobertura deste teste.

Atualmente não utilizado. Este método está apenas presente para que o coverageTarget possa ser recuperado posteriormente via getCoverageTarget()

Parâmetros
coverageTarget	String

setDebug

public void setDebug (boolean debug)

Defina a configuração de depuração de instrumentação.

Parâmetros
debug	boolean : valor booleano para definir a configuração de depuração de instrumentação.

setDevice

public void setDevice (ITestDevice device)

Injete o dispositivo em teste.

Parâmetros
device	ITestDevice : o ITestDevice a ser usado

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Defina True se aplicarmos o formato de saída AJUR da instrumentação.

Parâmetros
enforce	boolean

setForceAbi

public void setForceAbi (String abi)

Define a opção force-abi.

setInstallFile

public void setInstallFile (File installFile)

Defina o arquivo opcional a ser instalado que contém os testes.

Parâmetros
installFile	File : o ERROR(/File)

setIsolatedArmazenamento

public void setIsolatedStorage (boolean isolatedStorage)

Defina se deve ou não usar o armazenamento isolado.

Parâmetros
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

Opcionalmente, defina o método de teste a ser executado.

Parâmetros
testMethodName	String

setMetric Collectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollector s definidos para a execução de teste.

Parâmetros
collectors

setPackageName

public void setPackageName (String packageName)

Defina o pacote de manifesto do Android para ser executado.

Parâmetros
packageName	String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Define a opção --rerun-from-file.

Parâmetros
reRunUsingTestFile	boolean

setRerunMode

public void setRerunMode (boolean rerun)

Opcionalmente, defina o modo de reexecução.

Parâmetros
rerun	boolean

setRunName

public void setRunName (String runName)

Defina o nome de execução de teste personalizado que será fornecido ao ouvinte

Parâmetros
runName	String

setRunnerName

public void setRunnerName (String runnerName)

Opcionalmente, defina o executor de instrumentação do Android a ser usado.

Parâmetros
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

Opcionalmente, defina o tempo máximo (em milissegundos) esperando a saída do shell do dispositivo.

Parâmetros
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Opcionalmente, defina o caminho para um arquivo localizado no dispositivo que deve conter uma lista de classes e métodos de teste separados por linha (formato: com.foo.Class#method) a serem executados. Se definido, tentará automaticamente executar novamente os testes usando este arquivo de teste por meio de InstrumentationFileTest em vez de executar comandos adb separados para cada teste restante por meio de nova execução.

Parâmetros
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Define o filtro do pacote de teste.

Se não for nulo, apenas os testes dentro do pacote java fornecido serão executados.

Será ignorado se um valor não nulo tiver sido fornecido para setClassName(String)

Parâmetros
testPackageName	String

setTestSize

public void setTestSize (String size)

Opcionalmente, defina o tamanho do teste a ser executado.

Parâmetros
size	String

setTestTimeout

public void setTestTimeout (long timeout)

Opcionalmente, defina o tempo máximo (em milissegundos) para cada execução de teste individual.

Parâmetros
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

Defina a coleção de testes que devem ser executados por este InstrumentationTest.

Parâmetros
tests	: os testes a serem executados

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parâmetros
windowAnimation	boolean

Métodos protegidos

excluirNão executado

protected static  excludeNonExecuted (TestRunResult results)

Filtre "NOT_EXECUTED" para rastrear o que precisa ser executado novamente.

Parâmetros
results	TestRunResult

Devoluções

getClassName

protected String getClassName ()

Obtenha o nome da classe para executar.

Devoluções
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenha o ListInstrumentationParser usado para analisar consultas 'pm list instrumentation'.

Devoluções
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Obtenha o método de teste para ser executado.

Devoluções
String

getTestPackageName

protected String getTestPackageName ()

Obtenha o pacote java de teste para ser executado.

Devoluções
String

queryRunnerName

protected String queryRunnerName ()

Consulte o dispositivo para um executor de teste usar.

Devoluções
String	o primeiro nome do executor de teste que corresponde ao pacote ou null se não encontrarmos nenhum.

Lança
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parâmetros
runner	IRemoteAndroidTestRunner