Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no 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

Implementação genérica de um IInvocationContext.

Resumo

Construtores públicos
`InvocationContext()` Cria um `BuildInfo` usando valores de atributo padrão.

Métodos públicos
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` Rastreia um mapa do nome do dispositivo de configuração associado a um `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Adicione um ITestDevice para ser rastreado pelos metadados quando o dispositivo for alocado.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Adicione um `IBuildInfo` para ser rastreado com o nome da configuração do dispositivo.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Adicione um atributo de invocação.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Adicione vários atributos de invocação de uma só vez usando um `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` Adicione um número de série para ser rastreado como atribuído a um dos fragmentos que executam alguns testes.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Operação inversa de `InvocationContext.toProto()` para recuperar a instância.
`MultiMap<String, String>`	`getAttributes()` Retorna uma cópia do mapa que contém todos os atributos de invocação.
`IBuildInfo`	`getBuildInfo(String deviceName)` Retorna o `IBuildInfo` associado ao nome da configuração do dispositivo fornecido.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Retorna o `IBuildInfo` associado ao `ITestDevice`.
`String`	`getBuildInfoName(IBuildInfo info)` Retorna o nome do conjunto de dispositivos na configuração XML do `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` Retorna todos os `IBuildInfo` rastreados para essa invocação.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Retorna o descritor associado à configuração de teste que iniciou a invocação.
`ITestDevice`	`getDevice(String deviceName)` Retorna o `ITestDevice` associado ao nome da configuração do dispositivo fornecido.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Retorna o mapa da associação de informações do dispositivo/build.
`ITestDevice`	`getDeviceBySerial(String serial)` Retorna o `ITestDevice` associado ao número de série fornecido.
`List<String>`	`getDeviceConfigNames()` Retorna a lista de nomes de configuração do dispositivo rastreado nesta invocação.
`String`	`getDeviceName(ITestDevice device)` Retorna o nome do conjunto de dispositivos na configuração XML de `ITestDevice`.
`List<ITestDevice>`	`getDevices()` Retorna todos os dispositivos alocados rastreados para essa invocação.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Retorna o contexto de invocação do módulo enquanto ele é executado como parte de um pacote.
`int`	`getNumDevicesAllocated()` Retorna o número de dispositivos alocados para a invocação.
`List<String>`	`getSerials()` Retorna a lista de números de série do dispositivo rastreado nesta invocação.
`Map<Integer, List<String>>`	`getShardsSerials()` Retorna o mapa de todos os números de série rastreados e seus fragmentos envolvidos no fragmentação.
`String`	`getTestTag()` Retorna a tag de teste de invocação.
`static boolean`	`isApiTrigger(IInvocationContext context)` Retorna se detectamos a invocação de teste baseada em API com base no tipo de acionador.
`static boolean`	`isOnDemand(IInvocationContext context)` Retorna se detectamos a invocação de teste sob demanda com base no tipo de gatilho.
`static boolean`	`isPresubmit(IInvocationContext context)` Retorna se detectamos o pré-envio com base no tipo de acionador.
`void`	`lockAttributes()` Bloqueie o contexto para impedir que mais atributos de invocação sejam adicionados.
`void`	`logInvocationMetrics()` Registre os atributos `InvocationMetricLogger` na invocação.
`void`	`markReleasedEarly()` Marque que os dispositivos serão lançados antes.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Define o descritor associado à configuração de teste que iniciou a invocação.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Define o contexto de invocação do módulo ao ser executado como parte de um conjunto.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Define o `RecoveryMode` de todos os dispositivos que fazem parte do contexto.
`void`	`setTestTag(String testTag)` Define a tag de teste de invocação.
`InvocationContext.Context`	`toProto()` Serializa a instância de contexto em um protobuf.
`boolean`	`wasReleasedEarly()` Retorna se os dispositivos foram lançados antes do tempo e não serão mais usados.

Construtores públicos

InvocationContext

public InvocationContext ()

Cria um BuildInfo usando valores de atributo padrão.

Métodos públicos

addAllocatedDevice

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

Rastreia um mapa do nome do dispositivo de configuração associado a um ITestDevice. Não limpa o rastreamento anterior antes de adicionar.

Parâmetros
`deviceWithName`	`Map`: o `Map` de um dispositivo adicional a ser rastreado

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

Adicione um ITestDevice para ser rastreado pelos metadados quando o dispositivo for alocado. vai definir as informações de build como nulas no mapa.

