À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

Implémentation générique d'un IInvocationContext.

Résumé

Constructeurs publics
`InvocationContext()` Crée un `BuildInfo` à l'aide des valeurs d'attribut par défaut.

Méthodes publiques
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` Suivez une carte du nom de l'appareil de configuration associé à un `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Ajoutez un ITestDevice à suivre par les métadonnées lorsque l'appareil est attribué.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Ajoutez un `IBuildInfo` à suivre avec le nom de la configuration de l'appareil.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Ajoutez un attribut d'invocation.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Ajoutez plusieurs attributs d'invocation à la fois via un `UniqueMultiMap`.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` Ajoutez un numéro de série à suivre comme attribué à l'un des shards exécutant des tests.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Opération inverse de `InvocationContext.toProto()` pour récupérer l'instance.
`MultiMap<String, String>`	`getAttributes()` Renvoie une copie de la carte contenant tous les attributs d'invocation.
`IBuildInfo`	`getBuildInfo(String deviceName)` Renvoie le `IBuildInfo` associé au nom de configuration de l'appareil fourni.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Renvoie le `IBuildInfo` associé au `ITestDevice`.
`String`	`getBuildInfoName(IBuildInfo info)` Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` Renvoie tous les `IBuildInfo` suivis pour cette invocation.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Renvoie le descripteur associé à la configuration de test qui a lancé l'appel.
`ITestDevice`	`getDevice(String deviceName)` Renvoie le `ITestDevice` associé au nom de configuration de l'appareil fourni.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Renvoyer la carte de l'association entre les informations sur l'appareil et la version
`ITestDevice`	`getDeviceBySerial(String serial)` Renvoie le `ITestDevice` associé au numéro de série fourni.
`List<String>`	`getDeviceConfigNames()` Renvoie la liste des noms de configuration de l'appareil suivi dans cette invocation.
`String`	`getDeviceName(ITestDevice device)` Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de `ITestDevice`.
`List<ITestDevice>`	`getDevices()` Renvoie tous les appareils attribués suivis pour cette invocation.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Renvoie le contexte d'invocation du module lors de son exécution dans une suite.
`int`	`getNumDevicesAllocated()` Renvoie le nombre d'appareils attribués à l'invocation.
`List<String>`	`getSerials()` Renvoie la liste des numéros de série de l'appareil suivi dans cette invocation.
`Map<Integer, List<String>>`	`getShardsSerials()` Renvoie le mappage de tous les numéros de série suivis et de leur partition impliquée dans le partitionnement.
`String`	`getTestTag()` Renvoie le test-tag d'invocation.
`static boolean`	`isApiTrigger(IInvocationContext context)` Indique si nous détectons l'appel de test basé sur l'API en fonction du type de déclencheur.
`static boolean`	`isOnDemand(IInvocationContext context)` Indique si nous détectons l'appel de test à la demande en fonction du type de déclencheur.
`static boolean`	`isPresubmit(IInvocationContext context)` Indique si nous détectons la pré-soumission en fonction du type de déclencheur.
`void`	`lockAttributes()` Verrouillez le contexte pour empêcher l'ajout d'autres attributs d'invocation.
`void`	`logInvocationMetrics()` Enregistrez les attributs `InvocationMetricLogger` dans l'invocation.
`void`	`markReleasedEarly()` Indiquez que les appareils sont mis en vente plus tôt.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Définit le descripteur associé à la configuration de test qui a lancé l'invocation.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Définit le contexte d'invocation du module lors de son exécution dans une suite.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Définit le `RecoveryMode` de tous les appareils faisant partie du contexte.
`void`	`setTestTag(String testTag)` Définit le tag de test d'invocation.
`InvocationContext.Context`	`toProto()` Sérialisez l'instance de contexte dans un fichier protobuf.
`boolean`	`wasReleasedEarly()` Indique si les appareils ont été libérés plus tôt et ne seront plus utilisés.

Constructeurs publics

InvocationContext

public InvocationContext ()

Crée un BuildInfo à l'aide des valeurs d'attribut par défaut.

Méthodes publiques

addAllocatedDevice

public void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Suivez une carte du nom de l'appareil de configuration associé à un ITestDevice. Ne supprime pas le suivi précédent avant d'ajouter le nouveau.

