Teste de instrumentação
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
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 corredor |
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 |
String | getCoverageTarget () Obtenha a coberturaTarget definida anteriormente via |
boolean | getDebug () Obtenha a configuração de depuração da 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 () Faça com que o pacote de manifesto do Android seja 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 ao ouvinte. |
void | setAbi ( IAbi abi) |
void | setClassName (String testClassName) Opcionalmente, defina o nome da classe de teste para executar. |
void | setCollectTestsOnly (boolean shouldCollectTest) Ativa ou desativa o modo de coleta de teste |
void | setCollectsTestsShellTimeout (int timeout) Este método está obsoleto. Este método é um no-op |
void | setConfiguration ( IConfiguration config) Injeta o |
void | setCoverageTarget (String coverageTarget) Defina a meta de cobertura deste teste. |
void | setDebug (boolean debug) Defina a configuração de depuração da 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) Configure o arquivo opcional para instalação 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 para executar. |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Define a lista de |
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 |
String | getMethodName () Faça com que o método de teste seja executado. |
String | getTestPackageName () Faça com que o pacote java de teste seja 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 corredor
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 |
getConfiguration
public IConfiguration getConfiguration ()
Obtém o IConfiguration
para este teste.
devoluções | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
Obtenha a coberturaTarget definida anteriormente via setCoverageTarget(String)
.
devoluções | |
---|---|
String |
getDebug
public boolean getDebug ()
Obtenha a configuração de depuração da 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 ()
Faça com que o pacote de manifesto do Android seja 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 |
correr
public void run (TestInformation testInfo, ITestInvocationListener listener)
Executa os testes e relata 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 |
lances | |
---|---|
DeviceNotAvailableException |
setClassName
public void setClassName (String testClassName)
Opcionalmente, 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 teste
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
Este método está obsoleto.
Este método é um no-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 |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
Defina a meta de cobertura deste teste.
Atualmente sem uso. Este método está presente apenas para que coverageTarget possa ser recuperado posteriormente via getCoverageTarget()
Parâmetros | |
---|---|
coverageTarget | String |
setDebug
public void setDebug (boolean debug)
Defina a configuração de depuração da instrumentação.
Parâmetros | |
---|---|
debug | boolean : valor booleano para definir a configuração de depuração da instrumentação. |
setDevice
public void setDevice (ITestDevice device)
Injete o dispositivo em teste.
Parâmetros | |
---|---|
device | ITestDevice : o ITestDevice a ser usado |
definirEnforceFormat
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)
Configure o arquivo opcional para instalação que contém os testes.
Parâmetros | |
---|---|
installFile | File : o ERROR(/File) |
setIsolatedStorage
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 para executar.
Parâmetros | |
---|---|
testMethodName | String |
setMetricCollectors
public void setMetricCollectors (collectors)
Define a lista de IMetricCollector
s definidos para a execução do 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 |
definirTestSize
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 |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Parâmetros | |
---|---|
windowAnimation | boolean |
Métodos protegidos
excludeNonExecuted
protected staticexcludeNonExecuted (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 ()
Faça com que o método de teste seja executado.
devoluções | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
Faça com que o pacote java de teste seja 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 nulo se não encontrarmos nenhum. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |