A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Subclasses indiretas conhecidas

InvocaçãoContexto

InvocaçãoContexto Implementação genérica de um IInvocationContext .

Contém informações sobre a invocação para os testes acessarem, se necessário. Os testes não devem modificar o contexto contido aqui, portanto apenas getters estarão disponíveis, exceto os atributos de contexto para fins de relatório.

Resumo

Constantes
`String`	`INVOCATION_ID` Chave usada para armazenar o ID de invocação associado.

Métodos públicos
`abstract void`	`addAllocatedDevice ( deviceWithName)` `addAllocatedDevice ( deviceWithName)` Rastreie um mapa do nome do dispositivo de configuração associado a um `ITestDevice` .
`abstract void`	`addAllocatedDevice (String deviceName, ITestDevice testDevice)` Adicione um ITestDevice para ser rastreado pelos metadados quando o dispositivo for alocado.
`abstract void`	`addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)` Adicione um `IBuildInfo` a ser rastreado com o nome de configuração do dispositivo.
`abstract void`	`addInvocationAttribute (String attributeName, String attributeValue)` Adicione um atributo de invocação.
`abstract void`	`addInvocationAttributes ( MultiMap <String, String> attributesMap)` Adicione vários atributos de invocação de uma vez por meio de `UniqueMultiMap` .
`default void`	`addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis)` Adicione uma métrica de tempo de invocação.
`abstract void`	`addSerialsFromShard (Integer index, serials)` `addSerialsFromShard (Integer index, serials)` Adicione uma série a ser rastreada conforme atribuída a um dos fragmentos que executa alguns testes.
`default String`	`getAttribute (String key)` Um método conveniente para recuperar atributos de contexto de invocação como um único par de valores-chave.
`abstract MultiMap <String, String>`	`getAttributes ()` Retorna uma cópia do mapa contendo todos os atributos de invocação.
`abstract IBuildInfo`	`getBuildInfo (String deviceName)` Retorne o `IBuildInfo` associado ao nome de configuração do dispositivo fornecido.
`abstract IBuildInfo`	`getBuildInfo ( ITestDevice testDevice)` Retorne o `IBuildInfo` associado ao `ITestDevice`
`abstract String`	`getBuildInfoName ( IBuildInfo info)` Retorna o nome do dispositivo definido na configuração xml do `IBuildInfo` .
`abstract`	`getBuildInfos ()` Retorne todos os `IBuildInfo` rastreados para esta invocação.
`abstract ConfigurationDescriptor`	`getConfigurationDescriptor ()` Retorna o descritor associado à configuração de teste que iniciou a invocação
`abstract ITestDevice`	`getDevice (String deviceName)` Retorne o `ITestDevice` associado ao nome de configuração do dispositivo fornecido.
`abstract`	`getDeviceBuildMap ()` Retornar o mapa da associação de informações do dispositivo/construção
`abstract ITestDevice`	`getDeviceBySerial (String serial)` Retorna o `ITestDevice` associado ao serial fornecido.
`abstract`	`getDeviceConfigNames ()` Retornar a lista de nomes de configuração do dispositivo rastreado nesta invocação
`abstract String`	`getDeviceName ( ITestDevice device)` Retorna o nome do dispositivo definido na configuração xml do `ITestDevice` .
`abstract`	`getDevices ()` Retorne todos os dispositivos alocados rastreados para esta invocação.
`abstract String`	`getInvocationId ()`
`default`	`getInvocationTimingMetrics ()` Retorna o mapa que contém as métricas de tempo de invocação.
`abstract IInvocationContext`	`getModuleInvocationContext ()` Retorna o contexto de invocação do módulo enquanto é executado como parte de um conjunto.
`abstract int`	`getNumDevicesAllocated ()` Retorne o número de dispositivos alocados para a invocação.
`abstract`	`getSerials ()` Retorne a lista de números de série do dispositivo rastreado nesta invocação
`abstract`	`getShardsSerials ()` Retorna o mapa de todas as séries rastreadas e seus fragmentos envolvidos na fragmentação.
`abstract String`	`getTestTag ()` Retorna a tag de teste de invocação.
`abstract void`	`markReleasedEarly ()` Marque que os dispositivos serão lançados mais cedo.
`abstract void`	`setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)` Define o descritor associado à configuração de teste que iniciou a invocação
`abstract void`	`setModuleInvocationContext ( IInvocationContext invocationContext)` Define o contexto de invocação do módulo enquanto é executado como parte de um conjunto.
`abstract void`	`setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)` Define o `RecoveryMode` de todos os dispositivos que fazem parte do contexto
`abstract void`	`setTestTag (String testTag)` Define a tag de teste de invocação.
`abstract InvocationContext.Context`	`toProto ()` Serialize uma instância de contexto em um protobuf.
`abstract boolean`	`wasReleasedEarly ()` Retorna se os dispositivos foram lançados antecipadamente ou não e não serão mais usados.

