Google is committed to advancing racial equity for Black communities. See how.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Prueba de instrumentación

public class InstrumentationTest
extends Object implements IDeviceTest , IResumableTest , ITestCollector , IAbiReceiver , IInvocationContextReceiver , IMetricCollectorReceiver

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


Una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo dado.

Resumen

Campos

protected boolean mDebug

Constructores públicos

InstrumentationTest ()

Métodos públicos

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Permite agregar más oyentes personalizados al corredor

void addInstrumentationArg (String key, String value)

Agregue un argumento para proporcionar al ejecutar las pruebas de instrumentación.

IAbi getAbi ()
String getCoverageTarget ()

Obtenga el setCoverageTarget(String) cobertura establecido previamente mediante setCoverageTarget(String) .

boolean getDebug ()

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

ITestDevice getDevice ()

Obtenga el dispositivo bajo prueba.

String getForceAbi ()
long getMaxTimeout ()

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

String getPackageName ()

Obtenga el paquete de manifiesto de Android para ejecutar.

String getRunName ()

Obtenga el nombre de ejecución de prueba personalizado que se proporcionará al oyente

String getRunnerName ()

Obtiene el corredor de instrumentación de Android que se utilizará.

boolean isResumable ()

void run ( ITestInvocationListener listener)

Ejecuta las pruebas e informa el resultado al oyente.

void setAbi ( IAbi abi)
void setBugreportFrequency ( BugreportCollector.Freq freq)

Establezca la frecuencia con la que se recopilarán automáticamente informes de errores después de fallas en las pruebas.

void setClassName (String testClassName)

Opcionalmente, configure el nombre de la clase de prueba para ejecutar.

void setCollectTestsOnly (boolean shouldCollectTest)

Activa o desactiva el modo de recopilación de pruebas.

void setCollectsTestsShellTimeout (int timeout)

Este método está en desuso. Este método es un no-op

void setCoverageTarget (String coverageTarget)

Establezca el objetivo de cobertura de esta prueba.

void setDebug (boolean debug)

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

void setDevice ( ITestDevice device)

Inyecte el dispositivo bajo prueba.

void setEnforceFormat (boolean enforce)

Establezca True si aplicamos el formato de salida AJUR de instrumentación.

void setFallbackToSerialRerun (boolean reRunSerially)

Establece la opción --fallback-to-serial-rerun.

void setForceAbi (String abi)

Establece la opción force-abi.

void setInstallFile (File installFile)

Establezca el archivo opcional para instalar que contiene las pruebas.

void setInvocationContext ( IInvocationContext invocationContext)
void setIsolatedStorage (boolean isolatedStorage)

Establezca si usar o no el almacenamiento aislado.

void setMethodName (String testMethodName)

Opcionalmente, configure el método de prueba para que se ejecute.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

void setPackageName (String packageName)

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

void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

void setRebootBeforeReRun (boolean rebootBeforeReRun)

Establece la opción --reboot-before-rerun.

void setRerunMode (boolean rerun)

Opcionalmente, configure el modo de repetición.

void setResumeMode (boolean resume)

Opcionalmente, configure el modo de reanudación.

void setRunName (String runName)

Establezca el nombre de ejecución de prueba personalizado que se proporcionará al oyente

void setRunnerName (String runnerName)

Opcionalmente, configure el corredor de instrumentación de Android para usar.

void setShellTimeout (long timeout)

