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 |
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 |
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 |
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 |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Retorne o |
abstract String | getBuildInfoName ( IBuildInfo info) Retorna o nome do dispositivo definido na configuração xml do |
abstract | getBuildInfos () Retorne todos os |
abstract ConfigurationDescriptor | getConfigurationDescriptor () Retorna o descritor associado à configuração de teste que iniciou a invocação |
abstract ITestDevice | getDevice (String deviceName) Retorne o |
abstract | getDeviceBuildMap () Retornar o mapa da associação de informações do dispositivo/construção |
abstract ITestDevice | getDeviceBySerial (String serial) Retorna o |
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 |
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 |
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 | 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 |
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 abstractgetBuildInfos ()
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 abstractgetDeviceBuildMap ()
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 abstractgetDeviceConfigNames ()
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 abstractgetDevices ()
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
publicgetInvocationTimingMetrics ()
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 abstractgetSerials ()
Retorne a lista de números de série do dispositivo rastreado nesta invocação
Devoluções | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
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 |