IInvocationContext
public interface IInvocationContext
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 disponibles, à l'exception des attributs de contexte à des fins de génération de rapports.
Résumé
Constantes | |
---|---|
String | INVOCATION_ID Clé utilisée pour stocker l'ID d'appel associé. |
Méthodes publiques | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Suivre une carte du nom du périphérique de configuration associé à un |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Ajoutez un 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 Invocation. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Ajoutez plusieurs attributs d'invocation à la fois via un |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) Ajoutez une métrique de temps d'appel. |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) Ajoutez un numéro de série à suivre en tant qu'assigné à l'un des fragments exécutant des tests. |
default String | getAttribute (String key) Une méthode pratique pour récupérer l'attribut de contexte d'appel sous la forme d'une seule paire clé-valeur. |
abstract MultiMap <String, String> | getAttributes () Renvoie une copie de la carte contenant tous les attributs d'invocation. |
abstract IBuildInfo | getBuildInfo (String deviceName) Renvoie le |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Renvoie le |
abstract String | getBuildInfoName ( IBuildInfo info) Renvoie le nom du périphérique 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'invocation |
abstract ITestDevice | getDevice (String deviceName) Renvoie le |
abstract | getDeviceBuildMap () Renvoie la carte de l'association d'informations de périphérique/build |
abstract ITestDevice | getDeviceBySerial (String serial) Renvoie le |
abstract | getDeviceConfigNames () Renvoie la liste des noms de configuration de périphérique du périphérique 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 () Renvoie tous les appareils alloués suivis pour cet appel. |
abstract String | getInvocationId () |
default | getInvocationTimingMetrics () Renvoie la carte contenant les métriques de synchronisation d'appel. |
abstract IInvocationContext | getModuleInvocationContext () Renvoie le contexte d'invocation du module lors de son exécution dans le cadre d'une suite. |
abstract int | getNumDevicesAllocated () Renvoie le nombre d'appareils alloués pour l'appel. |
abstract | getSerials () Renvoie la liste des numéros de série de l'appareil suivi dans cet appel |
abstract | getShardsSerials () Renvoie la carte de toutes les publications en série suivies et de leur fragment impliqué dans le partitionnement. |
abstract String | getTestTag () Renvoie la balise de test d'invocation. |
abstract void | markReleasedEarly () Marquez que les appareils sortent 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 le cadre d'une suite. |
abstract void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) Définit le |
abstract void | setTestTag (String testTag) Définit la balise de test d'invocation. |
abstract InvocationContext.Context | toProto () Sérialisez une instance de contexte dans un protobuf. |
abstract boolean | wasReleasedEarly () Renvoie si oui ou non 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'appel associé.
Valeur constante : "invocation-id"
Méthodes publiques
addAllocatedDevice
public abstract void addAllocatedDevice (deviceWithName)
Suivre une carte du nom du périphérique de configuration associé à un ITestDevice
. N'efface pas le suivi précédent avant l'ajout.
Paramètres | |
---|---|
deviceWithName | ERROR(/Map) de l'appareil supplémentaire à suivre |
addAllocatedDevice
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Ajoutez un ITestDevice à suivre par les métadonnées lorsque l'appareil est alloué. définira les informations de construction sur null dans la carte.
Paramètres | |
---|---|
deviceName | String : le nom de la configuration de l'appareil à associer à l' 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 : le nom de la configuration de l'appareil |
buildinfo | IBuildInfo : un IBuildInfo associé au nom de la configuration de l'appareil. |
addInvocationAttribute
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Ajoutez un attribut 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 |
addInvocationTimingMetricaddInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Ajoutez une métrique de temps d'appel.
Paramètres | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Ajoutez un numéro de série à suivre en tant qu'assigné à l'un des fragments exécutant des tests.
Paramètres | |
---|---|
index | Integer : l'index du shard utilisant les serials |
serials |
getAttribute
public String getAttribute (String key)
Une méthode pratique pour récupérer l'attribut de contexte d'appel sous la forme d'une seule paire clé-valeur. Ne retourne jamais null.
Paramètres | |
---|---|
key | String |
Retour | |
---|---|
String | chaîne vide lorsque la clé n'existe pas, la valeur sinon. |
getAttributes
public abstract MultiMap<String, String> getAttributes ()
Renvoie une copie de la carte contenant tous les attributs d'invocation.
Retour | |
---|---|
MultiMap <String, String> |
getBuildInfo
public abstract IBuildInfo getBuildInfo (String deviceName)
Renvoie le IBuildInfo
associé au nom de configuration de périphérique fourni. Renvoie null, si le deviceName ne peut pas être mis en correspondance.
Paramètres | |
---|---|
deviceName | String |
Retour | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Renvoie le IBuildInfo
associé au ITestDevice
Paramètres | |
---|---|
testDevice | ITestDevice |
Retour | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Renvoie le nom du périphérique défini dans la configuration xml à partir de IBuildInfo
. Renvoie null si IBuildInfo ne peut pas être mis en correspondance
Paramètres | |
---|---|
info | IBuildInfo |
Retour | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Renvoie tous les IBuildInfo
suivis pour cet appel.
Retour | |
---|---|
getConfigurationDescriptorgetConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Renvoie le descripteur associé à la configuration de test qui a lancé l'invocation
Retour | |
---|---|
ConfigurationDescriptor |
getDevice
public abstract ITestDevice getDevice (String deviceName)
Renvoie le ITestDevice
associé au nom de configuration de périphérique fourni.
Paramètres | |
---|---|
deviceName | String |
Retour | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Renvoie la carte de l'association d'informations de périphérique/build
Retour | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Renvoie le ITestDevice
associé à la série fournie. Évitez d'en utiliser trop car ce n'est pas la recherche la plus rapide.
Paramètres | |
---|---|
serial | String |
Retour | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Renvoie la liste des noms de configuration de périphérique du périphérique suivi dans cet appel
Retour | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Renvoie le nom de l'appareil défini dans la configuration xml à partir de ITestDevice
. Renvoie null, si ITestDevice ne peut pas être mis en correspondance.
Paramètres | |
---|---|
device | ITestDevice |
Retour | |
---|---|
String |
getDevices
public abstractgetDevices ()
Renvoie tous les appareils alloués suivis pour cet appel.
Retour | |
---|---|
getInvocationId
public abstract String getInvocationId ()
Retour | |
---|---|
String | ID d'appel associé ou null si non lié à un appel |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Renvoie la carte contenant les métriques de synchronisation d'appel.
Retour | |
---|---|
getModuleInvocationContextgetModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Renvoie le contexte d'invocation du module lors de son exécution dans le cadre d'une suite.
Retour | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Renvoie le nombre d'appareils alloués pour l'appel.
Retour | |
---|---|
int |
getSerials
public abstractgetSerials ()
Renvoie la liste des numéros de série de l'appareil suivi dans cet appel
Retour | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Renvoie la carte de toutes les publications en série suivies et de leur fragment impliqué dans le partitionnement. Vide s'il ne s'agit pas d'un appel partagé.
Retour | |
---|---|
getTestTag
public abstract String getTestTag ()
Renvoie la balise de test d'invocation.
Retour | |
---|---|
String |
marqueReleasedEarly
public abstract void markReleasedEarly ()
Marquez que les appareils sortent tôt.
setConfigurationDescriptorsetConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Définit le descripteur associé à la configuration de test qui a lancé l'invocation
Paramètres | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvocationContextsetModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Définit le contexte d'invocation du module lors de son exécution 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 faisant partie du contexte
Paramètres | |
---|---|
mode | ITestDevice.RecoveryMode |
setTestTag
public abstract void setTestTag (String testTag)
Définit la balise de test d'invocation.
Paramètres | |
---|---|
testTag | String |
versProto
public abstract InvocationContext.Context toProto ()
Sérialisez une instance de contexte dans un protobuf.
Retour | |
---|---|
InvocationContext.Context |
a été libéré au début
public abstract boolean wasReleasedEarly ()
Renvoie si oui ou non les appareils ont été libérés plus tôt et ne seront plus utilisés.
Retour | |
---|---|
boolean |