IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Contém informações sobre a invocação para que os testes acessem, se necessário. Os testes não podem modificar o contexto contido aqui. Assim, apenas os getters estarão disponíveis, exceto os atributos de contexto para fins de geração de 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 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 para 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 usando 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 para ser rastreado como atribuído a um dos fragmentos que executa 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)

Retorna o IBuildInfo associado ao nome da 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 dispositivo definido na configuração XML do IBuildInfo.

abstract getBuildInfos()

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

abstract ConfigurationDescriptor getConfigurationDescriptor()

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

abstract ITestDevice getDevice(String deviceName)

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

abstract getDeviceBuildMap()

Retorna 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 dispositivo definido na configuração XML do ITestDevice.

abstract getDevices()

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

abstract String getInvocationId()
default getInvocationTimingMetrics()

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

abstract IInvocationContext getModuleInvocationContext()

Retorna o contexto de invocação do módulo enquanto ele é executado 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 séries do dispositivo rastreado nesta invocação

abstract getShardsSerials()

Retorna o mapa de todos os seriados rastreados e o shard deles envolvido no sharding.

abstract String getTestTag()

Retorna a tag de teste de invocação.

abstract void markReleasedEarly()

Marcar os dispositivos que estão sendo lançados com antecedência.

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 ele é executado 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()

Serializa a instância de contexto em um protobuf.

abstract boolean wasReleasedEarly()

Retorna se os dispositivos foram lançados antecipadamente 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 da constante: "invocation-id"

Métodos públicos

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Acompanhe 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 a ser rastreado

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

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

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

addDeviceBuildInfo

public abstract 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 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 usando 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 para ser rastreado como atribuído a um dos fragmentos que executa alguns testes.

Parâmetros
index Integer: o índice do fragmento que usa 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 nulo.

Parâmetros
key String

Retorna
String String vazia quando a chave não existe, o valor em contrário.

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)

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 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 dispositivo definido na configuração XML do IBuildInfo. Retorna null se o IBuildInfo não puder ser correspondido.

Parâmetros
info IBuildInfo

Retorna
String

getBuildInfos

public abstract  getBuildInfos ()

Retorna todos os IBuildInfo rastreados para essa 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)

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

Parâmetros
deviceName String

Retorna
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Retorna 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 muito, porque 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 dispositivo definido na configuração XML do ITestDevice. Retorna "null" se não for possível fazer a correspondência com ITestDevice.

Parâmetros
device ITestDevice

Retorna
String

getDevices

public abstract  getDevices ()

Retorna todos os dispositivos alocados rastreados para essa 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 com as métricas de tempo de invocação.

Retorna

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Retorna
IInvocationContext

getNumDevicesAllocated

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 séries do dispositivo rastreado nesta invocação

Retorna

getShardsSerials

public abstract  getShardsSerials ()

Retorna o mapa de todos os seriados rastreados e o shard deles envolvido no sharding. Vazia se não for uma invocação fragmentada.

Retorna

getTestTag

public abstract String getTestTag ()

Retorna a tag de teste de invocação.

Retorna
String

markReleasedEarly

public abstract void markReleasedEarly ()

Marcar os dispositivos que estão sendo lançados com antecedência.

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 ele é executado 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 ()

Serializa a instância de contexto em um protobuf.

Retorna
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

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

Retorna
boolean