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

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

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

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 IBuildInfo associé au nom de configuration de périphérique fourni.

abstract IBuildInfo getBuildInfo ( ITestDevice testDevice)

Renvoie le IBuildInfo associé au ITestDevice

abstract String getBuildInfoName ( IBuildInfo info)

Renvoie le nom du périphérique 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'invocation

abstract ITestDevice getDevice (String deviceName)

Renvoie le ITestDevice associé au nom de configuration de périphérique fourni.

abstract getDeviceBuildMap ()

Renvoie la carte de l'association d'informations de périphérique/build

abstract ITestDevice getDeviceBySerial (String serial)

Renvoie le ITestDevice associé à la série fournie.

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

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 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é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 : l' 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 : La liste des publications en série à suivre.

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

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

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

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

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

public  getInvocationTimingMetrics ()

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

Renvoie la liste des numéros de série de l'appareil suivi dans cet appel

Retour

getShardsSerials

public abstract  getShardsSerials ()

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