A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

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 pruebas de instrumentación en un dispositivo determinado con android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	Es una prueba que ejecuta un paquete de pruebas de instrumentación en un dispositivo determinado y genera el informe de cobertura de código.

Es una prueba que ejecuta un paquete de pruebas de instrumentación en un dispositivo determinado.

Resumen

Constantes
`String`	`RUN_TESTS_AS_USER_KEY`
`String`	`RUN_TESTS_ON_SDK_SANDBOX`

Campos
`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 se ejecuten las pruebas de instrumentación.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Obtiene el `IConfiguration` para esta prueba.
`String`	`getCoverageTarget()` Obtiene el coverageTarget establecido anteriormente a través de `setCoverageTarget(String)`.
`boolean`	`getDebug()` Obtiene el parámetro de configuración de depuración de la instrumentación.
`ITestDevice`	`getDevice()` Obtén el dispositivo que se probará.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Devuelve el tiempo de espera máximo establecido para la instrumentación.
`String`	`getPackageName()` Obtén el paquete del 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()` Devuelve el valor de `ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)`.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Ejecuta las pruebas y le informa el resultado 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 no realiza ninguna operación.
`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 el parámetro de configuración de depuración de la instrumentación.
`void`	`setDevice(ITestDevice device)` Inserta el dispositivo en prueba.
`void`	`setEnforceFormat(boolean enforce)` Se establece como verdadero si aplicamos el formato de salida de AJUR de la instrumentación.
`void`	`setForceAbi(String abi)` Establece la opción force-abi.
`void`	`setInstallFile(File installFile)` Establece el archivo opcional para instalar que contiene las pruebas.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Establece si se debe usar 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 la prueba.
`void`	`setOrchestrator(boolean useOrchestrator)` Establece la opción --orchestrator
`void`	`setPackageName(String packageName)` Establece el paquete del manifiesto de Android que se ejecutará.
`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 genere resultados de 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 del paquete de prueba.
`void`	`setTestSize(String size)` De manera 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 los estados "NOT_EXECUTED" y "Skipped" 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 búsquedas de "instrumentación de la lista de pm".
`String`	`getMethodName()` Obtiene el método de prueba que se ejecutará.
`String`	`getTestPackageName()` Obtén el paquete Java de prueba para ejecutarlo.
`String`	`queryRunnerName()` Consulta el dispositivo para obtener un ejecutor de pruebas que se pueda usar.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Constantes

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Valor constante: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Valor de la constante: "RUN_TESTS_ON_SDK_SANDBOX"

Campos

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 se ejecuten 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 ()

Obtiene el coverageTarget establecido anteriormente a través de setCoverageTarget(String).

Muestra
`String`

getDebug

public boolean getDebug ()

Obtiene el parámetro de configuración de depuración de la instrumentación.

Muestra
`boolean`	Es el parámetro de configuración de depuración booleano.

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo que se probará.

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 del 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 ()

Devuelve 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 le informa el resultado 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 manera 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 operación.

Establece el tiempo máximo en ms para permitir la "respuesta de tiempo máximo para generar la salida de shell" cuando se recopilan 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 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 el parámetro de configuración de depuración de la instrumentación.

Parámetros
`debug`	`boolean`: Es el valor booleano que se establecerá en el parámetro de configuración de depuración de la instrumentación.

setDevice

public void setDevice (ITestDevice device)

Inserta el dispositivo en prueba.

Parámetros
`device`	`ITestDevice`: El `ITestDevice` que se usará

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Se establece como verdadero si aplicamos el formato de salida de 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 para instalar que contiene las pruebas.

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Establece si se debe usar 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 la 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)

Establece el paquete del manifiesto de Android que se ejecutará.

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 la salida de la 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 clases y métodos de prueba separados por líneas (formato: com.foo.Class#method) que se ejecutarán. Si se configura, se intentará volver a ejecutar automáticamente las pruebas con 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 nueva ejecució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 determinado.

Se ignorará si se proporcionó un valor no nulo para setClassName(String).

Parámetros
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

De manera 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 los estados "NOT_EXECUTED" y "Skipped" 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 búsquedas de "instrumentación de la lista de pm".

Muestra
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Obtiene el método de prueba que se ejecutará.

Muestra
`String`

getTestPackageName

protected String getTestPackageName ()

Obtén el paquete Java de prueba para ejecutarlo.

Muestra
`String`

queryRunnerName

protected String queryRunnerName ()

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

Muestra
`String`	El primer nombre del ejecutor de pruebas que coincide con el paquete o es nulo si no encontramos ninguno.

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
`runner`	`IRemoteAndroidTestRunner`