O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

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 `IMetricCollector`s 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`