RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

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

Ejecuta un comando de prueba de Android de forma remota y genera un informe de los resultados.

Resumen

Constructores públicos

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Constructor alternativo.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Constructor alternativo.

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

Crea un ejecutor de pruebas de Android remoto.

Métodos públicos

void addBooleanArg(String name, boolean value)

Agrega un argumento booleano para incluir en el comando de instrumentación.

void addInstrumentationArg(String name, String value)

Agrega un argumento para incluir en el comando de instrumentación.

void cancel()

Solicita la cancelación de esta ejecución de prueba.

IInstrumentationResultParser createParser(String runName, listeners)

Crea el objeto InstrumentationResultParser que se usará para analizar el resultado de la instrumentación.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Devuelve el tipo de cobertura de pruebas que produce el ejecutor.

String getPackageName()

Devuelve el nombre del paquete de la aplicación.

String getRunOptions()

Devuelve opciones para el comando am instrument.

String getRunnerName()

Devuelve el valor de runnerName.

void removeInstrumentationArg(String name)

Quita un argumento agregado anteriormente.

void run(ITestRunListener... listeners)

Ejecuta esta prueba.

void run( listeners)

Ejecuta esta prueba.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

Establece la ubicación de la salida de prueba adicional que se copiará en el host antes de desinstalar la app de prueba.

void setClassName(String className)

Establece que solo se ejecuten las pruebas de esta clase. Se debe llamar antes de "run".

void setClassNames(String[] classNames)

Establece que solo se ejecuten las pruebas en las clases proporcionadas. Se debe llamar antes de "run".

void setCoverage(boolean coverage)

Establece el modo de cobertura de código de esta ejecución de prueba.

void setCoverageReportLocation(String reportPath)

Establece la ubicación de los informes de cobertura generados.

void setDebug(boolean debug)

Establece el modo de depuración de esta ejecución de prueba.

void setLogOnly(boolean logOnly)

Establece esta ejecución de prueba en modo de solo registro, lo que omite la ejecución de la prueba.

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Establece el tiempo máximo permitido entre la salida del comando de shell que ejecuta las pruebas en los dispositivos.

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Establece el tiempo máximo permitido para que finalice la instrumentación.

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

Establece que solo se ejecute el método de prueba especificado. Se debe llamar antes de "run".

void setRunName(String runName)

Establece un nombre de ejecución personalizado para que se informe a ITestRunListener en run()

Si no se especifica, se usará el nombre del paquete.

void setRunOptions(String options)

Establece opciones para el comando de instrumentación am.

void setTestCollection(boolean collect)

Establece esta ejecución de prueba en el modo de recopilación de pruebas.

void setTestPackageName(String packageName)

Establece que se ejecuten todas las pruebas en el paquete especificado. Se debe llamar antes de "run".

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Establece que solo se ejecuten pruebas del tamaño determinado.

Métodos protegidos

String getArgsCommand()

Devuelve la sintaxis completa de la línea de comandos de la instrumentación para los argumentos de instrumentación proporcionados.

String getRunnerPath()

Devuelve la ruta de acceso completa del componente de instrumentación.

Constructores públicos

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Constructor alternativo. Se usa el ejecutor de la instrumentación predeterminado.

Parámetros
packageName String: Es el paquete de aplicación para Android que contiene las pruebas que se ejecutarán.
remoteDevice IShellEnabledDevice: Es el dispositivo Android en el que se ejecutarán las pruebas.

RemoteAndroidTestRunner

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

Constructor alternativo. Usa el valor predeterminado statusReporterMode.

Parámetros
packageName String: Es el paquete de aplicación para Android que contiene las pruebas que se ejecutarán.
runnerName String: Es el ejecutor de pruebas de instrumentación que se ejecutará. Si es nulo, se usará el ejecutor predeterminado.
remoteDevice IShellEnabledDevice: Es el dispositivo Android en el que se ejecutarán las pruebas.

RemoteAndroidTestRunner

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

Crea un ejecutor de pruebas de Android remoto.

Parámetros
packageName String: Es el paquete de aplicación para Android que contiene las pruebas que se ejecutarán.
runnerName String: Es el ejecutor de pruebas de instrumentación que se ejecutará. Si es nulo, se usará el ejecutor predeterminado.
remoteDevice IShellEnabledDevice: Es el dispositivo Android en el que se ejecutarán las pruebas.
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: Es el modo de reportero de estado que se usará para un comando de instrumento.

Métodos públicos

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

Agrega un argumento booleano para incluir en el comando de instrumentación.

Parámetros
name String: El nombre del argumento del paquete de la instrumentación
value boolean: Es el valor del argumento.

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

Agrega un argumento para incluir en el comando de instrumentación.

Se debe llamar antes de "run". Si ya se proporcionó un argumento con el nombre determinado, se anulará su valor.

Parámetros
name String: El nombre del argumento del paquete de la instrumentación
value String: Es el valor del argumento.

cancelar

public void cancel ()

Solicita la cancelación de esta ejecución de prueba.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Crea el objeto InstrumentationResultParser que se usará para analizar el resultado de la instrumentación.

Parámetros
runName String: Es el nombre de la ejecución que se usará.
listeners : Son los objetos de escucha en los que se informan los resultados.
Muestra
IInstrumentationResultParser Es una instancia de InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Muestra
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Devuelve el tipo de cobertura de pruebas que produce el ejecutor. Consulta los CoverageOutput.