Paramètres
`deviceWithName`	`Map` : `Map` d'appareils supplémentaires à suivre

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

Ajoutez un ITestDevice à suivre par les métadonnées lorsque l'appareil est attribué. 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 attribués.

addDeviceBuildInfo

public 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 void addInvocationAttribute (String attributeName, 
                String attributeValue)

Ajoutez un attribut d'invocation.

Paramètres
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

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

Paramètres
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

Ajoutez un numéro de série à suivre comme attribué à l'un des shards exécutant des tests.

Paramètres
`index`	`Integer` : index du shard utilisant les numéros de série
`serials`	`List` : liste des numéros de série à suivre.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Opération inverse de InvocationContext.toProto() pour récupérer l'instance.

Paramètres
`protoContext`	`InvocationContext.Context`

Renvoie
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

Renvoie une copie de la carte contenant tous les attributs d'invocation.

Renvoie
`MultiMap<String, String>`

getBuildInfo

public 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 IBuildInfo getBuildInfo (ITestDevice testDevice)

Renvoie le IBuildInfo associé au ITestDevice.

Paramètres
`testDevice`	`ITestDevice`

Renvoie
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

Renvoie le nom de l'ensemble d'appareils dans la configuration XML à partir de IBuildInfo. Renvoie la valeur "null" si l'IBuildInfo ne peut pas être mis en correspondance.

Paramètres
`info`	`IBuildInfo`

Renvoie
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

Renvoie tous les IBuildInfo suivis pour cette invocation.

Renvoie
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

Renvoie le descripteur associé à la configuration de test qui a lancé l'appel.

Renvoie
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

Paramètres
`deviceName`	`String`

Renvoie
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Renvoyer la carte de l'association entre les informations sur l'appareil et la version

Renvoie
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public 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 méthode la plus rapide.

Paramètres
`serial`	`String`

Renvoie
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

Renvoie la liste des noms de configuration de l'appareil suivi dans cette invocation.

Renvoie
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

Renvoie le nom de l'ensemble d'appareils 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 List<ITestDevice> getDevices ()

Renvoie tous les appareils attribués suivis pour cette invocation.

Renvoie
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Renvoie
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Renvoie le contexte d'invocation du module lors de son exécution dans une suite.

Renvoie
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Renvoie le nombre d'appareils attribués à l'invocation.

Renvoie
`int`

getSerials

public List<String> getSerials ()

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

Renvoie
`List<String>`

getShardsSerials

public Map<Integer, List<String>> getShardsSerials ()

Renvoie le mappage de tous les numéros de série suivis et de leur partition impliquée dans le partitionnement. Vide s'il ne s'agit pas d'un appel partitionné.

Renvoie
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

Renvoie le test-tag d'invocation.

Renvoie
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Indique si nous détectons l'appel de test basé sur l'API en fonction du type de déclencheur.

Paramètres
`context`	`IInvocationContext`

Renvoie
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Indique si nous détectons l'appel de test à la demande en fonction du type de déclencheur.

Paramètres
`context`	`IInvocationContext`

Renvoie
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Indique si nous détectons la pré-soumission en fonction du type de déclencheur.

Paramètres
`context`	`IInvocationContext`

Renvoie
`boolean`

lockAttributes

public void lockAttributes ()

Verrouillez le contexte pour empêcher l'ajout d'autres attributs d'invocation.

logInvocationMetrics

public void logInvocationMetrics ()

Enregistrez les attributs InvocationMetricLogger dans l'invocation.

markReleasedEarly

public void markReleasedEarly ()

Indiquez que les appareils sont mis en vente plus tôt.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Définit le descripteur associé à la configuration de test qui a lancé l'invocation.

Paramètres
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Définit le contexte d'invocation du module lors de son exécution dans une suite.

Paramètres
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Définit le RecoveryMode de tous les appareils faisant partie du contexte.

Paramètres
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Définit le tag de test d'invocation.

Paramètres
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Sérialisez l'instance de contexte dans un fichier protobuf.

Renvoie
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

Indique si les appareils ont été libérés plus tôt et ne seront plus utilisés.

Renvoie
`boolean`