Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

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

Generische Implementierung eines IInvocationContext.

Zusammenfassung

Öffentliche Konstruktoren
`InvocationContext()` Erstellt einen `BuildInfo` mit Standardattributwerten.

Öffentliche Methoden
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` Eine Zuordnung des Namens des Konfigurationsgeräts zu einem `ITestDevice` verfolgen.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Fügen Sie ein ITestDevice hinzu, das von den Metadaten verfolgt werden soll, wenn das Gerät zugewiesen wird.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Fügen Sie ein `IBuildInfo` hinzu, das mit dem Namen der Gerätekonfiguration erfasst werden soll.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Fügen Sie ein Aufrufattribut hinzu.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Über eine `UniqueMultiMap` können Sie mehrere Aufrufattribute gleichzeitig hinzufügen.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` Fügen Sie eine Seriennummer hinzu, die als einem der Shards zugewiesen verfolgt werden soll, auf dem einige Tests ausgeführt werden.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Umgekehrter Vorgang zu `InvocationContext.toProto()`, um die Instanz wiederherzustellen.
`MultiMap<String, String>`	`getAttributes()` Gibt eine Kopie der Karte mit allen Aufrufattributen zurück.
`IBuildInfo`	`getBuildInfo(String deviceName)` Gibt die `IBuildInfo` zurück, die mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Gibt den `IBuildInfo` zurück, der dem `ITestDevice` zugeordnet ist.
`String`	`getBuildInfoName(IBuildInfo info)` Gibt den Namen der Gerätegruppe in der XML-Konfiguration aus `IBuildInfo` zurück.
`List<IBuildInfo>`	`getBuildInfos()` Gibt alle `IBuildInfo` zurück, die für diesen Aufruf erfasst wurden.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Gibt den Deskriptor zurück, der der Testkonfiguration zugeordnet ist, mit der der Aufruf gestartet wurde.
`ITestDevice`	`getDevice(String deviceName)` Gibt die `ITestDevice` zurück, die mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Gibt die Zuordnung von Geräte-/Build-Informationen zurück.
`ITestDevice`	`getDeviceBySerial(String serial)` Gibt die `ITestDevice` zurück, die mit der angegebenen Seriennummer verknüpft ist.
`List<String>`	`getDeviceConfigNames()` Gibt die Liste der Namen der Gerätekonfigurationen des in diesem Aufruf verfolgten Geräts zurück.
`String`	`getDeviceName(ITestDevice device)` Gibt den Namen der Gerätegruppe in der XML-Konfiguration aus `ITestDevice` zurück.
`List<ITestDevice>`	`getDevices()` Gibt alle zugewiesenen Geräte zurück, die für diesen Aufruf verfolgt werden.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Gibt den Aufrufkontext des Moduls zurück, während es als Teil einer Suite ausgeführt wird.
`int`	`getNumDevicesAllocated()` Gibt die Anzahl der für den Aufruf zugewiesenen Geräte zurück.
`List<String>`	`getSerials()` Gibt die Liste der Seriennummern des Geräts zurück, das bei diesem Aufruf erfasst wurde.
`Map<Integer, List<String>>`	`getShardsSerials()` Gibt die Map aller verfolgten Seriennummern und des zugehörigen Shards zurück, der am Sharding beteiligt ist.
`String`	`getTestTag()` Gibt das Test-Tag für den Aufruf zurück.
`static boolean`	`isApiTrigger(IInvocationContext context)` Gibt zurück, ob wir einen API-basierten Testaufruf basierend auf dem Triggertyp erkennen.
`static boolean`	`isOnDemand(IInvocationContext context)` Gibt zurück, ob wir den Aufruf von On-Demand-Tests basierend auf dem Triggertyp erkennen.
`static boolean`	`isPresubmit(IInvocationContext context)` Gibt zurück, ob wir einen Presubmit basierend auf dem Triggertyp erkennen.
`void`	`lockAttributes()` Sperren Sie den Kontext, um zu verhindern, dass weitere Aufrufattribute hinzugefügt werden.
`void`	`logInvocationMetrics()` Protokollieren Sie die `InvocationMetricLogger`-Attribute für den Aufruf.
`void`	`markReleasedEarly()` Markieren Sie die Geräte als vorzeitig freigegeben.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Legt den Deskriptor fest, der der Testkonfiguration zugeordnet ist, mit der der Aufruf gestartet wurde.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Legt den Aufrufkontext des Moduls fest, wenn es als Teil einer Suite ausgeführt wird.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Legt die `RecoveryMode` aller Geräte fest, die Teil des Kontexts sind.
`void`	`setTestTag(String testTag)` Legt das Aufruf-Test-Tag fest.
`InvocationContext.Context`	`toProto()` Serialisiert die Kontextinstanz in einen Protokollpuffer.
`boolean`	`wasReleasedEarly()` Gibt zurück, ob die Geräte vorzeitig freigegeben wurden und nicht mehr verwendet werden.

