Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Se usó la API de Cloud Translation para traducir esta página.

InstrumentationTest

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

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

Subclases directas conocidas

AndroidJUnitTest, CodeCoverageTest

AndroidJUnitTest	Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado con android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado y genera el informe de cobertura de código.

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`

isOrchestrator

public boolean isOrchestrator ()

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

Muestra
`boolean`

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`