IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


Contient des informations sur l'appel pour que les tests puissent accéder si nécessaire. Les tests ne doivent pas modifier le contexte contenu ici, de sorte que seuls les getters soient 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'appel associé.

Méthodes publiques

abstract void addAllocatedDevice( deviceWithName)

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

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

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

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'appel.

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

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

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

Ajoutez une métrique de durée d'appel.

abstract void addSerialsFromShard(Integer index, serials)

Ajoutez une série à suivre en fonction de son attribution à l'un des segments exécutant des tests.

default String getAttribute(String key)

Méthode pratique permettant de récupérer l'attribut de contexte d'appel sous la forme d'une paire clé-valeur unique.

abstract MultiMap<String, String> getAttributes()

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

abstract IBuildInfo getBuildInfo(String deviceName)

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

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Renvoie le IBuildInfo associé à ITestDevice.

abstract String getBuildInfoName(IBuildInfo info)

Renvoie le nom de l'appareil défini dans la configuration XML à partir de IBuildInfo.

abstract getBuildInfos()

Renvoie tous les IBuildInfo suivis pour cet appel.

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 d'appareil fourni.

abstract getDeviceBuildMap()

Afficher la carte de l'association "Informations sur l'appareil/la version"

abstract ITestDevice getDeviceBySerial(String serial)

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

abstract getDeviceConfigNames()

Renvoyer la liste des noms de configuration d'appareil de l'appareil suivi dans cet appel

abstract String getDeviceName(ITestDevice device)

Renvoie le nom de l'appareil défini dans la configuration XML à partir de ITestDevice.

abstract getDevices()

Renvoyez tous les appareils alloués suivis pour cet appel.

abstract String getInvocationId()
default getInvocationTimingMetrics()

Renvoie la carte contenant les métriques de durée d'appel.

abstract IInvocationContext getModuleInvocationContext()

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

abstract int getNumDevicesAllocated()

Renvoyez le nombre d'appareils alloués à l'appel.

abstract getSerials()

Renvoyer la liste des séries de l'appareil suivi dans cet appel

abstract getShardsSerials()

Renvoie la classe Map de toutes les séries suivies et de leur partition impliquée dans la segmentation.

abstract String getTestTag()

Renvoie le tag test d'appel.

abstract void markReleasedEarly()

Indiquez que les appareils sont lancés plus tôt que prévu.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

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

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Définit le contexte d'appel du module lorsqu'il est exécuté dans le cadre d'une suite.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

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

abstract void setTestTag(String testTag)

Définit le tag test d'appel.

abstract InvocationContext.Context toProto()

Sérialiser une instance de contexte dans un tampon de protocole

abstract boolean wasReleasedEarly()

Indique si les appareils ont été lancés plus tôt et s'ils ne seront plus utilisés.

Constantes

ID_INVOCATION

public static final String INVOCATION_ID

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

Valeur constante: "invocation-id"

Méthodes publiques

addAllocationDevice

public abstract void addAllocatedDevice ( deviceWithName)

Suivez une carte du nom de l'appareil de configuration associé à un ITestDevice. Pas clair le suivi précédent avant de l'ajouter.

Paramètres
deviceWithName : ERROR(/Map) de l'appareil supplémentaire à suivre

addAllocationDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Ajoutez un élément ITestDevice à suivre par les métadonnées lorsque l'appareil est alloué. définit 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 alloué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'appel.

Paramètres
attributeName String

attributeValue String

addInvocationAttributes

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

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

Paramètres
attributesMap MultiMap

addInvocationTimingMetric

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

Ajoutez une métrique de durée d'appel.

Paramètres
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Ajoutez une série à suivre en fonction de son attribution à l'un des segments exécutant des tests.

Paramètres
index Integer: index de la partition à l'aide des séries.

serials : liste des séries à suivre.

getAttribute

public String getAttribute (String key)

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

Paramètres
key String

Renvoie
String chaîne vide lorsque 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'appel.

Renvoie
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Renvoie le IBuildInfo associé au nom de configuration d'appareil fourni. Renvoie null si deviceName ne peut pas être mis en correspondance.

Paramètres
deviceName String

Renvoie
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Renvoie le IBuildInfo associé à ITestDevice.

Paramètres
testDevice ITestDevice

Renvoie
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Renvoie le nom de l'appareil défini dans la configuration XML à partir de IBuildInfo. Renvoie null si IBuildInfo ne peut pas être mis en correspondance

Paramètres
info IBuildInfo

Renvoie
String

getBuildInfos

public abstract  getBuildInfos ()

Renvoie tous les IBuildInfo suivis pour cet appel.

Renvoie

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 d'appareil fourni.

Paramètres
deviceName String

Renvoie
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Afficher la carte de l'association "Informations sur l'appareil/la version"

Renvoie

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 recherche la plus rapide.

Paramètres
serial String

Renvoie
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Renvoyer la liste des noms de configuration d'appareil de l'appareil suivi dans cet appel

Renvoie

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Renvoie le nom de l'appareil défini 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

getAppareils

public abstract  getDevices ()

Renvoyez tous les appareils alloués suivis pour cet appel.

Renvoie

getInvocationId

public abstract String getInvocationId ()

Renvoie
String ID d'appel associé, ou null s'il n'est pas associé à un appel

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Renvoie la carte contenant les métriques de durée d'appel.

Renvoie

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Renvoie
IInvocationContext

getNumDevicesAllocation

public abstract int getNumDevicesAllocated ()

Renvoyez le nombre d'appareils alloués à l'appel.

Renvoie
int

getSerials

public abstract  getSerials ()

Renvoyer la liste des séries de l'appareil suivi dans cet appel

Renvoie

getShardsSerials

public abstract  getShardsSerials ()

Renvoie la classe Map de toutes les séries suivies et de leur partition impliquée dans la segmentation. Empty si ce n'est pas une segmenté.

Renvoie

getTestTag

public abstract String getTestTag ()

Renvoie le tag test d'appel.

Renvoie
String

markReleasedEarly

public abstract void markReleasedEarly ()

Indiquez que les appareils sont lancés plus tôt que prévu.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Paramètres
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Définit le contexte d'appel du module lorsqu'il est exécuté dans le cadre d'une suite.

Paramètres
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Paramètres
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Définit le tag test d'appel.

Paramètres
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Sérialiser une instance de contexte dans un tampon de protocole

Renvoie
InvocationContext.Context

DiffuséeEarly

public abstract boolean wasReleasedEarly ()

Indique si les appareils ont été lancés plus tôt et s'ils ne seront plus utilisés.

Renvoie
boolean