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