InstrumentationTest

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

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

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

Resumo

Constantes

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

Campos

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

void addInstrumentationArg(String key, String value)

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

IAbi getAbi()
IConfiguration getConfiguration()

Recebe o IConfiguration para este teste.

String getCoverageTarget()

Recebe o coverageTarget definido anteriormente via setCoverageTarget(String).

boolean getDebug()

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

ITestDevice getDevice()

Pegue o dispositivo em teste.

String getForceAbi()
long getMaxTimeout()

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

String getPackageName()

Acesse o pacote de manifesto do Android para executar.

String getRunName()

Recebe o nome da execução de teste personalizada que será fornecida 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 a ser executada.

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 é uma operação nula.

void setConfiguration(IConfiguration config)

Injeta o IConfiguration em uso.

void setCoverageTarget(String coverageTarget)

Define a meta de cobertura para este 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 como "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 para instalar que contém os testes.

void setIsolatedStorage(boolean isolatedStorage)

Define se o armazenamento isolado será usado ou não.

void setMethodName(String testMethodName)

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

void setMetricCollectors( collectors)

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

void setOrchestrator(boolean useOrchestrator)

Define a opção --orchestrator

void setPackageName(String packageName)

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

void setReRunUsingTestFile(boolean reRunUsingTestFile)

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

void setRerunMode(boolean rerun)

Se quiser, defina o modo de nova execução.

void setRunName(String runName)

Defina o nome da execução de teste personalizada que será fornecida ao listener.

void setRunnerName(String runnerName)

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

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 contenha 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 de pacote de teste.

void setTestSize(String size)

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

void setTestTimeout(long timeout)

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

void setTestsToRun( tests)

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

void setWindowAnimation(boolean windowAnimation)

Métodos protegidos

static excludeNonExecuted(TestRunResult results)

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

String getClassName()

Receba o nome da classe para executar.

ListInstrumentationParser getListInstrumentationParser()

Recebe o ListInstrumentationParser usado para analisar consultas "pm list instrumentation".

String getMethodName()

Receba o método de teste para execução.

String getTestPackageName()

Faça o pacote Java de teste ser executado.

String queryRunnerName()

Consulte o dispositivo para usar um executor de teste.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Constantes

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Valor da constante: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Valor da constante: "RUN_TESTS_ON_SDK_SANDBOX"

Campos

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Construtores públicos

InstrumentationTest

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite adicionar mais listeners 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 ()

Retorna
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Recebe o IConfiguration para este teste.

Retorna
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Recebe o coverageTarget definido anteriormente via setCoverageTarget(String).

Retorna
String

getDebug

public boolean getDebug ()

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

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

getDevice

public ITestDevice getDevice ()

Pegue o dispositivo em teste.

Retorna
ITestDevice o 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 ()

Acesse o pacote de manifesto do Android para executar.

Retorna
String

getRunName

public String getRunName ()

Recebe o nome da execução de teste personalizada que será fornecida ao listener.

Retorna
String

getRunnerName

public String getRunnerName ()

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

Retorna
String

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

setClassName

public void setClassName (String testClassName)

Se quiser, defina o nome da classe de teste a ser executada.

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 é uma operação nula.

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)

Define a meta de cobertura deste teste.

Não é usado no momento. Esse 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 de 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

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Defina como "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 para instalar que contém os testes.

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Define se o armazenamento isolado será usado ou não.

Parâmetros
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

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

Parâmetros
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollectors definidos 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)

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

Se quiser, defina o modo de nova execução.

Parâmetros
rerun boolean

setRunName

public void setRunName (String runName)

Defina o nome da execução de teste personalizada que será fornecida ao listener.

Parâmetros
runName String

setRunnerName

public void setRunnerName (String runnerName)

Se quiser, 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) 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 contenha uma lista de classes e métodos de teste separados por linha (formato: com.foo.Class#method) a serem executados. Se definido, vai tentar executar novamente os testes automaticamente usando esse arquivo de teste via InstrumentationFileTest em vez de executar comandos adb separados para cada teste restante via nova execução.

Parâmetros
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Define o filtro de pacote de teste.

Se não for nulo, apenas os testes no pacote Java especificado 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)

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

Parâmetros
size String

setTestTimeout

public void setTestTimeout (long timeout)

Se quiser, defina 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 devem 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

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

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

Parâmetros
results TestRunResult

Retorna

getClassName

protected String getClassName ()

Receba o nome da classe para executar.

Retorna
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Recebe o ListInstrumentationParser usado para analisar consultas "pm list instrumentation".

Retorna
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Receba o método de teste para execução.

Retorna
String

getTestPackageName

protected String getTestPackageName ()

Faça o pacote Java de teste ser executado.

Retorna
String

queryRunnerName

protected String queryRunnerName ()

Consulte o dispositivo para usar um executor de teste.

Retorna
String o primeiro nome do executor de testes 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