IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

Contient des informations sur l'invocation auxquelles les tests peuvent accéder si nécessaire. Les tests ne doivent pas modifier le contexte contenu ici. Seuls les getters seront donc disponibles, à l'exception des attributs de contexte à des fins de reporting.

Résumé

Constantes

String INVOCATION_ID

Clé utilisée pour stocker l'ID d'invocation associé.

Méthodes publiques

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

Suivez une carte du nom de l'appareil de configuration associé à un ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Ajoutez un ITestDevice à suivre par les métadonnées lorsque l'appareil est attribué.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Ajoutez un IBuildInfo à suivre avec le nom de la configuration de l'appareil.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Ajoutez un attribut d'invocation.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

Ajoutez plusieurs attributs d'invocation à la fois via un UniqueMultiMap.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Ajoutez une métrique de timing d'invocation.

abstract void addSerialsFromShard(Integer index, List<String> serials)

Ajoutez un numéro de série à suivre comme attribué à l'un des shards exécutant des tests.

default String getAttribute(String key)

Méthode pratique pour récupérer l'attribut de contexte d'invocation sous forme de paire clé-valeur unique.

abstract MultiMap<String, String> getAttributes()

Renvoie une copie de la carte contenant tous les attributs d'invocation.

abstract IBuildInfo getBuildInfo(String deviceName)

Renvoie le IBuildInfo associé au nom de configuration de l'appareil fourni.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Renvoie le IBuildInfo associé au ITestDevice.

abstract String getBuildInfoName(IBuildInfo info)

Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

Renvoie tous les IBuildInfo suivis pour cette invocation.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Renvoie le descripteur associé à la configuration de test qui a lancé l'appel.

abstract ITestDevice getDevice(String deviceName)

Renvoie le ITestDevice associé au nom de configuration de l'appareil fourni.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

Renvoyer la carte de l'association entre les informations sur l'appareil et la version

abstract ITestDevice getDeviceBySerial(String serial)

Renvoie le ITestDevice associé au numéro de série fourni.

abstract List<String> getDeviceConfigNames()

Renvoie la liste des noms de configuration de l'appareil suivi dans cette invocation.

abstract String getDeviceName(ITestDevice device)

Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de ITestDevice.

abstract List<ITestDevice> getDevices()

Renvoie tous les appareils attribués suivis pour cette invocation.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

Renvoie la carte contenant les métriques de timing d'invocation.

abstract IInvocationContext getModuleInvocationContext()

Renvoie le contexte d'invocation du module lors de son exécution dans une suite.

abstract int getNumDevicesAllocated()

Renvoie le nombre d'appareils attribués à l'invocation.

abstract List<String> getSerials()

Renvoie la liste des numéros de série de l'appareil suivi dans cette invocation.

abstract Map<Integer, List<String>> getShardsSerials()

Renvoie le mappage de tous les numéros de série suivis et de leur partition impliquée dans le partitionnement.

abstract String getTestTag()

Renvoie le test-tag d'invocation.

abstract void markReleasedEarly()

Indiquez que les appareils sont mis en vente plus tôt.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Définit le descripteur associé à la configuration de test qui a lancé l'invocation.

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Définit le contexte d'invocation du module lors de son exécution dans une suite.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Définit le RecoveryMode de tous les appareils faisant partie du contexte.

abstract void setTestTag(String testTag)

Définit le tag de test d'invocation.

abstract InvocationContext.Context toProto()

Sérialisez l'instance de contexte dans un fichier protobuf.

abstract boolean wasReleasedEarly()

Indique si les appareils ont été libérés plus tôt et ne seront plus utilisés.

Constantes

INVOCATION_ID

public static final String INVOCATION_ID

Clé utilisée pour stocker l'ID d'invocation associé.

Valeur de constante : "invocation-id"

Méthodes publiques

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Suivez une carte du nom de l'appareil de configuration associé à un ITestDevice. Ne supprime pas le suivi précédent avant d'ajouter le nouveau.

Paramètres
deviceWithName Map : Map d'appareils supplémentaires à suivre

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Ajoutez un ITestDevice à suivre par les métadonnées lorsque l'appareil est attribué. définira les informations de compilation sur "null" dans la carte.

