Esta página se ha traducido con Cloud Translation API.

Prueba de instrumentación

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

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

Subclases directas conocidas

AndroidJUnitTest , prueba de cobertura de código

Android JUnitPrueba	Una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado mediante android.support.test.runner.AndroidJUnitRunner.
Prueba de cobertura de código	Una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado y genera el informe de cobertura del código.

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)` `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 `IConfiguration` para esta prueba.
`String`	`getCoverageTarget ()` Obtenga el objetivo de cobertura establecido previamente mediante `setCoverageTarget(String)` .
`boolean`	`getDebug ()` Obtenga la configuración de depuración de instrumentación.
`ITestDevice`	`getDevice ()` Ponga a prueba el dispositivo.
`String`	`getForceAbi ()`
`long`	`getMaxTimeout ()` Devuelve el tiempo de espera máximo establecido para la instrumentación.
`String`	`getPackageName ()` Haga que se ejecute el paquete de manifiesto de Android.
`String`	`getRunName ()` Obtenga el nombre de la ejecución de prueba personalizada que se proporcionará al oyente
`String`	`getRunnerName ()` Obtiene el ejecutor de instrumentación de Android que se utilizará.
`boolean`	`isOrchestrator ()` Devuelve el valor de `ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)`
`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 `IConfiguration` en uso.
`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 de instrumentación AJUR.
`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 `IMetricCollector` definidos para la ejecución de prueba.
`void`	`setOrchestrator (boolean useOrchestrator)` Establece la opción --orchestrator
`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, configure el modo de repetición.
`void`	`setRunName (String runName)` Establezca el nombre de la ejecución de prueba personalizada que se proporcionará al oyente
`void`	`setRunnerName (String runnerName)` Opcionalmente, configure el ejecutor de instrumentación de Android para su uso.
`void`	`setShellTimeout (long timeout)` Opcionalmente, establezca el tiempo máximo (en milisegundos) que espera la salida del shell desde el 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) que se ejecutarán.
`void`	`setTestPackageName (String testPackageName)` Establece el filtro del paquete de prueba.
`void`	`setTestSize (String size)` Opcionalmente, establezca el tamaño de la 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 debe volver a ejecutarse.
`String`	`getClassName ()` Obtenga el nombre de la clase para ejecutar.
`ListInstrumentationParser`	`getListInstrumentationParser ()` Obtenga el `ListInstrumentationParser` utilizado para analizar consultas de 'instrumentación de lista pm'.
`String`	`getMethodName ()` Haga que se ejecute el método de prueba.
`String`	`getTestPackageName ()` Haga que se ejecute el paquete java de prueba.
`String`	`queryRunnerName ()` Consulta el dispositivo para que lo utilice 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

mDepurar

protected boolean mDebug

mInstrumentoSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentoSdkSandbox

protected boolean mInstrumentSdkSandbox

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`

agregarInstrumentaciónArg

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

obtenerAbi

public IAbi getAbi ()

Devoluciones
`IAbi`

obtener configuración

public IConfiguration getConfiguration ()

Obtiene la IConfiguration para esta prueba.

Devoluciones
`IConfiguration`

obtenerObjetivo de cobertura

public String getCoverageTarget ()

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

Devoluciones
`String`

obtenerDepuración

public boolean getDebug ()

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

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

obtener dispositivo

public ITestDevice getDevice ()

Ponga a prueba el dispositivo.

Devoluciones
`ITestDevice`	el `ITestDevice`

obtenerForceAbi

public String getForceAbi ()

Devoluciones
`String`

getMaxTimeout

public long getMaxTimeout ()

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

Devoluciones
`long`

obtener nombre del paquete

public String getPackageName ()

Haga que se ejecute el paquete de manifiesto de Android.

Devoluciones
`String`

getRunName

public String getRunName ()

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

Devoluciones
`String`

getRunnerName

public String getRunnerName ()

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

Devoluciones
`String`

es orquestador

public boolean isOrchestrator ()

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

Devoluciones
`boolean`

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`

conjuntoAbi

public void setAbi (IAbi abi)

Parámetros
`abi`	`IAbi`

establecer nombre de clase

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 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`

establecer configuración

public void setConfiguration (IConfiguration config)

Inyecta la IConfiguration en uso.

Parámetros
`config`	`IConfiguration`

establecerobjetivo de cobertura

public void setCoverageTarget (String coverageTarget)

Establezca el objetivo de cobertura de esta prueba.

Actualmente sin uso. Este método simplemente está presente para que coverTarget se pueda recuperar más tarde a través de getCoverageTarget()

Parámetros
`coverageTarget`	`String`

establecerDepuración

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

setEnforceFormat

public void setEnforceFormat (boolean enforce)

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

Parámetros
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Establece la opción force-abi.

establecerinstalararchivo

public void setInstallFile (File installFile)

Configure el archivo opcional para instalar que contiene las pruebas.

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

establecerAlmacenamientoAislado

public void setIsolatedStorage (boolean isolatedStorage)

Establezca si desea utilizar o no el almacenamiento aislado.

Parámetros
`isolatedStorage`	`boolean`

establecer nombre de método

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 prueba.

Parámetros
`collectors`

setOrquestador

public void setOrchestrator (boolean useOrchestrator)

Establece la opción --orchestrator

Parámetros
`useOrchestrator`	`boolean`

establecer nombre del paquete

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`

establecer modo de repetición

public void setRerunMode (boolean rerun)

Opcionalmente, configure el modo de repetición.

Parámetros
`rerun`	`boolean`

establecer nombre de ejecución

public void setRunName (String runName)

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

Parámetros
`runName`	`String`

establecer nombre del corredor

public void setRunnerName (String runnerName)

Opcionalmente, configure el ejecutor de instrumentación de Android para su uso.

Parámetros
`runnerName`	`String`

establecerShellTimeout

public void setShellTimeout (long timeout)

Opcionalmente, establezca el tiempo máximo (en milisegundos) que espera la salida del shell desde el 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) que se ejecutarán. Si está configurado, intentará volver a ejecutar automáticamente las pruebas usando este archivo de prueba a través de InstrumentationFileTest en lugar de ejecutar comandos adb separados para cada prueba restante mediante la repetición.

Parámetros
`testFilePathOnDevice`	`String`

establecer nombre del paquete de prueba

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ño de prueba

public void setTestSize (String size)

Opcionalmente, establezca el tamaño de la 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`	: las pruebas a ejecutar

establecerVentanaAnimación

public void setWindowAnimation (boolean windowAnimation)

Parámetros
`windowAnimation`	`boolean`

Métodos protegidos

excluirNo ejecutado

protected static  excludeNonExecuted (TestRunResult results)

Filtre "NOT_EXECUTED" con el fin de realizar un seguimiento de lo que debe volver a ejecutarse.

Parámetros
`results`	`TestRunResult`

Devoluciones

getClassName

protected String getClassName ()

Obtenga el nombre de la clase para ejecutar.

Devoluciones
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenga el ListInstrumentationParser utilizado para analizar consultas de 'instrumentación de lista pm'.

Devoluciones
`ListInstrumentationParser`

obtener nombre del método

protected String getMethodName ()

Haga que se ejecute el método de prueba.

Devoluciones
`String`

obtener nombre del paquete de prueba

protected String getTestPackageName ()

Haga que se ejecute el paquete java de prueba.

Devoluciones
`String`

queryRunnerName

protected String queryRunnerName ()

Consulta el dispositivo para que lo utilice un ejecutor de pruebas.

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`