Opcionalmente, establezca el tiempo máximo (en milisegundos) esperando la salida del shell del dispositivo.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Opcionalmente, establezca la ruta a un archivo ubicado en el dispositivo que debe contener una lista de clases y métodos de prueba separados por línea (formato: método com.foo.Class #) que se ejecutará.

void setTestPackageName (String testPackageName)

Establece el filtro del paquete de prueba.

void setTestSize (String size)

Opcionalmente, configure el tamaño de prueba para ejecutar.

void setTestTimeout (long timeout)

Opcionalmente, establezca el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.

void setTestsToRun ( tests) setTestsToRun ( tests)

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

Métodos protegidos

String getClassName ()

Obtenga el nombre de la clase para ejecutar.

ListInstrumentationParser getListInstrumentationParser ()

Obtenga el ListInstrumentationParser utilizado para analizar las consultas 'pm list instrumentation'.

String getMethodName ()

Obtenga el método de prueba para ejecutar.

String getTestPackageName ()

Obtenga el paquete de prueba de Java para ejecutar.

String queryRunnerName ()

Consulte el dispositivo para que lo use un corredor de prueba.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Campos

mDebug

protected boolean mDebug

Constructores públicos

Prueba de instrumentación

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite agregar más oyentes personalizados al corredor

Parámetros
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Agregue un argumento para proporcionar al ejecutar las pruebas de instrumentación.

Parámetros
key String : el nombre del argumento

value String : el valor del argumento

getAbi

public IAbi getAbi ()

Devoluciones
IAbi

getCoverageTarget

public String getCoverageTarget ()

Obtenga el setCoverageTarget(String) cobertura establecido previamente mediante setCoverageTarget(String) .

Devoluciones
String

getDebug

public boolean getDebug ()

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

Devoluciones
boolean La configuración de depuración booleana.

getDevice

public ITestDevice getDevice ()

Obtenga el dispositivo bajo prueba.

Devoluciones
ITestDevice el ITestDevice

getForceAbi

public String getForceAbi ()

Devoluciones
String

getMaxTimeout

public long getMaxTimeout ()

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

Devoluciones
long

getPackageName

public String getPackageName ()

Obtenga el paquete de manifiesto de Android para ejecutar.

Devoluciones
String

getRunName

public String getRunName ()

Obtenga el nombre de ejecución de prueba personalizado que se proporcionará al oyente

Devoluciones
String

getRunnerName

public String getRunnerName ()

Obtiene el corredor de instrumentación de Android que se utilizará.

Devoluciones
String

isResumable

public boolean isResumable ()

Devoluciones
boolean

correr

public void run ( ITestInvocationListener listener)

Ejecuta las pruebas e informa el resultado al oyente.

Parámetros
listener ITestInvocationListener : el ITestInvocationListener de los resultados de la prueba

Arroja
DeviceNotAvailableException

setAbi

public void setAbi ( IAbi abi)

Parámetros
abi IAbi

setBugreportFrequency

public void setBugreportFrequency ( BugreportCollector.Freq freq)

Establezca la frecuencia con la que se recopilarán automáticamente informes de errores después de fallas en las pruebas.

Tenga en cuenta que no existe ningún mecanismo de retroalimentación entre el corredor de prueba y el recolector de informes de errores, por lo tanto, use la configuración CADA con la debida precaución: si se produce una gran cantidad de fallas en una sucesión rápida, el informe de errores para una de las fallas podría terminar siendo recopilado decenas de minutos u horas después de que ocurriera la falla respectiva.

Parámetros
freq BugreportCollector.Freq

setClassName

public void setClassName (String testClassName)

Opcionalmente, configure el nombre de la clase de prueba para ejecutar.

Parámetros
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o deshabilita el modo de recopilación de pruebas.

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Este método está en desuso.
Este método es un no-op

Establezca el tiempo máximo en ms para permitir el 'tiempo máximo de respuesta de salida de shell' al recopilar pruebas.

Parámetros
timeout int

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Establezca el objetivo de cobertura de esta prueba.

Actualmente sin usar. Este método solo está presente, por lo que la coberturaTarget se puede recuperar más tarde a través de getCoverageTarget()

Parámetros
coverageTarget String

setDebug

public void setDebug (boolean debug)

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

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

setDevice

public void setDevice ( ITestDevice device)

Inyecte el dispositivo bajo prueba.

Parámetros
device ITestDevice : el ITestDevice a utilizar

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Establezca True si aplicamos el formato de salida AJUR de instrumentación.

Parámetros
enforce boolean

setFallbackToSerialRerun

public void setFallbackToSerialRerun (boolean reRunSerially)

Establece la opción --fallback-to-serial-rerun.

Parámetros
reRunSerially boolean

setForceAbi

public void setForceAbi (String abi)

Establece la opción force-abi.

setInstallFile

public void setInstallFile (File installFile)

Establezca el archivo opcional para instalar que contiene las pruebas.

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

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

Parámetros
invocationContext IInvocationContext

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Establezca si usar o no el almacenamiento aislado.

Parámetros
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Opcionalmente, configure el método de prueba para que se ejecute.

Parámetros
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parámetros
collectors

setPackageName

public void setPackageName (String packageName)

Configure 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

setRebootBeforeReRun

public void setRebootBeforeReRun (boolean rebootBeforeReRun)

Establece la opción --reboot-before-rerun.

Parámetros
rebootBeforeReRun boolean

setRerunMode

public void setRerunMode (boolean rerun)

Opcionalmente, configure el modo de repetición.

Parámetros
rerun boolean

setResumeMode

public void setResumeMode (boolean resume)

Opcionalmente, configure el modo de reanudación.

Parámetros
resume boolean

setRunName

public void setRunName (String runName)

Establezca el nombre de ejecución de prueba personalizado que se proporcionará al oyente

Parámetros
runName String

setRunnerName

public void setRunnerName (String runnerName)

Opcionalmente, configure el corredor de instrumentación de Android para usar.

Parámetros
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Opcionalmente, establezca el tiempo máximo (en milisegundos) esperando la salida del shell del dispositivo.

Parámetros
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Opcionalmente, establezca la ruta a un archivo ubicado en el dispositivo que debe contener una lista de clases y métodos de prueba separados por línea (formato: método com.foo.Class #) que se ejecutará. Si está configurado, intentará automáticamente volver a ejecutar las pruebas usando este archivo de prueba a través de InstrumentationFileTest lugar de ejecutar comandos adb separados para cada prueba restante a través de InstrumentationSerialTest "

Parámetros
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Establece el filtro del paquete de prueba.

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

Se ignorará si se ha proporcionado un valor no nulo a setClassName(String)

Parámetros
testPackageName String

setTestSize

public void setTestSize (String size)

Opcionalmente, configure el tamaño de prueba para ejecutar.

Parámetros
size String

setTestTimeout

public void setTestTimeout (long timeout)

Opcionalmente, establezca el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.

Parámetros
timeout long

setTestsToRun

public void setTestsToRun ( tests)

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

Parámetros
tests : las pruebas para ejecutar

Métodos protegidos

getClassName

protected String getClassName ()

Obtenga el nombre de la clase para ejecutar.

Devoluciones
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenga el ListInstrumentationParser utilizado para analizar las consultas 'pm list instrumentation'.

Devoluciones
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Obtenga el método de prueba para ejecutar.

Devoluciones
String

getTestPackageName

protected String getTestPackageName ()

Obtenga el paquete de prueba de Java para ejecutar.

Devoluciones
String

queryRunnerName

protected String queryRunnerName ()

Consulte el dispositivo para que lo use un corredor de prueba.

Devoluciones
String el primer nombre de corredor de prueba que coincide con el paquete o nulo si no encontramos ninguno.

Arroja
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
runner IRemoteAndroidTestRunner