Öffentliche Konstruktoren

InvocationContext

public InvocationContext ()

Erstellt einen BuildInfo mit Standardattributwerten.

Öffentliche Methoden

addAllocatedDevice

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

Eine Zuordnung des Namens des Konfigurationsgeräts zu einem ITestDevice verfolgen. Vor dem Hinzufügen wird das vorherige Tracking nicht gelöscht.

Parameter
`deviceWithName`	`Map`: die `Map` des zusätzlichen Geräts, das getrackt werden soll

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

Fügen Sie ein ITestDevice hinzu, das von den Metadaten verfolgt werden soll, wenn das Gerät zugewiesen wird. Dadurch werden die Build-Informationen in der Karte auf „null“ gesetzt.

Parameter
`devicename`	`String`: Der Name der Gerätekonfiguration, die mit dem `ITestDevice` verknüpft werden soll.
`testDevice`	`ITestDevice`: muss den zugewiesenen Geräten hinzugefügt werden.

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Fügen Sie ein IBuildInfo hinzu, das mit dem Namen der Gerätekonfiguration erfasst werden soll.

Parameter
`deviceName`	`String`: der Name der Gerätekonfiguration
`buildinfo`	`IBuildInfo`: eine `IBuildInfo`, die dem Namen der Gerätekonfiguration zugeordnet ist.

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

Fügen Sie ein Aufrufattribut hinzu.

Parameter
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

Über eine UniqueMultiMap können Sie mehrere Aufrufattribute gleichzeitig hinzufügen.

Parameter
`attributesMap`	`MultiMap`

addSerialsFromShard

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

Fügen Sie eine Seriennummer hinzu, die als einem der Shards zugewiesen verfolgt werden soll, auf dem einige Tests ausgeführt werden.

Parameter
`index`	`Integer`: Der Index des Shards, der die Seriennummern verwendet.
`serials`	`List`: Die Liste der zu verfolgenden Seriennummern.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Umgekehrter Vorgang zu InvocationContext.toProto(), um die Instanz wiederherzustellen.

Parameter
`protoContext`	`InvocationContext.Context`

Gibt Folgendes zurück:
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

Gibt eine Kopie der Karte mit allen Aufrufattributen zurück.

Gibt Folgendes zurück:
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

Gibt die IBuildInfo zurück, die mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist. Gibt „null“ zurück, wenn der deviceName nicht gefunden werden kann.

Parameter
`deviceName`	`String`

Gibt Folgendes zurück:
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

Gibt den IBuildInfo zurück, der dem ITestDevice zugeordnet ist.

Parameter
`testDevice`	`ITestDevice`

Gibt Folgendes zurück:
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

Gibt den Namen der Gerätegruppe in der XML-Konfiguration aus IBuildInfo zurück. Gibt „null“ zurück, wenn keine Übereinstimmung für „IBuildInfo“ gefunden werden kann.

Parameter
`info`	`IBuildInfo`

Gibt Folgendes zurück:
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

Gibt alle IBuildInfo zurück, die für diesen Aufruf erfasst wurden.

