InstrumentationTest

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

java.lang.Object
   ↳ com.android.tradefed.testtype.InstrumentationTest

Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado.

Resumen

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

Constructores públicos

InstrumentationTest()

Métodos públicos

void addDeviceListeners( extraListeners)

Permite agregar más objetos de escucha personalizados al ejecutor.

void addInstrumentationArg(String key, String value)

Agrega un argumento para proporcionar cuando ejecutes las pruebas de instrumentación.

IAbi getAbi()
IConfiguration getConfiguration()

Obtiene el IConfiguration para esta prueba.

String getCoverageTarget()

Obtén el coverageTarget que se configuró antes a través de setCoverageTarget(String).

boolean getDebug()

Obtén la configuración de depuración de instrumentación.

ITestDevice getDevice()

Obtén el dispositivo en prueba.

String getForceAbi()
long getMaxTimeout()

Devuelve el tiempo de espera máximo establecido para la instrumentación.

String getPackageName()

Obtén el paquete de manifiesto de Android para ejecutarlo.

String getRunName()

Obtén el nombre de la ejecución de prueba personalizada que se proporcionará al objeto de escucha

String getRunnerName()

Obtiene el ejecutor de instrumentación de Android que se usará.

boolean isOrchestrator()

Muestra el valor de ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

void run(TestInformation testInfo, ITestInvocationListener listener)

Ejecuta las pruebas y, luego, informa los resultados al objeto de escucha.

void setAbi(IAbi abi)
void setClassName(String testClassName)

De forma opcional, establece el nombre de la clase de prueba que se ejecutará.

