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.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

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

Implementación genérica de un IInvocationContext.

Resumen

Constructores públicos
`InvocationContext()` Crea un `BuildInfo` con valores de atributos predeterminados.

Métodos públicos
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` Realiza un seguimiento de un mapa del nombre del dispositivo de configuración asociado a un `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Agrega un ITestDevice para que los metadatos lo hagan un seguimiento cuando se asigne el dispositivo.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Agrega un `IBuildInfo` para hacer un seguimiento con el nombre de configuración del dispositivo.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Agrega un atributo de invocación.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Agrega varios atributos de invocación a la vez a través de un `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` Agrega un número de serie para hacer un seguimiento de su asignación a uno de los fragmentos que ejecutan algunas pruebas.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Operación inversa a `InvocationContext.toProto()` para recuperar la instancia.
`MultiMap<String, String>`	`getAttributes()` Devuelve una copia del mapa que contiene todos los atributos de invocación.
`IBuildInfo`	`getBuildInfo(String deviceName)` Devuelve el `IBuildInfo` asociado con el nombre de configuración del dispositivo proporcionado.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Devuelve el `IBuildInfo` asociado con el `ITestDevice`.
`String`	`getBuildInfoName(IBuildInfo info)` Devuelve el nombre del conjunto de dispositivos en la configuración XML del `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` Devuelve todos los `IBuildInfo` registrados para esta invocación.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Devuelve el descriptor asociado con la configuración de prueba que inició la invocación.
`ITestDevice`	`getDevice(String deviceName)` Devuelve el `ITestDevice` asociado con el nombre de configuración del dispositivo proporcionado.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Devuelve el mapa de asociación de información de compilación y dispositivo
`ITestDevice`	`getDeviceBySerial(String serial)` Devuelve el `ITestDevice` asociado con el número de serie proporcionado.
`List<String>`	`getDeviceConfigNames()` Devuelve la lista de nombres de configuración del dispositivo que se rastreó en esta invocación.
`String`	`getDeviceName(ITestDevice device)` Devuelve el nombre del conjunto de dispositivos en la configuración XML del `ITestDevice`.
`List<ITestDevice>`	`getDevices()` Devuelve todos los dispositivos asignados que se rastrearon para esta invocación.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Devuelve el contexto de invocación del módulo mientras se ejecuta como parte de un conjunto.
`int`	`getNumDevicesAllocated()` Devuelve la cantidad de dispositivos asignados para la invocación.
`List<String>`	`getSerials()` Devuelve la lista de números de serie del dispositivo del que se hizo un seguimiento en esta invocación.
`Map<Integer, List<String>>`	`getShardsSerials()` Devuelve el mapa de todos los números de serie rastreados y su fragmento involucrado en la fragmentación.
`String`	`getTestTag()` Devuelve la etiqueta de prueba de la invocación.
`static boolean`	`isApiTrigger(IInvocationContext context)` Devuelve si detectamos la invocación de pruebas basadas en la API según el tipo de activador.
`static boolean`	`isOnDemand(IInvocationContext context)` Devuelve si detectamos la invocación de pruebas a pedido según el tipo de activador.
`static boolean`	`isPresubmit(IInvocationContext context)` Devuelve si detectamos la verificación previa al envío según el tipo de activador.
`void`	`lockAttributes()` Bloquea el contexto para evitar que se agreguen más atributos de invocación.
`void`	`logInvocationMetrics()` Registra los atributos `InvocationMetricLogger` en la invocación.
`void`	`markReleasedEarly()` Marca que los dispositivos se lanzarán de forma anticipada.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Establece el descriptor asociado con la configuración de prueba que inició la invocación.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Establece el contexto de invocación del módulo mientras se ejecuta como parte de un conjunto.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Establece el `RecoveryMode` de todos los dispositivos que forman parte del contexto.
`void`	`setTestTag(String testTag)` Establece la etiqueta de prueba de invocación.
`InvocationContext.Context`	`toProto()` Serializa la instancia de contexto en un búfer de protocolo.
`boolean`	`wasReleasedEarly()` Devuelve si los dispositivos se lanzaron de forma anticipada y ya no se usarán.

Constructores públicos

InvocationContext

public InvocationContext ()

Crea un BuildInfo con valores de atributos predeterminados.

Métodos públicos

addAllocatedDevice

public void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Realiza un seguimiento de un mapa del nombre del dispositivo de configuración asociado a un ITestDevice. No borra el seguimiento anterior antes de agregar el nuevo.

Parámetros
`deviceWithName`	`Map`: Es el `Map` del dispositivo adicional que se debe rastrear.

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

Agrega un ITestDevice para que los metadatos lo hagan un seguimiento cuando se asigne el dispositivo. establecerá la información de compilación como nula en el mapa.

