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.

Prueba de instrumentación

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

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

Subclases directas conocidas

AndroidJUnitTest y CodeCoverageTest

AndroidJUnitTest.	Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado a través del Se puede usar android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado. 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 coverTarget establecido anteriormente mediante `setCoverageTarget(String)`.
`boolean`	`getDebug()` Obtén la configuración de depuración de la instrumentación.
`ITestDevice`	`getDevice()` Pon el dispositivo a prueba.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Muestra 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 ejecución de prueba personalizado 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 manera 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 es una no-op
`void`	`setConfiguration(IConfiguration config)` Inserta 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 a prueba.
`void`	`setEnforceFormat(boolean enforce)` Establece el valor True si aplicamos el formato de salida AJUR de instrumentación.
`void`	`setForceAbi(String abi)` Establece la opción force-abi.
`void`	`setInstallFile(File installFile)` Configura el archivo opcional de instalación que contiene las pruebas.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Establece cuándo 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 elementos `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 que se ejecutará.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` Establece la opción --rerun-from-file.
`void`	`setRerunMode(boolean rerun)` De manera opcional, configura el modo de repetición.
`void`	`setRunName(String runName)` Establece el nombre de ejecución de prueba personalizado 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 como resultado del shell del dispositivo.
`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 líneas métodos y clases de prueba separados (formato: com.foo.Class#method) para ejecutar.
`void`	`setTestPackageName(String testPackageName)` Establece el filtro del paquete de prueba.
`void`	`setTestSize(String size)` De manera opcional, configura 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 InstrumentationTest.
`void`	`setWindowAnimation(boolean windowAnimation)`

Métodos protegidos
`static`	`excludeNonExecuted(TestRunResult results)` Filtrar por "NOT_EXECUTED" y se omite para hacer un seguimiento de lo que debe volver a ejecutarse.
`String`	`getClassName()` Obtén el nombre de la clase para ejecutar.
`ListInstrumentationParser`	`getListInstrumentationParser()` Obtén el `ListInstrumentationParser` que se usa para analizar "pm list instrumentation" para tus consultas.
`String`	`getMethodName()` Obtén el método de prueba para ejecutar.
`String`	`getTestPackageName()` Obtén el paquete de prueba de Java para ejecutarlo.
`String`	`queryRunnerName()` Consulta el dispositivo para obtener un ejecutor de pruebas que pueda usar.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Campos

EJECUTAR_PRUEBAS_AS_CLAVE_DE_USUARIO

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

Prueba de instrumentación

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`: Es 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 coverTarget establecido anteriormente mediante setCoverageTarget(String).

Muestra
`String`

getDebug

public boolean getDebug ()

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

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

getDevice

public ITestDevice getDevice ()

Pon el dispositivo a prueba.

Muestra
`ITestDevice`	`ITestDevice`

getForceAbi

public String getForceAbi ()

Muestra
`String`

getMaxTimeout

public long getMaxTimeout ()

Muestra 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 ejecución de prueba personalizado que se proporcionará al objeto de escucha

Muestra
`String`

nombregetRunner

public String getRunnerName ()

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

Muestra
`String`

Orquestador

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. y 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 manera opcional, establece el nombre de la clase de prueba que se ejecutará.

Parámetros
`testClassName`	`String`

Solo RecopilarTests

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 es no-op

Establece el tiempo máximo en milisegundos para permitir el “tiempo máximo de respuesta del resultado de shell” al recopilar y pruebas.

Parámetros
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Inserta 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, por lo que connectionTarget puede recuperarse luego 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 la instrumentación.

SetDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo a prueba.

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

setEnforceFormat

public void setEnforceFormat (boolean enforce)

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

Parámetros
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Establece la opción force-abi.

setInstallFile

public void setInstallFile (File installFile)

Configura el archivo opcional de instalación que contiene las pruebas.

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Establece cuándo 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 elementos 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 que se ejecutará.

Parámetros
`packageName`	`String`

setReRun conTestFile

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, configura el modo de repetición.

Parámetros
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Establece el nombre de ejecución de prueba personalizado 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 como resultado del shell del dispositivo.

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 líneas métodos y clases de prueba separados (formato: com.foo.Class#method) para ejecutar. Si se establece, intentan ejecutar automáticamente las pruebas con este archivo de prueba mediante InstrumentationFileTest, en lugar de ejecutar comandos adb separados para cada prueba restante. a través de una nueva ejecución.

Parámetros
`testFilePathOnDevice`	`String`

setTestPackageName

public void setTestPackageName (String testPackageName)

Establece el filtro del paquete de prueba.

Si el valor no es nulo, solo se ejecutarán las pruebas dentro del paquete de Java especificado.

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

Parámetros
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

De manera opcional, configura 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 InstrumentationTest.

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parámetros
`windowAnimation`	`boolean`

Métodos protegidos

excluirNo ejecutado

protected static  excludeNonExecuted (TestRunResult results)

Filtrar por "NOT_EXECUTED" y se omite para hacer un seguimiento de lo que debe volver a ejecutarse.

Parámetros
`results`	`TestRunResult`

Muestra

getClassName

protected String getClassName ()

Obtén el nombre de la clase para ejecutar.

Muestra
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtén el ListInstrumentationParser que se usa para analizar "pm list instrumentation" para tus consultas.

Muestra
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Obtén el método de prueba para ejecutar.

Muestra
`String`

getTestPackageName

protected String getTestPackageName ()

Obtén el paquete de prueba de Java para ejecutarlo.

Muestra
`String`

nombre del ejecutor de consultas

protected String queryRunnerName ()

Consulta el dispositivo para obtener un ejecutor de pruebas que pueda usar.

Muestra
`String`	el nombre del primer ejecutor de pruebas que coincida con el paquete o un valor nulo si no encontramos ninguno.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
`runner`	`IRemoteAndroidTestRunner`