Esta página foi traduzida pela API Cloud Translation.

InstrumentaçãoTeste

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 android.support.test.runner.AndroidJUnitRunner.
Teste de cobertura de código	Um Teste que executa um pacote de testes de instrumentação em um determinado dispositivo e gera o relatório de cobertura de código.

Um teste que executa um pacote de testes 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`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Construtores públicos
`InstrumentationTest ()`

Métodos públicos
`void`	`addDeviceListeners ( extraListeners)` `addDeviceListeners ( extraListeners)` Permite adicionar mais ouvintes personalizados ao executor
`void`	`addInstrumentationArg (String key, String value)` Adicione um argumento a ser fornecido ao executar os testes de instrumentação.
`IAbi`	`getAbi ()`
`IConfiguration`	`getConfiguration ()` Obtém o `IConfiguration` para este teste.
`String`	`getCoverageTarget ()` Obtenha ocoverageTarget definido anteriormente por meio de `setCoverageTarget(String)` .
`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 personalizado da execução de teste que será fornecido ao ouvinte
`String`	`getRunnerName ()` Obtém 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 reporta o resultado ao ouvinte.
`void`	`setAbi ( IAbi abi)`
`void`	`setClassName (String testClassName)` Opcionalmente, defina o nome da classe de teste para execução.
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Ativa ou desativa o modo de coleta de testes
`void`	`setCollectsTestsShellTimeout (int timeout)` Este método está obsoleto. Este método é 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)` 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 deseja ou não usar o armazenamento isolado.
`void`	`setMethodName (String testMethodName)` Opcionalmente, defina o método de teste para execução.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Define a lista de `IMetricCollector` s definidos para a execução de 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)` Opcionalmente, defina o modo de nova execução.
`void`	`setRunName (String runName)` Defina o nome personalizado da execução de teste 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) de espera da 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" com a finalidade de 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 de 'instrumentação de lista pm'.
`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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Construtores públicos

InstrumentaçãoTeste

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite adicionar mais ouvintes personalizados ao executor

Parâmetros
`extraListeners`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Adicione um argumento a 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 ()

Devoluções
`IAbi`

getConfiguração

public IConfiguration getConfiguration ()

Obtém o IConfiguration para este teste.

Devoluções
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Obtenha ocoverageTarget definido anteriormente por meio de 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 personalizado da execução de teste 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`

éOrquestrador

public boolean isOrchestrator ()

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

Devoluções
`boolean`

correr

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Executa os testes e reporta 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

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)

Ativa ou desativa o modo de coleta de testes

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Este método está obsoleto.
Este método é autônomo

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`

setConfiguração

public void setConfiguration (IConfiguration config)

Injeta o IConfiguration em uso.

Parâmetros
`config`	`IConfiguration`

definirCoverageTarget

public void setCoverageTarget (String coverageTarget)

Defina a meta de cobertura deste teste.

Atualmente não utilizado. Este método está presente apenas para que ocoverageTarget 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.

setDispositivo

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)

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

Parâmetros
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parâmetros
`collectors`

setOrquestrador

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)

Opcionalmente, defina o modo de nova execução.

Parâmetros
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Defina o nome personalizado da execução de teste 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) de espera da 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 reexecutar testes usando este arquivo de teste por meio de InstrumentationFileTest em vez de executar comandos adb separados para cada teste restante por meio de reexecuçã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

excluirNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtre "NOT_EXECUTED" com a finalidade de 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 de 'instrumentação de lista pm'.

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 nome do primeiro executor de teste que corresponde ao pacote ou nulo se não encontrarmos nenhum.

Lança
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parâmetros
`runner`	`IRemoteAndroidTestRunner`