Teste de instrumentação

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

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

Subclasses diretas conhecidas AndroidJUnitTest e CodeCoverageTest AndroidJUnitTest (link em inglês) Um teste que executa um pacote de teste de instrumentação em determinado dispositivo usando o android.support.test.runner.AndroidJUnitRunner  CodeCoverageTest (link em inglês) 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 um 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
protected boolean	mInstrumentSdkInSandbox
protected boolean	mInstrumentSdkSandbox

Construtores públicos
InstrumentationTest()

Métodos públicos
void	addDeviceListeners( extraListeners) Permite adicionar mais listeners personalizados ao executor.
void	addInstrumentationArg(String key, String value) Adicione um argumento para ser fornecido ao executar os testes de instrumentação.
IAbi	getAbi()
IConfiguration	getConfiguration() Recebe o IConfiguration para este teste.
String	getCoverageTarget() Acesse o coverTarget definido anteriormente por setCoverageTarget(String).
boolean	getDebug() Acessa a configuração de depuração de instrumentação.
ITestDevice	getDevice() Colocar o dispositivo em teste.
String	getForceAbi()
long	getMaxTimeout() Retorna o tempo limite máximo definido para a instrumentação.
String	getPackageName() Faça o download do pacote de manifesto do Android para executá-lo.
String	getRunName() Consiga o nome da execução do teste personalizado que será fornecido ao listener
String	getRunnerName() Recebe o executor de instrumentação do Android a ser usado.
boolean	isOrchestrator() Retorna o valor de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)
void	run(TestInformation testInfo, ITestInvocationListener listener) Executa os testes e informa o resultado ao listener.
void	setAbi(IAbi abi)
void	setClassName(String testClassName) Se quiser, defina o nome da classe de teste para executar.
void	setCollectTestsOnly(boolean shouldCollectTest) Ativa ou desativa o modo de coleta de testes
void	setCollectsTestsShellTimeout(int timeout) Esse método foi descontinuado. Esse método é um ambiente autônomo
void	setConfiguration(IConfiguration config) Injeta o IConfiguration em uso.
void	setCoverageTarget(String coverageTarget) Defina a meta de cobertura deste teste.
void	setDebug(boolean debug) Define a configuração de depuração de instrumentação.
void	setDevice(ITestDevice device) Injete o dispositivo em teste.
void	setEnforceFormat(boolean enforce) Defina como "True" se aplicarmos o formato de saída de instrumentação AJUR.
void	setForceAbi(String abi) Define a opção force-abi.
void	setInstallFile(File installFile) Defina o arquivo opcional que contém os testes para instalação.
void	setIsolatedStorage(boolean isolatedStorage) Defina se quer ou não usar o armazenamento isolado.
void	setMethodName(String testMethodName) Se quiser, defina o método de teste para ser executado.
void	setMetricCollectors( collectors) Define a lista de IMetricCollectors definida para a execução do teste.
void	setOrchestrator(boolean useOrchestrator) Define a opção --orchestrator
void	setPackageName(String packageName) Configura o pacote de manifesto do Android para execução.
void	setReRunUsingTestFile(boolean reRunUsingTestFile) Define a opção --rerun-from-file.
void	setRerunMode(boolean rerun) Opcionalmente, defina o modo de nova execução.
void	setRunName(String runName) Defina o nome da execução do teste personalizado que será fornecido ao listener
void	setRunnerName(String runnerName) Se quiser, configure o executor de instrumentação Android para usá-lo.
void	setShellTimeout(long timeout) Opcionalmente, defina o tempo máximo (em milissegundos) esperado para 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 linhas classes e métodos de teste separados (formato: com.foo.Class#method) a serem executados.
void	setTestPackageName(String testPackageName) Define o filtro do pacote de teste.
void	setTestSize(String size) Se quiser, defina o tamanho do teste para ser executado.
void	setTestTimeout(long timeout) Também é possível definir o tempo máximo (em milissegundos) para cada execução de teste individual.
void	setTestsToRun( tests) Define a coleção de testes que precisam ser executados por esse InstrumentationTest.
void	setWindowAnimation(boolean windowAnimation)

Métodos protegidos
static	excludeNonExecuted(TestRunResult results) Filtrar "NOT_EXECUTED" e Ignorado com o objetivo de acompanhar o que precisa ser executado novamente.
String	getClassName() Receba o nome da classe a ser executada.
ListInstrumentationParser	getListInstrumentationParser() Acessar o ListInstrumentationParser usado para analisar a "instrumentação de lista de PM" consultas.
String	getMethodName() Encontre o método de teste para executar.
String	getTestPackageName() Acesse o pacote Java de teste para executar.
String	queryRunnerName() Consultar o dispositivo para usar um executor de testes.
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

Campos

EXECUTAR_TESTES_AS_CHAVE_DE_USUÁRIO

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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Construtores públicos

Teste de instrumentação

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite adicionar mais listeners personalizados ao executor.

Parâmetros
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Adicione um argumento para ser fornecido 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 ()

Retorna
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Recebe o IConfiguration para este teste.

Retorna
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Acesse o coverTarget definido anteriormente por setCoverageTarget(String).

Retorna
String

getDebug

public boolean getDebug ()

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

Retorna
boolean	A configuração de depuração booleana.

getDevice

public ITestDevice getDevice ()

Colocar o dispositivo em teste.

Retorna
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

Retorna
String

getMaxTimeout

public long getMaxTimeout ()

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

Retorna
long

getPackageName

public String getPackageName ()

Faça o download do pacote de manifesto do Android para executá-lo.

Retorna
String

getRunName

public String getRunName ()

Consiga o nome da execução do teste personalizado que será fornecido ao listener

Retorna
String

getRunnerName

public String getRunnerName ()

Recebe o executor de instrumentação do Android a ser usado.

Retorna
String

isOrchestrator

public boolean isOrchestrator ()

Retorna o valor de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)

