IInvocationContext
public
interface
IInvocationContext
implements
Serializable
| com.android.tradefed.invoker.IInvocationContext |
Contém informações sobre a invocação para os testes acessarem, se necessário. Os testes não podem modificar o contexto contido aqui. Portanto, 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(Map<String, ITestDevice> deviceWithName)
Rastreia um mapa do nome do dispositivo de configuração associado a um |
abstract
void
|
addAllocatedDevice(String deviceName, ITestDevice testDevice)
Adiciona um ITestDevice para ser rastreado pelos metadados quando o dispositivo é 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 só vez usando um |
default
void
|
addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Adicione uma métrica de tempo de invocação. |
abstract
void
|
addSerialsFromShard(Integer index, List<String> serials)
Adicione um número de série para ser rastreado como 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)
Retorna o |
abstract
IBuildInfo
|
getBuildInfo(ITestDevice testDevice)
Retorna o |
abstract
String
|
getBuildInfoName(IBuildInfo info)
Retorna o nome do conjunto de dispositivos na configuração XML do |
abstract
List<IBuildInfo>
|
getBuildInfos()
Retorna todos os |
abstract
ConfigurationDescriptor
|
getConfigurationDescriptor()
Retorna o descritor associado à configuração de teste que iniciou a invocação. |
abstract
ITestDevice
|
getDevice(String deviceName)
Retorna o |
abstract
Map<ITestDevice, IBuildInfo>
|
getDeviceBuildMap()
Retorna o mapa da associação de informações do dispositivo/build. |
abstract
ITestDevice
|
getDeviceBySerial(String serial)
Retorna o |
abstract
List<String>
|
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 XML de |
abstract
List<ITestDevice>
|
getDevices()
Retorna todos os dispositivos alocados rastreados para essa invocação. |
abstract
String
|
getInvocationId()
|
default
Map<IInvocationContext.TimingEvent, Long>
|
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
List<String>
|
getSerials()
Retorna a lista de números de série do dispositivo rastreado nesta invocação. |
abstract
Map<Integer, List<String>>
|
getShardsSerials()
Retorna o mapa de todos os números de série rastreados e seus fragmentos envolvidos no fragmentação. |
abstract
String
|
getTestTag()
Retorna a tag de teste de invocação. |
abstract
void
|
markReleasedEarly()
Marque que os dispositivos serão lançados antes. |
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 ao ser 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()
Serializa a instância de contexto em um protobuf. |
abstract
boolean
|
wasReleasedEarly()
Retorna se os dispositivos foram lançados antes do tempo 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 (Map<String, ITestDevice> deviceWithName)
Rastreia 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 |
Map: o Map de um 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 de build 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 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,
List<String> serials)Adicione um número de série para ser rastreado como 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 |
List: a lista de números de série a serem rastreados. |
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 caso 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 conjunto de dispositivos na configuração XML do IBuildInfo. Retorna
nulo se o IBuildInfo não puder ser correspondido
| Parâmetros | |
|---|---|
info |
IBuildInfo |
| Retorna | |
|---|---|
String |
|
getBuildInfos
public abstract List<IBuildInfo> getBuildInfos ()
Retorna todos os IBuildInfo rastreados para essa invocação.
| Retorna | |
|---|---|
List<IBuildInfo> |
|
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 Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()
Retorna o mapa da associação de informações do dispositivo/build.
| Retorna | |
|---|---|
Map<ITestDevice, IBuildInfo> |
|
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 List<String> getDeviceConfigNames ()
Retorna a lista de nomes de configuração do dispositivo rastreado nesta invocação.
| Retorna | |
|---|---|
List<String> |
|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Retorna o nome do conjunto de dispositivos na configuração XML de ITestDevice.
Retorna nulo se ITestDevice não puder ser correspondido.
| Parâmetros | |
|---|---|
device |
ITestDevice |
| Retorna | |
|---|---|
String |
|
getDevices
public abstract List<ITestDevice> getDevices ()
Retorna todos os dispositivos alocados rastreados para essa invocação.
| Retorna | |
|---|---|
List<ITestDevice> |
|
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 Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()
Retorna o mapa com as métricas de tempo de invocação.
| Retorna | |
|---|---|
Map<IInvocationContext.TimingEvent, Long> |
|
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 List<String> getSerials ()
Retorna a lista de números de série do dispositivo rastreado nesta invocação.
| Retorna | |
|---|---|
List<String> |
|
getShardsSerials
public abstract Map<Integer, List<String>> getShardsSerials ()
Retorna o mapa de todos os números de série rastreados e seus fragmentos envolvidos no fragmentação. Vazio se não for uma invocação fragmentada.
| Retorna | |
|---|---|
Map<Integer, List<String>> |
|
getTestTag
public abstract String getTestTag ()
Retorna a tag de teste de invocação.
| Retorna | |
|---|---|
String |
|
markReleasedEarly
public abstract void markReleasedEarly ()
Marque que os dispositivos serão lançados antes.
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 ao ser 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 |
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 antes do tempo e não serão mais usados.
| Retorna | |
|---|---|
boolean |
|