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( 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 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'invocation.

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 synchronisation des appels.

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.

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 IBuildInfo associé au nom de configuration de l'appareil fourni.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Renvoie l'IBuildInfo associé à l'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 cette invocation.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Renvoie le descripteur associé à la configuration de test ayant lancé l'appel

abstract ITestDevice getDevice(String deviceName)

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

abstract getDeviceBuildMap()

Renvoyer la carte de l'association des informations sur l'appareil/le build

abstract ITestDevice getDeviceBySerial(String serial)

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

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 ITestDevice.

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 RecoveryMode de tous les appareils faisant partie du contexte.

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 abstract  getBuildInfos ()

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 abstract  getDeviceBuildMap ()

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 abstract  getDeviceConfigNames ()

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 abstract  getDevices ()

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

public  getInvocationTimingMetrics ()

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 abstract  getSerials ()

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

Renvoie

getShardsSerials

public abstract  getShardsSerials ()

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