IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Interface para executar um comando de teste do Android remotamente e informar o resultado a um listener.

Resumo

Métodos públicos

abstract void addBooleanArg(String name, boolean value)

Adiciona um argumento booleano para incluir no comando de instrumentação.

abstract void addInstrumentationArg(String name, String value)

Adiciona um argumento a ser incluído no comando de instrumentação.

abstract void cancel()

Solicita o cancelamento desta execução de teste.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Retorna o tipo de cobertura de teste produzido pelo executor.

abstract String getPackageName()

Retorna o nome do pacote do aplicativo.

abstract String getRunnerName()

Retorna o runnerName.

abstract void removeInstrumentationArg(String name)

Remove um argumento adicionado anteriormente.

abstract void run(ITestRunListener... listeners)

Execute essa execução de teste.

abstract void run( listeners)

Execute essa execução de teste.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

Define o local da saída de teste adicional a ser copiada para o host antes da desinstalação do app de teste.

abstract void setClassName(String className)

Define para executar apenas testes nesta classe. Precisa ser chamado antes de "run".

abstract void setClassNames(String[] classNames)

Define para executar apenas testes nas classes fornecidas. Precisa ser chamado antes de "run".

abstract void setCoverage(boolean coverage)

Define o modo de cobertura de código desta execução de teste.

abstract void setCoverageReportLocation(String reportPath)

Define o local dos relatórios de cobertura gerados.

abstract void setDebug(boolean debug)

Define o modo de depuração desta execução de teste.

abstract void setLogOnly(boolean logOnly)

Define esta execução de teste como modo somente de registro em log e ignora a execução do teste.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Define o tempo máximo permitido entre a saída do comando do shell que executa os testes nos dispositivos.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Define o tempo máximo permitido para a conclusão da instrumentação.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Esse método foi descontinuado. Use ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

abstract void setMethodName(String className, String testName)

Define para executar apenas o método de teste especificado. Precisa ser chamado antes de "run".

abstract void setRunName(String runName)

Defina um nome de execução personalizado para ser informado ao ITestRunListener em run()

Se não for especificado, o nome do pacote será usado.

abstract void setTestCollection(boolean collection)

Define esta execução de teste como modo de coleta de teste.

abstract void setTestPackageName(String packageName)

Define para executar todos os testes no pacote especificado. Precisa ser chamado antes de "run".

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Define para executar apenas testes de determinado tamanho.

Métodos públicos

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Adiciona um argumento booleano para incluir no comando de instrumentação.

Parâmetros
name String: o nome do argumento do pacote de instrumentação
value boolean: o valor do argumento

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Adiciona um argumento a ser incluído no comando de instrumentação.

Precisa ser chamado antes de "run". Se um argumento com o nome especificado já tiver sido fornecido, o valor dele será substituído.

Parâmetros
name String: o nome do argumento do pacote de instrumentação
value String: o valor do argumento

cancelar

public abstract void cancel ()

Solicita o cancelamento desta execução de teste.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Retorna o tipo de cobertura de teste produzido pelo executor. Consulte CoverageOutput.

Retorna
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Retorna o nome do pacote do aplicativo.

Retorna
String

getRunnerName

public abstract String getRunnerName ()

Retorna o runnerName.

Retorna
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Remove um argumento adicionado anteriormente.

Parâmetros
name String: o nome do argumento do pacote de instrumentação a ser removido

run

public abstract void run (ITestRunListener... listeners)

Execute essa execução de teste.

Método de conveniência para ERROR(/#run(Collection)).

Parâmetros
listeners ITestRunListener: aguarda os resultados do teste
Gera
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException se o dispositivo não gerar nenhum resultado de teste por um período maior do que o tempo máximo para saída.
se a conexão com o dispositivo foi perdida.

run

public abstract void run ( listeners)

Execute essa execução de teste.

Parâmetros
listeners : coleção de listeners para resultados de teste.
Gera
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException se o dispositivo não gerar nenhum resultado de teste por um período maior do que o tempo máximo para saída.
se a conexão com o dispositivo foi perdida.

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Define o local da saída de teste adicional a ser copiada para o host antes da desinstalação do app de teste. Por exemplo, relatórios comparativos gerados.

Parâmetros
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

Define para executar apenas testes nesta classe. Precisa ser chamado antes de "run".

Parâmetros
className String: nome da classe totalmente qualificado (por exemplo, x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Define para executar apenas testes nas classes fornecidas. Precisa ser chamado antes de "run".

Se você fornecer mais de uma classe, será necessário um InstrumentationTestRunner que ofereça suporte à sintaxe de argumento de várias classes.

Parâmetros
classNames String: matriz de nomes de classes totalmente qualificados (por exemplo, x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Define o modo de cobertura de código desta execução de teste.

Parâmetros
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Define o local dos relatórios de cobertura gerados.

Parâmetros
reportPath String

setDebug

public abstract void setDebug (boolean debug)

Define o modo de depuração desta execução de teste. Se for "true", o executor de testes do Android vai aguardar a conexão de um depurador antes de continuar com a execução do teste.

Parâmetros
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Define esta execução de teste como modo somente de registro em log e ignora a execução do teste.

Parâmetros
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Define o tempo máximo permitido entre a saída do comando do shell que executa os testes nos dispositivos.

Isso permite definir um tempo limite caso os testes fiquem presos e nunca terminem. Isso é diferente do tempo limite normal da conexão.

Por padrão, nenhum tempo limite é especificado.

Parâmetros
maxTimeToOutputResponse long: o período máximo em que o comando pode não gerar nenhuma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o receiver cancele a execução) a saída do comando e nunca vai gerar uma exceção.
maxTimeUnits TimeUnit: unidades para valores maxTimeToOutputResponse e maxTimeout diferentes de zero.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Define o tempo máximo permitido para a conclusão da instrumentação.

Isso permite definir um tempo limite caso os testes fiquem presos e nunca terminem. Isso é diferente do tempo limite normal da conexão.

Por padrão, nenhum tempo limite é especificado.

Parâmetros
maxTimeout long: o período máximo em que o comando pode não gerar uma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o receiver cancele a execução) a saída do comando e nunca vai gerar uma exceção.
maxTimeUnits TimeUnit: unidades para valores maxTimeToOutputResponse e maxTimeout diferentes de zero.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Esse método foi descontinuado.
Use ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

Parâmetros
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Define para executar apenas o método de teste especificado. Precisa ser chamado antes de "run".

Parâmetros
className String: nome da classe totalmente qualificado (por exemplo, x.y.z)
testName String: nome do método

setRunName

public abstract void setRunName (String runName)

Defina um nome de execução personalizado para ser informado ao ITestRunListener em run()

Se não for especificado, o nome do pacote será usado.

setTestCollection

public abstract void setTestCollection (boolean collection)

Define esta execução de teste como modo de coleta de teste. Se for verdadeiro, vai pular a execução do teste e definir todos os argumentos de execução adequados necessários para uma coleta de teste bem-sucedida.

Parâmetros
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Define para executar todos os testes no pacote especificado. Precisa ser chamado antes de "run".

Parâmetros
packageName String: nome totalmente qualificado do pacote (por exemplo, x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Define para executar apenas testes de determinado tamanho. Precisa ser chamado antes de "run".

Parâmetros
size IRemoteAndroidTestRunner.TestSize: o TestSize a ser executado.