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.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Subcategorías indirectas conocidas

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` que delegan la ejecución a otro archivo binario de Tradefed.
InvocationExecution	Clase que describe todos los pasos de invocación: descarga de compilación, preparación del destino, ejecución de pruebas y limpieza.
ParentSandboxInvocationExecution	Es la versión de `InvocationExecution` para las acciones especiales de invocación principal cuando se ejecuta un entorno de pruebas.
RemoteInvocationExecution	Implementación de `InvocationExecution` que controla una ejecución remota.
SandboxedInvocationExecution	Ejecución especial de la zona de pruebas de la invocación: Es el InvocationExecution para cuando estamos dentro de la zona de pruebas ejecutando el comando.

Es una interfaz que describe las acciones que se realizarán como parte de una invocación. La invocación TestInvocation en sí garantiza el orden de las llamadas.

Resumen

Métodos públicos
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Ejecuta el paso de limpieza de build_provider.
`default void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Ejecuta el paso cleanUp de target_preparer y multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Ejecuta el paso de configuración de target_preparer y multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Ejecuta el paso de cierre de target_preparer y multi_target_preparer.
`default boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Ejecuta el paso build_provider de la invocación.
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` Registra algunos registros del dispositivo en diferentes etapas de la invocación.
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Invoca `ITestDevice.postInvocationTearDown(Throwable)` para cada parte del dispositivo de la invocación.
`default void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Invoca `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` para cada parte del dispositivo de la invocación.
`default void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Ejecuta la prueba.
`default boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Intenta fragmentar la configuración en subconfiguraciones para que se vuelvan a programar y se ejecuten en varios recursos de forma paralela.

Métodos públicos

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Ejecuta el paso de limpieza de build_provider. Se asocia con la recuperación de la compilación.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Ejecuta el paso cleanUp de target_preparer y multi_target_preparer. Limpia los dispositivos.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`exception`	`Throwable`: Es la excepción original que se arroja durante la ejecución de la prueba.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

Ejecuta el paso de configuración de target_preparer y multi_target_preparer. Realiza toda la configuración de los dispositivos necesaria para ejecutar la prueba.

Parámetros
`testInfo`	`TestInformation`: Es el `TestInformation` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`logger`	`ITestLogger`: Es el objeto `ITestLogger` para informar los registros de fallas en la configuración.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.targetprep.TargetSetupError
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Ejecuta el paso de cierre de target_preparer y multi_target_preparer. Desmonta los dispositivos asociados con la configuración.

Parámetros
`testInfo`	`TestInformation`: Es el `TestInformation` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`logger`	`ITestLogger`: Es el objeto `ITestLogger` para informar registros.
`exception`	`Throwable`: Es la excepción original que se arroja durante la ejecución de la prueba.

Arroja
	java.lang.Throwable
`Throwable`

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Ejecuta el paso build_provider de la invocación.

Parámetros
`testInfo`	`TestInformation`: Es el `TestInformation` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`rescheduler`	`IRescheduler`: Es el `IRescheduler` para reprogramar partes de la invocación para su ejecución en otros recursos.
`listener`	`ITestInvocationListener`: Es el `ITestInvocation` para informar fallas en la descarga de compilaciones.

Muestra
`boolean`	Es verdadero si descargamos correctamente la compilación y falso en caso contrario.

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

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

Registra algunos registros del dispositivo en diferentes etapas de la invocación. Por ejemplo, logcat.

Parámetros
`device`	`ITestDevice`: Es el dispositivo desde el que se informan los registros.
`logger`	`ITestLogger`: Es el registrador de los registros.
`stage`	`TestInvocation.Stage`: Es la etapa de la invocación en la que nos encontramos.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Invoca ITestDevice.postInvocationTearDown(Throwable) para cada parte del dispositivo de la invocación.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`exception`	`Throwable`: Es la excepción original que generó la prueba en ejecución, si hubo alguna.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Invoca ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) para cada parte del dispositivo de la invocación.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`logger`	`ITestLogger`: Es el objeto `ITestLogger` para informar registros.

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

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Ejecuta la prueba.

Parámetros
`info`	`TestInformation`: Es el `TestInformation` con el que se ejecutarán las pruebas.
`config`	`IConfiguration`: Es el `IConfiguration` que se ejecutará.
`listener`	`ITestInvocationListener`: El `ITestInvocationListener` de los resultados de la prueba

Arroja
	java.lang.Throwable
`Throwable`

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Intenta fragmentar la configuración en subconfiguraciones para que se vuelvan a programar y se ejecuten en varios recursos de forma paralela.

Si el recuento de fragmentos es mayor que 1, simplemente se crearán configuraciones para cada fragmento estableciendo índices de fragmentos y se volverán a programar. Si no se establece un recuento de fragmentos,se recurrirá a IShardHelper.shardConfig.

Parámetros
`config`	`IConfiguration`: Es el `IConfiguration` actual.
`testInfo`	`TestInformation`: Es el `TestInformation` que contiene la información de las pruebas.
`rescheduler`	`IRescheduler`: Es el `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` que se usa para registrar el archivo durante la fragmentación.

Muestra
`boolean`	Es verdadero si la prueba se fragmentó. De lo contrario, devuelve `false`.