A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

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

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

Subclases directas conocidas

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` que delegan la ejecución a otro archivo binario de Tradefed.
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.

Clase que describe todos los pasos de invocación: descarga de compilación, target_prep, ejecución de pruebas y limpieza. Se puede extender para anular el comportamiento predeterminado de algunos pasos. El orden de los pasos se basa en TestInvocation.

Resumen

Constantes
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

Constructores públicos
`InvocationExecution()`

Métodos públicos
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Ejecuta el paso de limpieza de build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Ejecuta el paso cleanUp de target_preparer y multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Ejecuta el paso de configuración de target_preparer y multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Ejecuta el paso de cierre de target_preparer y multi_target_preparer.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Ejecuta el paso build_provider de la invocación.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Registra algunos registros del dispositivo en diferentes etapas de la invocación.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Invoca `ITestDevice.postInvocationTearDown(Throwable)` para cada dispositivo que forme parte de la invocación.
`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 dispositivo que forme parte de la invocación.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Ejecuta la prueba.
`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 protegidos
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Recopila automáticamente cierta información sobre el dispositivo principal que se está probando.
`IShardHelper`	`createShardHelper()` Crea y devuelve el `IShardHelper` que se usará.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Permite personalizar algunos aspectos del dispositivo antes de preInvocationSetup.
`String`	`getAdbVersion()` Devuelve la versión de adb que se usa para la invocación.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Recupera una lista de preparadores de lab para ejecutar en este dispositivo.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Recupera una lista de preparadores de destino para ejecutar en este dispositivo.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Recopila los registros de $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Controla la configuración de la etiqueta de prueba en la información de compilación.

Constantes

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Valor de la constante: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Valor de la constante: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Valor de la constante: "java_version"

Constructores públicos

InvocationExecution

public InvocationExecution ()

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 listener)

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.
`listener`	`ITestLogger`: Es el objeto `ITestLogger` para informar los registros de fallas en la configuración.

Arroja
`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. Desmontaje de 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.

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
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                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.
`listener`	`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 dispositivo que forme parte 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 ejecución de la prueba, 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 dispositivo que forme parte 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
`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

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 creará configuraciones para cada fragmento estableciendo índices de fragmentos y los reprogramará. 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`.

Métodos protegidos

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Recopila automáticamente cierta información sobre el dispositivo principal que se está probando.

Parámetros
`config`	`IConfiguration`
`info`	`TestInformation`

Arroja
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Crea y devuelve el IShardHelper que se usará.

Muestra
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Permite personalizar algunos aspectos del dispositivo antes de preInvocationSetup.

Parámetros
`config`	`IConfiguration`: Es la configuración de la invocación.
`context`	`IInvocationContext`: Es el contexto de invocación actual.

getAdbVersion

protected String getAdbVersion ()

Devuelve la versión de adb que se usa para la invocación.

Muestra
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera una lista de preparadores de lab para ejecutar en este dispositivo.

Se anula en las clases de zona de pruebas para impedir que los preparadores de labs se ejecuten dentro del elemento secundario de la zona de pruebas.

Parámetros
`config`	`IConfiguration`
`deviceName`	`String`

Muestra

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera una lista de preparadores de destino para ejecutar en este dispositivo.

Se anula en las clases de zona de pruebas para impedir que los preparadores de labs se ejecuten dentro del elemento secundario de la zona de pruebas.

Parámetros
`config`	`IConfiguration`
`deviceName`	`String`

Muestra

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parámetros
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Recopila los registros de $TMPDIR/adb.$UID.log.

Parámetros
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Parámetros
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

Muestra
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Controla la configuración de la etiqueta de prueba en la información de compilación.

Parámetros
`info`	`IBuildInfo`
`config`	`IConfiguration`