Constantes

INVOCATION_ID

public static final String INVOCATION_ID

Chave usada para armazenar o ID de invocação associado.

Valor Constante: “id de invocação”

Métodos públicos

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Rastreie 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`	: o `ERROR(/Map)` do dispositivo adicional para rastrear

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Adicione um ITestDevice para ser rastreado pelos metadados quando o dispositivo for alocado. definirá as informações de construção 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 abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Adicione um IBuildInfo a ser rastreado com o nome de configuração do dispositivo.

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

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Adicione um atributo de invocação.

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

addInvocationAttributes

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

Adicione vários atributos de invocação de uma vez por meio de UniqueMultiMap .

Parâmetros
`attributesMap`	`MultiMap`

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Adicione uma métrica de tempo de invocação.

Parâmetros
`timingEvent`	`IInvocationContext.TimingEvent`
`durationMillis`	`Long`

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Adicione uma série a ser rastreada conforme atribuída a um dos fragmentos que executa alguns testes.

Parâmetros
`index`	`Integer` : o índice do fragmento usando as séries
`serials`	: A lista de seriados a serem rastreados.

getAttribute

public String getAttribute (String key)

Um método conveniente para recuperar atributos de contexto de invocação como um único par de valores-chave. Nunca retorne nulo.

Parâmetros
`key`	`String`

Devoluções
`String`	string vazia quando a chave não existe; caso contrário, o valor.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Retorna uma cópia do mapa contendo todos os atributos de invocação.

Devoluções
`MultiMap <String, String>`

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

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

Parâmetros
`deviceName`	`String`

Devoluções
`IBuildInfo`

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Retorne o IBuildInfo associado ao ITestDevice

Parâmetros
`testDevice`	`ITestDevice`

Devoluções
`IBuildInfo`

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Retorna o nome do dispositivo definido na configuração xml do IBuildInfo . Retorna nulo se o IBuildInfo não puder ser correspondido

Parâmetros
`info`	`IBuildInfo`

Devoluções
`String`

getBuildInfos

public abstract  getBuildInfos ()

Retorne todos os IBuildInfo rastreados para esta invocação.

Devoluções

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Devoluções
`ConfigurationDescriptor`

getDevice

public abstract ITestDevice getDevice (String deviceName)

Retorne o ITestDevice associado ao nome de configuração do dispositivo fornecido.

Parâmetros
`deviceName`	`String`

Devoluções
`ITestDevice`

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Retornar o mapa da associação de informações do dispositivo/construção

Devoluções

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Retorna o ITestDevice associado ao serial fornecido. Evite usar muito, pois não é a pesquisa mais rápida.

Parâmetros
`serial`	`String`

Devoluções
`ITestDevice`

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

Devoluções

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Retorna o nome do dispositivo definido na configuração xml do ITestDevice . Retorna nulo, se ITestDevice não puder ser correspondido.

Parâmetros
`device`	`ITestDevice`

Devoluções
`String`

getDispositivos

public abstract  getDevices ()

Retorne todos os dispositivos alocados rastreados para esta invocação.

Devoluções

getInvocationId

public abstract String getInvocationId ()

Devoluções
`String`	ID de invocação associado ou `null` se não estiver vinculado a uma invocação

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Retorna o mapa que contém as métricas de tempo de invocação.

Devoluções

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Devoluções
`IInvocationContext`

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

Devoluções
`int`

getSerials

public abstract  getSerials ()

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

Devoluções

getShardsSerials

public abstract  getShardsSerials ()

Retorna o mapa de todas as séries rastreadas e seus fragmentos envolvidos na fragmentação. Vazio, se não for uma invocação fragmentada.

Devoluções

getTestTag

public abstract String getTestTag ()

Retorna a tag de teste de invocação.

Devoluções
`String`

markReleasedEarly

public abstract void markReleasedEarly ()

Marque que os dispositivos serão lançados mais cedo.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Parâmetros
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

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

Parâmetros
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Parâmetros
`mode`	`ITestDevice.RecoveryMode`

definirTestTag

public abstract void setTestTag (String testTag)

Define a tag de teste de invocação.

Parâmetros
`testTag`	`String`

paraProto

public abstract InvocationContext.Context toProto ()

Serialize uma instância de contexto em um protobuf.

Devoluções
`InvocationContext.Context`

foi lançado cedo

public abstract boolean wasReleasedEarly ()

Retorna se os dispositivos foram lançados antecipadamente ou não e não serão mais usados.

Devoluções
`boolean`