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(
Suivez une carte du nom de l'appareil de configuration associé à un |
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 |
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 |
default
void
|
addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Ajoutez une métrique de durée d'appel. |
abstract
void
|
addSerialsFromShard(Integer index,
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 |
abstract
IBuildInfo
|
getBuildInfo(ITestDevice testDevice)
Renvoie le |
abstract
String
|
getBuildInfoName(IBuildInfo info)
Renvoie le nom de l'appareil défini dans la configuration XML à partir de |
abstract
|
getBuildInfos()
Renvoie tous les |
abstract
ConfigurationDescriptor
|
getConfigurationDescriptor()
Renvoie le descripteur associé à la configuration de test qui a lancé l'appel. |
abstract
ITestDevice
|
getDevice(String deviceName)
Renvoie le |
abstract
|
getDeviceBuildMap()
Afficher la carte de l'association "Informations sur l'appareil/la version" |
abstract
ITestDevice
|
getDeviceBySerial(String serial)
Renvoie le |
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 |
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 |
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 abstractgetBuildInfos ()
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 abstractgetDeviceBuildMap ()
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 abstractgetDeviceConfigNames ()
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 abstractgetDevices ()
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
publicgetInvocationTimingMetrics ()
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 abstractgetSerials ()
Renvoyer la liste des séries de l'appareil suivi dans cet appel
Renvoie | |
---|---|
|
getShardsSerials
public abstractgetShardsSerials ()
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 |