ContextodeInvocação

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Subclasses indiretas conhecidas InvocationContext (link em inglês) InvocationContext (link em inglês) Implementação genérica de um IInvocationContext.

---

Mantém informações sobre a invocação que os testes podem acessar, se necessário. Os testes não devem modificar o contexto contido aqui, de modo que apenas getters estarão disponíveis, exceto para os atributos de contexto para gerar relatórios.

Resumo

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

Métodos públicos
abstract void	addAllocatedDevice( deviceWithName) Acompanhe um mapa com o nome do dispositivo de configuração associado a um ITestDevice.
abstract void	addAllocatedDevice(String deviceName, ITestDevice testDevice) Adicione um ITestDevice que será rastreado pelos metadados quando o dispositivo for alocado.
abstract void	addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo) Adicione um IBuildInfo que será rastreado com o nome da 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 só vez com um UniqueMultiMap.
default void	addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis) Adicione uma métrica de tempo de invocação.
abstract void	addSerialsFromShard(Integer index, serials) Adicione um número de série a ser rastreado conforme atribuído a um dos fragmentos que executam alguns testes.
default String	getAttribute(String key) Um método conveniente para recuperar o atributo de contexto de invocação como um único par de chave-valor.
abstract MultiMap<String, String>	getAttributes() Retorna uma cópia do mapa que contém 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) Retorna o IBuildInfo associado ao ITestDevice.
abstract String	getBuildInfoName(IBuildInfo info) Retorna o nome do conjunto de dispositivos na configuração de XML da 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/build
abstract ITestDevice	getDeviceBySerial(String serial) Retorna o ITestDevice associado ao número de série fornecido.
abstract	getDeviceConfigNames() Retorna a lista de nomes de configuração do dispositivo rastreado nesta invocação
abstract String	getDeviceName(ITestDevice device) Retorna o nome do conjunto de dispositivos na configuração de XML da ITestDevice.
abstract	getDevices() Retorna 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 durante a execução como parte de um pacote.
abstract int	getNumDevicesAllocated() Retorna o número de dispositivos alocados para a invocação.
abstract	getSerials() Retorna a lista de números de série do dispositivo rastreado nesta invocação
abstract	getShardsSerials() Retorna o mapa de todos os números de série rastreados e seu fragmento envolvido na fragmentação.
abstract String	getTestTag() Retorna a tag de teste de invocação.
abstract void	markReleasedEarly() Informe que os dispositivos serão lançados antecipadamente.
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 durante a execução como parte de um pacote.
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() Informa se os dispositivos foram lançados antecipadamente e não serão mais usados.

Constantes

ID_INVOCATION

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

addAllocationsDevice

public abstract void addAllocatedDevice ( deviceWithName)

Acompanhe um mapa com o nome do dispositivo de configuração associado a um ITestDevice. Não está claro o acompanhamento anterior antes de adicionar.

Parâmetros
deviceWithName	: o ERROR(/Map) do dispositivo extra para rastrear

addAllocationsDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

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

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

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Adicione um IBuildInfo que 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 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 só vez com um 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 um número de série a ser rastreado conforme 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	: a lista de séries a serem rastreadas.

getAttribute

public String getAttribute (String key)

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

Parâmetros
key	String

Retorna
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 que contém todos os atributos de invocação.

Retorna
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Retorne o IBuildInfo associado ao nome de configuração do dispositivo fornecido. Devoluções nulo, se deviceName não tiver correspondência.

Parâmetros
deviceName	String

Retorna
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Retorna o IBuildInfo associado ao ITestDevice.

Parâmetros
testDevice	ITestDevice

Retorna
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Retorna o nome do conjunto de dispositivos na configuração de XML da IBuildInfo. Devoluções nulo se o IBuildInfo não puder corresponder

Parâmetros
info	IBuildInfo

Retorna
String

getBuildInfos

public abstract  getBuildInfos ()

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

Retorna

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Retorna
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

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

Parâmetros
deviceName	String

Retorna
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

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

Retorna

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

Parâmetros
serial	String

Retorna
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

Retorna

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Retorna o nome do conjunto de dispositivos na configuração de XML da ITestDevice. Retorna nulo, se ITestDevice não puder corresponder.

Parâmetros
device	ITestDevice

Retorna
String

getDevices

public abstract  getDevices ()

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

Retorna

getInvocationId

public abstract String getInvocationId ()

Retorna
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.

Retorna

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Retorna o contexto de invocação do módulo durante a execução como parte de um pacote.

Retorna
IInvocationContext

getNumDevicesAlallocate

public abstract int getNumDevicesAllocated ()

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

Retorna
int

getSerials

public abstract  getSerials ()

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

Retorna

getShardsSerials

public abstract  getShardsSerials ()

Retorna o mapa de todos os números de série rastreados e seu fragmento envolvido na fragmentação. Vazio se não for um da invocação fragmentada.

Retorna

getTestTag

public abstract String getTestTag ()

Retorna a tag de teste de invocação.

Retorna
String

markReleasedEarly

public abstract void markReleasedEarly ()

Informe que os dispositivos serão lançados antecipadamente.

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 durante a execução como parte de um pacote.

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

setTestTag

public abstract void setTestTag (String testTag)

Define a tag de teste de invocação.

Parâmetros
testTag	String

toProto

public abstract InvocationContext.Context toProto ()

Serialize uma instância de contexto em um protobuf.

Retorna
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

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

Retorna
boolean