Parámetros
`devicename`	`String`: Es el nombre de la configuración del dispositivo que se asociará con el `ITestDevice`.
`testDevice`	`ITestDevice`: Se agregará a los dispositivos asignados.

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Agrega un IBuildInfo para hacer un seguimiento con el nombre de configuración del dispositivo.

Parámetros
`deviceName`	`String`: Es el nombre de la configuración del dispositivo.
`buildinfo`	`IBuildInfo`: Es un `IBuildInfo` asociado al nombre de la configuración del dispositivo.

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

Agrega un atributo de invocación.

Parámetros
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

public void addInvocationAttributes (MultiMap<String, String> attributesMap)

Agrega varios atributos de invocación a la vez a través de un UniqueMultiMap.

Parámetros
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

Agrega un número de serie para hacer un seguimiento de su asignación a uno de los fragmentos que ejecutan algunas pruebas.

Parámetros
`index`	`Integer`: Es el índice de la partición que usa los números de serie.
`serials`	`List`: Es la lista de números de serie que se rastrearán.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Operación inversa a InvocationContext.toProto() para recuperar la instancia.

Parámetros
`protoContext`	`InvocationContext.Context`

Muestra
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

Devuelve una copia del mapa que contiene todos los atributos de invocación.

Muestra
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

Devuelve el IBuildInfo asociado con el nombre de configuración del dispositivo proporcionado. Devuelve nulo si no se puede encontrar una coincidencia para deviceName.

Parámetros
`deviceName`	`String`

Muestra
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

Devuelve el IBuildInfo asociado con el ITestDevice.

Parámetros
`testDevice`	`ITestDevice`

Muestra
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del IBuildInfo. Devuelve null si no se puede encontrar una coincidencia para IBuildInfo.

Parámetros
`info`	`IBuildInfo`

Muestra
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

Devuelve todos los IBuildInfo registrados para esta invocación.

Muestra
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

Devuelve el descriptor asociado con la configuración de prueba que inició la invocación.

Muestra
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

Devuelve el ITestDevice asociado con el nombre de configuración del dispositivo proporcionado.

Parámetros
`deviceName`	`String`

Muestra
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Devuelve el mapa de asociación de información de compilación y dispositivo

Muestra
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

Devuelve el ITestDevice asociado con el número de serie proporcionado. Evita usar demasiados, ya que no es la búsqueda más rápida.

Parámetros
`serial`	`String`

Muestra
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

Devuelve la lista de nombres de configuración del dispositivo que se rastreó en esta invocación.

Muestra
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

Devuelve el nombre del conjunto de dispositivos en la configuración XML del ITestDevice. Devuelve nulo si no se puede encontrar una coincidencia para ITestDevice.

Parámetros
`device`	`ITestDevice`

Muestra
`String`

getDevices

public List<ITestDevice> getDevices ()

Devuelve todos los dispositivos asignados que se rastrearon para esta invocación.

Muestra
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Muestra
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Devuelve el contexto de invocación del módulo mientras se ejecuta como parte de un conjunto.

Muestra
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Devuelve la cantidad de dispositivos asignados para la invocación.

Muestra
`int`

getSerials

public List<String> getSerials ()

Devuelve la lista de números de serie del dispositivo del que se hizo un seguimiento en esta invocación.

Muestra
`List<String>`

getShardsSerials

public Map<Integer, List<String>> getShardsSerials ()

Devuelve el mapa de todos los números de serie rastreados y su fragmento involucrado en la fragmentación. Estará vacío si no es una invocación fragmentada.

Muestra
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

Devuelve la etiqueta de prueba de la invocación.

Muestra
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Devuelve si detectamos la invocación de pruebas basadas en la API según el tipo de activador.

Parámetros
`context`	`IInvocationContext`

Muestra
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Devuelve si detectamos la invocación de pruebas a pedido según el tipo de activador.

Parámetros
`context`	`IInvocationContext`

Muestra
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Devuelve si detectamos la verificación previa al envío según el tipo de activador.

Parámetros
`context`	`IInvocationContext`

Muestra
`boolean`

lockAttributes

public void lockAttributes ()

Bloquea el contexto para evitar que se agreguen más atributos de invocación.

logInvocationMetrics

public void logInvocationMetrics ()

Registra los atributos InvocationMetricLogger en la invocación.

markReleasedEarly

public void markReleasedEarly ()

Marca que los dispositivos se lanzarán de forma anticipada.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Establece el descriptor asociado con la configuración de prueba que inició la invocación.

Parámetros
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Establece el contexto de invocación del módulo mientras se ejecuta como parte de un conjunto.

Parámetros
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Establece el RecoveryMode de todos los dispositivos que forman parte del contexto.

Parámetros
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Establece la etiqueta de prueba de invocación.

Parámetros
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serializa la instancia de contexto en un búfer de protocolo.

Muestra
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

Devuelve si los dispositivos se lanzaron de forma anticipada y ya no se usarán.

Muestra
`boolean`