Gibt Folgendes zurück:
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

Gibt den Deskriptor zurück, der der Testkonfiguration zugeordnet ist, mit der der Aufruf gestartet wurde.

Gibt Folgendes zurück:
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

Gibt die ITestDevice zurück, die mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.

Parameter
`deviceName`	`String`

Gibt Folgendes zurück:
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Gibt die Zuordnung von Geräte-/Build-Informationen zurück.

Gibt Folgendes zurück:
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

Gibt die ITestDevice zurück, die mit der angegebenen Seriennummer verknüpft ist. Verwenden Sie nicht zu viele, da es sich nicht um die schnellste Suche handelt.

Parameter
`serial`	`String`

Gibt Folgendes zurück:
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

Gibt die Liste der Namen der Gerätekonfigurationen des in diesem Aufruf verfolgten Geräts zurück.

Gibt Folgendes zurück:
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

Gibt den Namen der Gerätegruppe in der XML-Konfiguration aus ITestDevice zurück. Gibt „null“ zurück, wenn „ITestDevice“ nicht zugeordnet werden kann.

Parameter
`device`	`ITestDevice`

Gibt Folgendes zurück:
`String`

getDevices

public List<ITestDevice> getDevices ()

Gibt alle zugewiesenen Geräte zurück, die für diesen Aufruf verfolgt werden.

Gibt Folgendes zurück:
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Gibt Folgendes zurück:
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Gibt den Aufrufkontext des Moduls zurück, während es als Teil einer Suite ausgeführt wird.

Gibt Folgendes zurück:
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

Gibt die Anzahl der für den Aufruf zugewiesenen Geräte zurück.

Gibt Folgendes zurück:
`int`

getSerials

public List<String> getSerials ()

Gibt die Liste der Seriennummern des Geräts zurück, das bei diesem Aufruf erfasst wurde.

Gibt Folgendes zurück:
`List<String>`

getShardsSerials

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

Gibt die Map aller verfolgten Seriennummern und des zugehörigen Shards zurück, der am Sharding beteiligt ist. Leer, wenn es sich nicht um einen Shard-Aufruf handelt.

Gibt Folgendes zurück:
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

Gibt das Test-Tag für den Aufruf zurück.

Gibt Folgendes zurück:
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Gibt zurück, ob wir einen API-basierten Testaufruf basierend auf dem Triggertyp erkennen.

Parameter
`context`	`IInvocationContext`

Gibt Folgendes zurück:
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Gibt zurück, ob wir den Aufruf von On-Demand-Tests basierend auf dem Triggertyp erkennen.

Parameter
`context`	`IInvocationContext`

Gibt Folgendes zurück:
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Gibt zurück, ob wir einen Presubmit basierend auf dem Triggertyp erkennen.

Parameter
`context`	`IInvocationContext`

Gibt Folgendes zurück:
`boolean`

lockAttributes

public void lockAttributes ()

Sperren Sie den Kontext, um zu verhindern, dass weitere Aufrufattribute hinzugefügt werden.

logInvocationMetrics

public void logInvocationMetrics ()

Protokollieren Sie die InvocationMetricLogger-Attribute für den Aufruf.

markReleasedEarly

public void markReleasedEarly ()

Markieren Sie die Geräte als vorzeitig freigegeben.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Legt den Deskriptor fest, der der Testkonfiguration zugeordnet ist, mit der der Aufruf gestartet wurde.

Parameter
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Legt den Aufrufkontext des Moduls fest, wenn es als Teil einer Suite ausgeführt wird.

Parameter
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Legt die RecoveryMode aller Geräte fest, die Teil des Kontexts sind.

Parameter
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Legt das Aufruf-Test-Tag fest.

Parameter
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serialisiert die Kontextinstanz in einen Protokollpuffer.

Gibt Folgendes zurück:
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

Gibt zurück, ob die Geräte vorzeitig freigegeben wurden und nicht mehr verwendet werden.

Gibt Folgendes zurück:
`boolean`