IInvocationContext
public
interface
IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Contient des informations sur l'appel pour que les tests puissent y 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 création de rapports.
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 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'invocation. |
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 synchronisation des appels. |
abstract
void
|
addSerialsFromShard(Integer index,
Ajoutez un numéro de série à suivre et attribuez-le à l'un des fragments exécutant des tests. |
default
String
|
getAttribute(String key)
Méthode pratique pour récupérer l'attribut de contexte d'invocation en tant que 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 |
abstract
IBuildInfo
|
getBuildInfo(ITestDevice testDevice)
Renvoie l' |
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 ayant lancé l'appel |
abstract
ITestDevice
|
getDevice(String deviceName)
Renvoie le |
abstract
|
getDeviceBuildMap()
Renvoyer la carte de l'association des informations sur l'appareil/le build |
abstract
ITestDevice
|
getDeviceBySerial(String serial)
Renvoie le |
abstract
|
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'appareil défini dans la configuration XML à partir de |
abstract
|
getDevices()
Renvoie tous les appareils alloués suivis pour cette invocation. |
abstract
String
|
getInvocationId()
|
default
|
getInvocationTimingMetrics()
Renvoie la carte contenant les métriques de synchronisation des invocations. |
abstract
IInvocationContext
|
getModuleInvocationContext()
Renvoie le contexte d'appel 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 cette invocation. |
abstract
|
getShardsSerials()
Renvoie la carte de tous les numéros de série suivis et de leur segment impliqué dans le fractionnement. |
abstract
String
|
getTestTag()
Renvoie la balise de test d'invocation. |
abstract
void
|
markReleasedEarly()
Indiquez que les appareils sont lancés en avance. |
abstract
void
|
setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)
Définit le descripteur associé à la configuration de test ayant lancé l'appel |
abstract
void
|
setModuleInvocationContext(IInvocationContext invocationContext)
Définit le contexte d'appel 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érialiser l'instance de contexte dans un protobuf. |
abstract
boolean
|
wasReleasedEarly()
Indique si les appareils ont été publiés à l'avance 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 de constante : "invocation-id"
Méthodes publiques
addAllocatedDevice
public abstract void addAllocatedDevice (deviceWithName)
Suivez une carte du nom de l'appareil de configuration associé à un ITestDevice
. Ne vide 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 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'invocation.
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 synchronisation des appels.
Paramètres | |
---|---|
timingEvent |
IInvocationContext.TimingEvent |
durationMillis |
Long |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Ajoutez un numéro de série à suivre et attribuez-le à l'un des fragments exécutant des tests.
Paramètres | |
---|---|
index |
Integer : l'index du segment à l'aide des numéros de série |
serials |
: 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 en tant que paire clé-valeur unique. Ne renvoyez jamais la valeur "null".
Paramètres | |
---|---|
key |
String |
Renvoie | |
---|---|
String |
Chaîne vide si la clé n'existe pas, valeur sinon. |
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 l'IBuildInfo
associé à l'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 la valeur "null" si la correspondance de l'IBuildInfo est impossible.
Paramètres | |
---|---|
info |
IBuildInfo |
Renvoie | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Renvoie tous les IBuildInfo
suivis pour cette invocation.
Renvoie | |
---|---|
|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Renvoie le descripteur associé à la configuration de test ayant 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 abstractgetDeviceBuildMap ()
Renvoyer la carte de l'association des informations sur l'appareil/le build
Renvoie | |
---|---|
|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Renvoie le ITestDevice
associé au numéro de série fourni.
N'en abusez pas, car ce n'est pas la recherche la plus rapide.
Paramètres | |
---|---|
serial |
String |
Renvoie | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Renvoie la liste des noms de configuration de l'appareil suivi dans cette invocation.
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 |
getDevices
public abstractgetDevices ()
Renvoie tous les appareils alloués suivis pour cette invocation.
Renvoie | |
---|---|
|
getInvocationId
public abstract String getInvocationId ()
Renvoie | |
---|---|
String |
ID d'invocation associé ou null s'il n'est pas associé à une invocation |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Renvoie la carte contenant les métriques de synchronisation des invocations.
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 |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Renvoie le nombre d'appareils alloués pour l'appel.
Renvoie | |
---|---|
int |
getSerials
public abstractgetSerials ()
Renvoie la liste des numéros de série de l'appareil suivi dans cette invocation.
Renvoie | |
---|---|
|
getShardsSerials
public abstractgetShardsSerials ()
Renvoie la carte de tous les numéros de série suivis et de leur segment impliqué dans le fractionnement. Vide si l'appel n'est pas fractionné.
Renvoie | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Renvoie la balise de test d'invocation.
Renvoie | |
---|---|
String |
markReleasedEarly
public abstract void markReleasedEarly ()
Indiquez que les appareils sont lancés en avance.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Définit le descripteur associé à la configuration de test ayant lancé l'appel
Paramètres | |
---|---|
configurationDescriptor |
ConfigurationDescriptor |
setModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Définit le contexte d'appel 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 |
toProto
public abstract InvocationContext.Context toProto ()
Sérialiser l'instance de contexte dans un protobuf.
Renvoie | |
---|---|
InvocationContext.Context |
wasReleasedEarly
public abstract boolean wasReleasedEarly ()
Indique si les appareils ont été publiés à l'avance et ne seront plus utilisés.
Renvoie | |
---|---|
boolean |