void setCollectTestsOnly(boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas

void setCollectsTestsShellTimeout(int timeout)

Este método dejó de estar disponible. Este método no realiza ninguna acción.

void setConfiguration(IConfiguration config)

Inyecta el IConfiguration en uso.

void setCoverageTarget(String coverageTarget)

Establece el objetivo de cobertura de esta prueba.

void setDebug(boolean debug)

Establece la configuración de depuración de instrumentación.

void setDevice(ITestDevice device)

Inyecta el dispositivo en prueba.

void setEnforceFormat(boolean enforce)

Establece como verdadero si aplicamos el formato de salida AJUR de la instrumentación.

void setForceAbi(String abi)

Establece la opción force-abi.

void setInstallFile(File installFile)

Establece el archivo opcional que se instalará y que contiene las pruebas.

void setIsolatedStorage(boolean isolatedStorage)

Establece si quieres usar o no el almacenamiento aislado.

void setMethodName(String testMethodName)

De manera opcional, establece el método de prueba que se ejecutará.

void setMetricCollectors( collectors)

Establece la lista de IMetricCollector definidos para la ejecución de prueba.

void setOrchestrator(boolean useOrchestrator)

Establece la opción --orchestrator.

void setPackageName(String packageName)

Configura el paquete de manifiesto de Android para que se ejecute.

void setReRunUsingTestFile(boolean reRunUsingTestFile)

Establece la opción --rerun-from-file.

void setRerunMode(boolean rerun)

De manera opcional, establece el modo de repetición.

void setRunName(String runName)

Establece el nombre de la ejecución de prueba personalizada que se proporcionará al objeto de escucha.

void setRunnerName(String runnerName)

De manera opcional, configura el ejecutor de instrumentación de Android que se usará.

void setShellTimeout(long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) que se espera que el dispositivo muestre el resultado de la shell.

void setTestFilePathOnDevice(String testFilePathOnDevice)

De manera opcional, establece la ruta de acceso a un archivo ubicado en el dispositivo que debe contener una lista de clases y métodos de prueba separados por líneas (formato: com.foo.Class#method) que se ejecutarán.

void setTestPackageName(String testPackageName)

Establece el filtro de paquetes de prueba.

void setTestSize(String size)

De forma opcional, establece el tamaño de la prueba que se ejecutará.

void setTestTimeout(long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.

void setTestsToRun( tests)

Establece la colección de pruebas que debe ejecutar este InstrumentationTest.

void setWindowAnimation(boolean windowAnimation)

Métodos protegidos

static excludeNonExecuted(TestRunResult results)

Filtra "NOT_EXECUTED" y Omitido para hacer un seguimiento de lo que se debe volver a ejecutar.

String getClassName()

Obtén el nombre de la clase que se ejecutará.

ListInstrumentationParser getListInstrumentationParser()

Obtén el ListInstrumentationParser que se usa para analizar las consultas de "instrumentación de lista de pm".

String getMethodName()

Ejecuta el método de prueba.

String getTestPackageName()

Ejecuta el paquete de prueba de Java.

String queryRunnerName()

Consulta el dispositivo para usar un ejecutor de pruebas.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Campos

RUN_TESTS_AS_USER_KEY

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

Constructores públicos

InstrumentationTest

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite agregar más objetos de escucha personalizados al ejecutor.

Parámetros
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Agrega un argumento para proporcionar cuando ejecutes las pruebas de instrumentación.

Parámetros
key String: Es el nombre del argumento.
value String: El valor del argumento

getAbi

public IAbi getAbi ()

Muestra
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Obtiene el IConfiguration para esta prueba.

Muestra
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Obtén el coverageTarget que se configuró antes a través de setCoverageTarget(String).

Muestra
String

getDebug

public boolean getDebug ()

Obtén la configuración de depuración de instrumentación.

Muestra
boolean Es la configuración de depuración booleana.

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo en prueba.

Muestra
ITestDevice el ITestDevice

getForceAbi

public String getForceAbi ()

Muestra
String

getMaxTimeout

public long getMaxTimeout ()

Devuelve el tiempo de espera máximo establecido para la instrumentación.

Muestra
long

getPackageName

public String getPackageName ()

Obtén el paquete de manifiesto de Android para ejecutarlo.

Muestra
String

getRunName

public String getRunName ()

Obtén el nombre de la ejecución de prueba personalizada que se proporcionará al objeto de escucha

Muestra
String

getRunnerName

public String getRunnerName ()

Obtiene el ejecutor de instrumentación de Android que se usará.

Muestra
String

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y, luego, informa los resultados al objeto de escucha.

Parámetros
testInfo TestInformation: Es el objeto TestInformation que contiene información útil para ejecutar pruebas.
listener ITestInvocationListener: el ITestInvocationListener de los resultados de la prueba
Arroja
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parámetros
abi IAbi

setClassName

public void setClassName (String testClassName)

De forma opcional, establece el nombre de la clase de prueba que se ejecutará.

Parámetros
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Este método dejó de estar disponible.
Este método no realiza ninguna acción.

Establece el tiempo máximo en ms para permitir el "tiempo máximo para la respuesta de salida de shell" cuando se recopilan pruebas.

Parámetros
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

Inyecta el IConfiguration en uso.

Parámetros
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Establece el objetivo de cobertura de esta prueba.

Actualmente inactivo. Este método solo está presente para que coverageTarget se pueda recuperar más adelante a través de getCoverageTarget().

Parámetros
coverageTarget String

setDebug

public void setDebug (boolean debug)

Establece la configuración de depuración de instrumentación.

Parámetros
debug boolean: Es un valor booleano para establecer la configuración de depuración de instrumentación.

setDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo en prueba.

Parámetros
device ITestDevice: Es el ITestDevice que se usará.

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Establece como verdadero si aplicamos el formato de salida AJUR de la instrumentación.

Parámetros
enforce boolean

setForceAbi

public void setForceAbi (String abi)

Establece la opción force-abi.

setInstallFile

public void setInstallFile (File installFile)

Establece el archivo opcional que se instalará y que contiene las pruebas.

Parámetros
installFile File: El ERROR(/File) instalable

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Establece si quieres usar o no el almacenamiento aislado.

Parámetros
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

De manera opcional, establece el método de prueba que se ejecutará.

Parámetros
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Establece la lista de IMetricCollector definidos para la ejecución de prueba.

Parámetros
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Establece la opción --orchestrator.

Parámetros
useOrchestrator boolean

setPackageName

public void setPackageName (String packageName)

Configura el paquete de manifiesto de Android para que se ejecute.

Parámetros
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Establece la opción --rerun-from-file.

Parámetros
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

De manera opcional, establece el modo de repetición.

Parámetros
rerun boolean

setRunName

public void setRunName (String runName)

Establece el nombre de la ejecución de prueba personalizada que se proporcionará al objeto de escucha.

Parámetros
runName String

setRunnerName

public void setRunnerName (String runnerName)

De manera opcional, configura el ejecutor de instrumentación de Android que se usará.

Parámetros
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) que se espera que el dispositivo genere un resultado de shell.

Parámetros
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

De manera opcional, establece la ruta de acceso a un archivo ubicado en el dispositivo que debe contener una lista de clases y métodos de prueba separados por líneas (formato: com.foo.Class#method) que se ejecutarán. Si se establece, intentará volver a ejecutar las pruebas con este archivo de prueba a través de InstrumentationFileTest en lugar de ejecutar comandos adb independientes para cada prueba restante a través de la repetición.

Parámetros
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Establece el filtro de paquetes de prueba.

Si no es nulo, solo se ejecutarán las pruebas dentro del paquete Java determinado.

Se ignorará si se proporcionó un valor no nulo a setClassName(String).

Parámetros
testPackageName String

setTestSize

public void setTestSize (String size)

De forma opcional, establece el tamaño de la prueba que se ejecutará.

Parámetros
size String

setTestTimeout

public void setTestTimeout (long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.

Parámetros
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Establece la colección de pruebas que debe ejecutar este InstrumentationTest.

Parámetros
tests : Son las pruebas que se ejecutarán.

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parámetros
windowAnimation boolean

Métodos protegidos

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtra "NOT_EXECUTED" y Omitido para hacer un seguimiento de lo que se debe volver a ejecutar.

Parámetros
results TestRunResult

Muestra

getClassName

protected String getClassName ()

Obtén el nombre de la clase que se ejecutará.

Muestra
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtén el ListInstrumentationParser que se usa para analizar las consultas de "instrumentación de lista de pm".

Muestra
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Ejecuta el método de prueba.

Muestra
String

getTestPackageName

protected String getTestPackageName ()

Ejecuta el paquete de prueba de Java.

Muestra
String

queryRunnerName

protected String queryRunnerName ()

Consulta el dispositivo para usar un ejecutor de pruebas.

Muestra
String el primer nombre del ejecutor de pruebas que coincida con el paquete o nulo si no encontramos ninguno.
Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
runner IRemoteAndroidTestRunner