A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. 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 el AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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`	`mInstrumentInPcc`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Constructores públicos
`InstrumentationTest()`

Métodos públicos
`void`	`addDeviceListeners(Set<String> 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 que se configuró 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`	`isCollectTestsOnly()`
`boolean`	`isOrchestrator()` Devuelve el valor de `ERROR(InstrumentationTest.mOrchestrator/#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 es una operación nula.
`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(List<IMetricCollector> 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`	`setRetryAttemptNumber(int attemptNumber)` Establece el número de intento de reintento para la prueba. Establece el número de intento de reintento enviándolo como un argumento de instrumentación "retry_attempt" al ejecutor del dispositivo.
`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 un resultado 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, puedes establecer 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(Collection<TestDescription> tests)` Establece la colección de pruebas que debe ejecutar este InstrumentationTest.
`void`	`setWindowAnimation(boolean windowAnimation)`

Métodos protegidos
`static Set<TestDescription>`	`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 "pm list instrumentation".
`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

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Constructores públicos

InstrumentationTest

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

Permite agregar más objetos de escucha personalizados al ejecutor

Parámetros
`extraListeners`	`Set`

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`: 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 que se configuró 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`	`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`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Muestra
`boolean`	Indica si esta prueba está en modo de recopilación de pruebas únicamente.

isOrchestrator

public boolean isOrchestrator ()

Devuelve el valor de ERROR(InstrumentationTest.mOrchestrator/#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 el "tiempo máximo para la respuesta de salida del 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`: Es 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 `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 (List<IMetricCollector> collectors)

Establece la lista de IMetricCollector definidos para la ejecución de la prueba.

Parámetros
`collectors`	`List`

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`

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

Establece el número de intento de reintento para la prueba. El valor predeterminado no hace nada.

Establece el número de intento de reintento enviándolo como un argumento de instrumentación "retry_attempt" al ejecutor del dispositivo.

Parámetros
`attemptNumber`	`int`

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 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, puedes establecer 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 (Collection<TestDescription> tests)

Establece la colección de pruebas que debe ejecutar este InstrumentationTest.

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parámetros
`windowAnimation`	`boolean`

Métodos protegidos

excludeNonExecuted

protected static Set<TestDescription> 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
`Set<TestDescription>`

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 "pm list instrumentation".

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 null si no encontramos ninguno.

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
`runner`	`IRemoteAndroidTestRunner`