Muestra
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Devuelve el nombre del paquete de la aplicación.

Muestra
String

getRunOptions

public String getRunOptions ()

Devuelve opciones para el comando am instrument.

Muestra
String

getRunnerName

public String getRunnerName ()

Devuelve el valor de runnerName.

Muestra
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

Quita un argumento agregado anteriormente.

Parámetros
name String: Es el nombre del argumento del paquete de instrumentación que se quitará.

run

public void run (ITestRunListener... listeners)

Ejecuta esta prueba.

Método de conveniencia para ERROR(/#run(Collection)).

Parámetros
listeners ITestRunListener: Escucha los resultados de las pruebas
Arroja
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

run

public void run ( listeners)

Ejecuta esta prueba.

Parámetros
listeners : Colección de objetos de escucha para los resultados de las pruebas
Arroja
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

Establece la ubicación de la salida de prueba adicional que se copiará en el host antes de desinstalar la app de prueba. p. ej., informes comparativos generados

Parámetros
additionalTestDataPath String

setClassName

public void setClassName (String className)

Establece que solo se ejecuten las pruebas de esta clase. Se debe llamar antes de "run".

Parámetros
className String: Nombre de clase completamente calificado (p. ej., x.y.z)

setClassNames

public void setClassNames (String[] classNames)

Establece que solo se ejecuten las pruebas en las clases proporcionadas. Se debe llamar antes de "run".

Si se proporciona más de una clase, se requiere un InstrumentationTestRunner que admita la sintaxis de argumentos de varias clases.

Parámetros
classNames String: Es un array de nombres de clase completamente calificados (p. ej., x.y.z).

setCoverage

public void setCoverage (boolean coverage)

Establece el modo de cobertura de código de esta ejecución de prueba.

Parámetros
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

Establece la ubicación de los informes de cobertura generados.

Parámetros
reportPath String

setDebug

public void setDebug (boolean debug)

Establece el modo de depuración de esta ejecución de prueba. Si es verdadero, el ejecutor de pruebas de Android esperará a que se adjunte un depurador antes de continuar con la ejecución de la prueba.

Parámetros
debug boolean

setLogOnly

public void setLogOnly (boolean logOnly)

Establece esta ejecución de prueba en modo de solo registro, lo que omite la ejecución de la prueba.

Parámetros
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Establece el tiempo máximo permitido entre la salida del comando de shell que ejecuta las pruebas en los dispositivos.

Esto permite establecer un tiempo de espera en caso de que las pruebas se queden atascadas y nunca finalicen. Esto es diferente del tiempo de espera normal de la conexión.

De forma predeterminada, no se especificará ningún tiempo de espera.

Parámetros
maxTimeToOutputResponse long: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que receiver cancele la ejecución) la salida del comando y nunca arrojará una excepción.
maxTimeUnits TimeUnit: Unidades para los valores maxTimeToOutputResponse y maxTimeout distintos de cero.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Establece el tiempo máximo permitido para que finalice la instrumentación.

Esto permite establecer un tiempo de espera en caso de que las pruebas se queden atascadas y nunca finalicen. Esto es diferente del tiempo de espera normal de la conexión.

De forma predeterminada, no se especificará ningún tiempo de espera.

Parámetros
maxTimeout long: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que receiver cancele la ejecución) la salida del comando y nunca arrojará una excepción.
maxTimeUnits TimeUnit: Unidades para los valores maxTimeToOutputResponse y maxTimeout distintos de cero.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parámetros
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

Establece que solo se ejecute el método de prueba especificado. Se debe llamar antes de "run".

Parámetros
className String: Nombre de clase completamente calificado (p. ej., x.y.z)
testName String: Nombre del método

setRunName

public void setRunName (String runName)

Establece un nombre de ejecución personalizado para que se informe a ITestRunListener en run()

Si no se especifica, se usará el nombre del paquete.

setRunOptions

public void setRunOptions (String options)

Establece opciones para el comando de instrumentación am. Consulta com/android/commands/am/Am.java para obtener la lista completa de opciones.

Parámetros
options String

setTestCollection

public void setTestCollection (boolean collect)

Establece esta ejecución de prueba en el modo de recopilación de pruebas. Si es verdadero, se omitirá la ejecución de la prueba y se establecerán todos los argumentos del ejecutor adecuados que se requieren para una recopilación de pruebas exitosa.

Parámetros
collect boolean

setTestPackageName

public void setTestPackageName (String packageName)

Establece que se ejecuten todas las pruebas en el paquete especificado. Se debe llamar antes de "run".

Parámetros
packageName String: Nombre del paquete completamente calificado (p. ej., x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Establece que solo se ejecuten pruebas del tamaño determinado. Se debe llamar antes de "run".

Parámetros
size IRemoteAndroidTestRunner.TestSize: Es el TestSize que se ejecutará.

Métodos protegidos

getArgsCommand

protected String getArgsCommand ()

Devuelve la sintaxis completa de la línea de comandos de la instrumentación para los argumentos de instrumentación proporcionados. Devuelve una cadena vacía si no se especificaron argumentos.

Muestra
String

getRunnerPath

protected String getRunnerPath ()

Devuelve la ruta de acceso completa del componente de instrumentación.

Muestra
String