Paramètres
deviceName String : nom de la configuration de l'appareil à associer à ITestDevice
testDevice ITestDevice : à ajouter aux appareils attribués.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Ajoutez un IBuildInfo à suivre avec le nom de la configuration de l'appareil.

Paramètres
deviceName String : nom de la configuration de l'appareil
buildinfo IBuildInfo : IBuildInfo associé au nom de la configuration de l'appareil.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Ajoutez un attribut d'invocation.

Paramètres
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Ajoutez plusieurs attributs d'invocation à la fois via un UniqueMultiMap.

Paramètres
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Ajoutez une métrique de timing d'invocation.

Paramètres
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

Ajoutez un numéro de série à suivre comme attribué à l'un des shards exécutant des tests.

Paramètres
index Integer : index du shard utilisant les numéros de série
serials List : liste des numéros de série à suivre.

getAttribute

public String getAttribute (String key)

Méthode pratique pour récupérer l'attribut de contexte d'invocation sous forme de paire clé-valeur unique. Ne renvoie jamais la valeur "null".

Paramètres
key String

Renvoie
String Chaîne vide si la clé n'existe pas, valeur dans le cas contraire.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Renvoie une copie de la carte contenant tous les attributs d'invocation.

Renvoie
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Renvoie le IBuildInfo associé au nom de configuration de l'appareil fourni. Renvoie la valeur "null" si le nom de l'appareil ne peut pas être mis en correspondance.

Paramètres
deviceName String

Renvoie
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Renvoie le IBuildInfo associé au ITestDevice.

Paramètres
testDevice ITestDevice

Renvoie
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de IBuildInfo. Renvoie la valeur "null" si l'IBuildInfo ne peut pas être mis en correspondance.

Paramètres
info IBuildInfo

Renvoie
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Renvoie tous les IBuildInfo suivis pour cette invocation.

Renvoie
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Renvoie le descripteur associé à la configuration de test qui a lancé l'appel.

Renvoie
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Renvoie le ITestDevice associé au nom de configuration de l'appareil fourni.

Paramètres
deviceName String

Renvoie
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Renvoyer la carte de l'association entre les informations sur l'appareil et la version

Renvoie
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Renvoie le ITestDevice associé au numéro de série fourni. Évitez d'en utiliser trop, car ce n'est pas la méthode la plus rapide.

Paramètres
serial String

Renvoie
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Renvoie la liste des noms de configuration de l'appareil suivi dans cette invocation.

Renvoie
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de ITestDevice. Renvoie la valeur "null" si ITestDevice ne peut pas être mis en correspondance.

Paramètres
device ITestDevice

Renvoie
String

getDevices

public abstract List<ITestDevice> getDevices ()

Renvoie tous les appareils attribués suivis pour cette invocation.

Renvoie
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

Renvoie
String ID d'invocation associé ou null s'il n'est pas associé à une invocation

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

Renvoie la carte contenant les métriques de timing d'invocation.

Renvoie
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Renvoie le contexte d'invocation du module lors de son exécution dans une suite.

Renvoie
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Renvoie le nombre d'appareils attribués à l'invocation.

Renvoie
int

getSerials

public abstract List<String> getSerials ()

Renvoie la liste des numéros de série de l'appareil suivi dans cette invocation.

Renvoie
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Renvoie le mappage de tous les numéros de série suivis et de leur partition impliquée dans le partitionnement. Vide s'il ne s'agit pas d'un appel partitionné.

Renvoie
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Renvoie le test-tag d'invocation.

Renvoie
String

markReleasedEarly

public abstract void markReleasedEarly ()

Indiquez que les appareils sont mis en vente plus tôt.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Définit le descripteur associé à la configuration de test qui a lancé l'invocation.

Paramètres
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Définit le contexte d'invocation du module lors de son exécution dans une suite.

Paramètres
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Définit le RecoveryMode de tous les appareils faisant partie du contexte.

Paramètres
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Définit le tag de test d'invocation.

Paramètres
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Sérialisez l'instance de contexte dans un fichier protobuf.

Renvoie
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Indique si les appareils ont été libérés plus tôt et ne seront plus utilisés.

Renvoie
boolean