IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.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