Retorna
boolean

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 a serem executadas. provas.
listener	ITestInvocationListener: o ITestInvocationListener dos resultados do teste.

Gera
DeviceNotAvailableException

SetAbi

public void setAbi (IAbi abi)

Parâmetros
abi	IAbi

setClassName

public void setClassName (String testClassName)

Se quiser, defina o nome da classe de teste para executar.

Parâmetros
testClassName	String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de testes

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Esse método foi descontinuado.
Esse método é um ambiente autônomo,

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

Parâmetros
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

Injeta o IConfiguration em uso.

Parâmetros
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Defina a meta de cobertura deste teste.

Não é usado no momento. Esse método está presente, e ele pode ser recuperado depois pelo getCoverageTarget()

Parâmetros
coverageTarget	String

setDebug

public void setDebug (boolean debug)

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

Definir dispositivo

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 como "True" se aplicarmos o formato de saída de instrumentação AJUR.

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 que contém os testes para instalação.

Parâmetros
installFile	File: o ERROR(/File) instalável.

setIsolatedStorage.

public void setIsolatedStorage (boolean isolatedStorage)

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

Parâmetros
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

Se quiser, defina o método de teste para ser executado.

Parâmetros
testMethodName	String

setMetricCollectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollectors definida para a execução do teste.

Parâmetros
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Define a opção --orchestrator

Parâmetros
useOrchestrator	boolean

setPackageName

public void setPackageName (String packageName)

Configura o pacote de manifesto do Android para execução.

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 nova execução.

Parâmetros
rerun	boolean

setRunName

public void setRunName (String runName)

Defina o nome da execução do teste personalizado que será fornecido ao listener

Parâmetros
runName	String

setRunnerName

public void setRunnerName (String runnerName)

Se quiser, configure o executor de instrumentação Android para usá-lo.

Parâmetros
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

Opcionalmente, defina o tempo máximo (em milissegundos) esperado para 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 linhas classes e métodos de teste separados (formato: com.foo.Class#method) a serem executados. Se definido, tentar automaticamente executar novamente testes usando esse arquivo de teste por meio de InstrumentationFileTest, em vez de executar comandos adb separados para cada teste restante. por meio de uma nova execução.

Parâmetros
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Define o filtro do pacote de teste.

Se não nulo, apenas os testes dentro do pacote Java especificado serão executados.

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

Parâmetros
testPackageName	String

setTestSize

public void setTestSize (String size)

Se quiser, defina o tamanho do teste para ser executado.

Parâmetros
size	String

setTestTimeout

public void setTestTimeout (long timeout)

Também é possível definir o tempo máximo (em milissegundos) para cada execução de teste individual.

Parâmetros
timeout	long

setTestsToRun.

public void setTestsToRun ( tests)

Define a coleção de testes que precisam ser executados por esse InstrumentationTest.

Parâmetros
tests	: os testes a serem executados.

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parâmetros
windowAnimation	boolean

Métodos protegidos

excluirNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtrar "NOT_EXECUTED" e Ignorado com o objetivo de acompanhar o que precisa ser executado novamente.

Parâmetros
results	TestRunResult

Retorna

getClassName

protected String getClassName ()

Receba o nome da classe a ser executada.

Retorna
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Acessar o ListInstrumentationParser usado para analisar a "instrumentação de lista de PM" consultas.

Retorna
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Encontre o método de teste para executar.

Retorna
String

getTestPackageName

protected String getTestPackageName ()

Acesse o pacote Java de teste para executar.

Retorna
String

nome do corredor de consulta

protected String queryRunnerName ()

Consultar o dispositivo para usar um executor de testes.

Retorna
String	o nome do primeiro executor de teste que corresponde ao pacote ou nulo, se não encontrarmos nenhum.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parâmetros
runner	IRemoteAndroidTestRunner