Prueba de instrumentación
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.Objeto | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
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
|
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 () |
IConfiguration | getConfiguration () Obtiene la |
String | getCoverageTarget () Obtenga el objetivo de cobertura establecido previamente a través de |
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 ejecutor de instrumentación de Android que se utilizará. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) Ejecuta las pruebas e informa el resultado al oyente. |
void | setAbi ( IAbi abi) |
void | setClassName (String testClassName) Opcionalmente, configure el nombre de la clase de prueba para que se ejecute. |
void | setCollectTestsOnly (boolean shouldCollectTest) Habilita o deshabilita el modo de recopilación de pruebas |
void | setCollectsTestsShellTimeout (int timeout) Este método está en desuso. Este método no es operativo. |
void | setConfiguration ( IConfiguration config) Inyecta la |
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 la instrumentación. |
void | setForceAbi (String abi) Establece la opción force-abi. |
void | setInstallFile (File installFile) Configure el archivo opcional para instalar que contiene las pruebas. |
void | setIsolatedStorage (boolean isolatedStorage) Establezca si desea utilizar 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 |
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 | setRerunMode (boolean rerun) Opcionalmente, establezca el modo de repetició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 ejecutor de instrumentación de Android para usar. |
void | setShellTimeout (long timeout) Opcionalmente, establezca el tiempo máximo (en milisegundos) que espera la salida de 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íneas (formato: com.foo.Class#method) para 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. |
void | setWindowAnimation (boolean windowAnimation) |
Métodos protegidos | |
---|---|
static | excludeNonExecuted ( TestRunResult results) Filtre "NOT_EXECUTED" con el fin de realizar un seguimiento de lo que se debe volver a ejecutar. |
String | getClassName () Obtener el nombre de la clase para ejecutar. |
ListInstrumentationParser | getListInstrumentationParser () Obtenga el |
String | getMethodName () Obtener el método de prueba para ejecutar. |
String | getTestPackageName () Obtenga el paquete java de prueba para ejecutar. |
String | queryRunnerName () Consulta el dispositivo para que lo use un corredor de prueba. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
Campos
EJECUTAR_TESTS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
EJECUTAR_PRUEBAS_EN_SDK_SANDBOX
public static final String RUN_TESTS_ON_SDK_SANDBOX
mDebug
protected boolean mDebug
Constructores públicos
Prueba de instrumentación
public InstrumentationTest ()
Métodos públicos
agregarDeviceListeners
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 |
getConfiguration
public IConfiguration getConfiguration ()
Obtiene la IConfiguration
para esta prueba.
Devoluciones | |
---|---|
IConfiguration |
obtener objetivo de cobertura
public String getCoverageTarget ()
Obtenga el objetivo de cobertura establecido previamente a través de 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. |
obtenerDispositivo
public ITestDevice getDevice ()
Obtenga el dispositivo bajo prueba.
Devoluciones | |
---|---|
ITestDevice | el ITestDevice |
getForceAbi
public String getForceAbi ()
Devoluciones | |
---|---|
String |
obtenerMaxTimeout
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 ejecutor de instrumentación de Android que se utilizará.
Devoluciones | |
---|---|
String |
correr
public void run (TestInformation testInfo, ITestInvocationListener listener)
Ejecuta las pruebas e informa el resultado al oyente.
Parámetros | |
---|---|
testInfo | TestInformation : el objeto TestInformation que contiene información útil para ejecutar pruebas. |
listener | ITestInvocationListener : el ITestInvocationListener de los resultados de la prueba |
Lanza | |
---|---|
DeviceNotAvailableException |
establecerNombreClase
public void setClassName (String testClassName)
Opcionalmente, configure el nombre de la clase de prueba para que se ejecute.
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 no es operativo.
Establezca el tiempo máximo en ms para permitir el 'tiempo máximo para la respuesta de salida del shell' al recopilar pruebas.
Parámetros | |
---|---|
timeout | int |
setConfiguration
public void setConfiguration (IConfiguration config)
Inyecta la IConfiguration
en uso.
Parámetros | |
---|---|
config | IConfiguration |
establecer objetivo de cobertura
public void setCoverageTarget (String coverageTarget)
Establezca el objetivo de cobertura de esta prueba.
Actualmente sin uso. Este método solo está presente para que el objetivo de cobertura se pueda recuperar más tarde a través de getCoverageTarget()
Parámetros | |
---|---|
coverageTarget | String |
establecerDepurar
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. |
establecer dispositivo
public void setDevice (ITestDevice device)
Inyecte el dispositivo bajo prueba.
Parámetros | |
---|---|
device | ITestDevice : el ITestDevice a utilizar |
establecerFormato de aplicación
public void setEnforceFormat (boolean enforce)
Establezca True 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.
establecer archivo de instalación
public void setInstallFile (File installFile)
Configure el archivo opcional para instalar que contiene las pruebas.
Parámetros | |
---|---|
installFile | File : el ERROR(/File) |
conjuntoAlmacenamiento aislado
public void setIsolatedStorage (boolean isolatedStorage)
Establezca si desea utilizar 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
definidos para la ejecución de la prueba.
Parámetros | |
---|---|
collectors |
establecerNombrePaquete
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 |
establecerRerunMode
public void setRerunMode (boolean rerun)
Opcionalmente, establezca el modo de repetición.
Parámetros | |
---|---|
rerun | boolean |
establecerNombreEjecutar
public void setRunName (String runName)
Establezca el nombre de ejecución de prueba personalizado que se proporcionará al oyente
Parámetros | |
---|---|
runName | String |
establecerNombreCorredor
public void setRunnerName (String runnerName)
Opcionalmente, configure el ejecutor de instrumentación de Android para usar.
Parámetros | |
---|---|
runnerName | String |
establecerShellTimeout
public void setShellTimeout (long timeout)
Opcionalmente, establezca el tiempo máximo (en milisegundos) que espera la salida de shell del dispositivo.
Parámetros | |
---|---|
timeout | long |
establecerTestFilePathOnDevice
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íneas (formato: com.foo.Class#method) para ejecutar. Si se configura, automáticamente intentará volver a ejecutar las pruebas usando este archivo de prueba a través de InstrumentationFileTest
en lugar de ejecutar comandos adb separados para cada prueba restante a través de la repetición.
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 |
establecerTamañoPrueba
public void setTestSize (String size)
Opcionalmente, configure el tamaño de prueba para ejecutar.
Parámetros | |
---|---|
size | String |
establecerTestTimeout
public void setTestTimeout (long timeout)
Opcionalmente, establezca el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.
Parámetros | |
---|---|
timeout | long |
establecer pruebas para ejecutar
public void setTestsToRun (tests)
Establezca la colección de pruebas que debe ejecutar este InstrumentationTest.
Parámetros | |
---|---|
tests |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Parámetros | |
---|---|
windowAnimation | boolean |
Métodos protegidos
excluirNonEjecutado
protected staticexcludeNonExecuted (TestRunResult results)
Filtre "NOT_EXECUTED" con el fin de realizar un seguimiento de lo que se debe volver a ejecutar.
Parámetros | |
---|---|
results | TestRunResult |
Devoluciones | |
---|---|
getClassName
protected String getClassName ()
Obtener el nombre de la clase para ejecutar.
Devoluciones | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Obtenga el ListInstrumentationParser
utilizado para analizar las consultas de "instrumentación de la lista pm".
Devoluciones | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
Obtener el método de prueba para ejecutar.
Devoluciones | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
Obtenga el paquete java de prueba para ejecutar.
Devoluciones | |
---|---|
String |
queryRunnerName
protected String queryRunnerName ()
Consulta el dispositivo para que lo use un corredor de prueba.
Devoluciones | |
---|---|
String | el nombre del primer corredor de prueba que coincide con el paquete o nulo si no encontramos ninguno. |
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parámetros | |
---|---|
runner | IRemoteAndroidTestRunner |