RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Executa um comando de teste do Android remotamente e informa os resultados.

Resumo

Construtores públicos

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Construtor alternativo.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Construtor alternativo.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Cria um executor de testes do Android remoto.

Métodos públicos

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

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

void cancel()

Solicita o cancelamento desta execução de teste.

IInstrumentationResultParser createParser(String runName, listeners)

Crie o InstrumentationResultParser que será usado para analisar a saída da instrumentação.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Retorna o tipo de cobertura de teste produzido pelo executor.

String getPackageName()

Retorna o nome do pacote do aplicativo.

String getRunOptions()

Retorna opções para o comando "am instrument".

String getRunnerName()

Retorna o runnerName.

void removeInstrumentationArg(String name)

Remove um argumento adicionado anteriormente.

void run(ITestRunListener... listeners)

Execute essa execução de teste.

void run( listeners)

Execute essa execução de teste.

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.

void setClassName(String className)

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

void setClassNames(String[] classNames)

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

void setCoverage(boolean coverage)

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

void setCoverageReportLocation(String reportPath)

Define o local dos relatórios de cobertura gerados.

void setDebug(boolean debug)

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

void setLogOnly(boolean logOnly)

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

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.

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

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

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.

void setRunOptions(String options)

Define opções para o comando am instrument.

void setTestCollection(boolean collect)

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

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Define para executar apenas testes de determinado tamanho.

Métodos protegidos

String getArgsCommand()

Retorna a sintaxe completa da linha de comando de instrumentação para os argumentos de instrumentação fornecidos.

String getRunnerPath()

Retorna o caminho completo do componente de instrumentação.

Construtores públicos

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Construtor alternativo. Usa o executor de instrumentação padrão.

Parâmetros
packageName String: o pacote de aplicativos Android que contém os testes a serem executados.
remoteDevice IShellEnabledDevice: o dispositivo Android em que os testes serão executados

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Construtor alternativo. Usa o statusReporterMode padrão.

Parâmetros
packageName String: o pacote de aplicativos Android que contém os testes a serem executados.
runnerName String: o executor de testes de instrumentação a ser executado. Se for nulo, vai usar o executor padrão.
remoteDevice IShellEnabledDevice: o dispositivo Android em que os testes serão executados

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Cria um executor de testes do Android remoto.

Parâmetros
packageName String: o pacote de aplicativos Android que contém os testes a serem executados.
runnerName String: o executor de testes de instrumentação a ser executado. Se for nulo, vai usar o executor padrão.
remoteDevice IShellEnabledDevice: o dispositivo Android em que os testes serão executados
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: o modo de geração de relatórios de status a ser usado para um comando de instrumento.

Métodos públicos

addBooleanArg

public 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 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 void cancel ()

Solicita o cancelamento desta execução de teste.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Crie o InstrumentationResultParser que será usado para analisar a saída da instrumentação.

Parâmetros
runName String: o nome da execução a ser usada.
listeners : os listeners para informar os resultados.
Retorna
IInstrumentationResultParser Uma instância de InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Retorna
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Retorna
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Retorna o nome do pacote do aplicativo.

Retorna
String

getRunOptions

public String getRunOptions ()

Retorna opções para o comando "am instrument".

Retorna
String

getRunnerName

public String getRunnerName ()

Retorna o runnerName.

Retorna
String

removeInstrumentationArg

public 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 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

run

public void run ( listeners)

Execute essa execução de teste.

Parâmetros
listeners : coleção de listeners para resultados de teste.
Gera
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 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 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 void setCoverage (boolean coverage)

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

Parâmetros
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

Define o local dos relatórios de cobertura gerados.

Parâmetros
reportPath String

setDebug

public 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 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 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 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 void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parâmetros
maxTimeToOutputResponse int

setMethodName

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

setRunOptions

public void setRunOptions (String options)

Define opções para o comando am instrument. Consulte com/android/commands/am/Am.java para ver a lista completa de opções.

Parâmetros
options String

setTestCollection

public void setTestCollection (boolean collect)

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
collect boolean

setTestPackageName

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

Métodos protegidos

getArgsCommand

protected String getArgsCommand ()

Retorna a sintaxe completa da linha de comando de instrumentação para os argumentos de instrumentação fornecidos. Retorna uma string vazia se nenhum argumento for especificado.

Retorna
String

getRunnerPath

protected String getRunnerPath ()

Retorna o caminho completo do componente de instrumentação.

Retorna
String