Parâmetros
`devicename`	`String`: o nome da configuração do dispositivo a ser associado ao `ITestDevice`
`testDevice`	`ITestDevice`: a ser adicionado aos dispositivos alocados.

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Adicione um IBuildInfo para ser rastreado com o nome da configuração do dispositivo.

Parâmetros
`deviceName`	`String`: o nome da configuração do dispositivo
`buildinfo`	`IBuildInfo`: um `IBuildInfo` associado ao nome da configuração do dispositivo.

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

Adicione um atributo de invocação.

Parâmetros
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

Adicione vários atributos de invocação de uma só vez usando um UniqueMultiMap.

Parâmetros
`attributesMap`	`MultiMap`

addSerialsFromShard

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

Adicione um número de série para ser rastreado como atribuído a um dos fragmentos que executam alguns testes.

Parâmetros
`index`	`Integer`: o índice do fragmento usando os números de série
`serials`	`List`: a lista de números de série a serem rastreados.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Operação inversa de InvocationContext.toProto() para recuperar a instância.

Parâmetros
`protoContext`	`InvocationContext.Context`

Retorna
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

Retorna uma cópia do mapa que contém todos os atributos de invocação.

Retorna
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

Retorna o IBuildInfo associado ao nome da configuração do dispositivo fornecido. Retorna nulo se o deviceName não puder ser correspondido.

Parâmetros
`deviceName`	`String`

Retorna
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

Retorna o IBuildInfo associado ao ITestDevice.

Parâmetros
`testDevice`	`ITestDevice`

Retorna
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

Retorna o nome do conjunto de dispositivos na configuração XML do IBuildInfo. Retorna nulo se o IBuildInfo não puder ser correspondido

Parâmetros
`info`	`IBuildInfo`

Retorna
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

Retorna todos os IBuildInfo rastreados para essa invocação.

Retorna
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

Retorna o descritor associado à configuração de teste que iniciou a invocação.

Retorna
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

Retorna o ITestDevice associado ao nome da configuração do dispositivo fornecido.

Parâmetros
`deviceName`	`String`

Retorna
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Retorna o mapa da associação de informações do dispositivo/build.

Retorna
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

Retorna o ITestDevice associado ao número de série fornecido. Evite usar muito, porque não é a pesquisa mais rápida.

Parâmetros
`serial`	`String`

Retorna
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

Retorna a lista de nomes de configuração do dispositivo rastreado nesta invocação.

Retorna
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

Retorna o nome do conjunto de dispositivos na configuração XML de ITestDevice. Retorna nulo se ITestDevice não puder ser correspondido.

Parâmetros
`device`	`ITestDevice`

Retorna
`String`

getDevices

public List<ITestDevice> getDevices ()

Retorna todos os dispositivos alocados rastreados para essa invocação.

Retorna
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Retorna
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Retorna o contexto de invocação do módulo enquanto ele é executado como parte de um pacote.

Retorna
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Retorna o número de dispositivos alocados para a invocação.

Retorna
`int`

getSerials

public List<String> getSerials ()

Retorna a lista de números de série do dispositivo rastreado nesta invocação.

Retorna
`List<String>`

getShardsSerials

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

Retorna o mapa de todos os números de série rastreados e seus fragmentos envolvidos no fragmentação. Vazio se não for uma invocação fragmentada.

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

getTestTag

public String getTestTag ()

Retorna a tag de teste de invocação.

Retorna
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Retorna se detectamos a invocação de teste baseada em API com base no tipo de acionador.

Parâmetros
`context`	`IInvocationContext`

Retorna
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Retorna se detectamos a invocação de teste sob demanda com base no tipo de gatilho.

Parâmetros
`context`	`IInvocationContext`

Retorna
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Retorna se detectamos o pré-envio com base no tipo de acionador.

Parâmetros
`context`	`IInvocationContext`

Retorna
`boolean`

lockAttributes

public void lockAttributes ()

Bloqueie o contexto para impedir que mais atributos de invocação sejam adicionados.

logInvocationMetrics

public void logInvocationMetrics ()

Registre os atributos InvocationMetricLogger na invocação.

markReleasedEarly

public void markReleasedEarly ()

Marque que os dispositivos serão lançados antes.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Define o descritor associado à configuração de teste que iniciou a invocação.

Parâmetros
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Define o contexto de invocação do módulo ao ser executado como parte de um conjunto.

Parâmetros
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Define o RecoveryMode de todos os dispositivos que fazem parte do contexto.

Parâmetros
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Define a tag de teste de invocação.

Parâmetros
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serializa a instância de contexto em um protobuf.

Retorna
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

Retorna se os dispositivos foram lançados antes do tempo e não serão mais usados.

Retorna
`boolean`