IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


Enthält Informationen über den Aufruf, auf die die Tests bei Bedarf zugreifen können. Tests sollten den hier enthaltenen Kontext nicht ändern, sodass nur Getter verfügbar sind, mit Ausnahme der Kontextattribute für Berichtszwecke.

Zusammenfassung

Konstanten

String INVOCATION_ID

Schlüssel zum Speichern der zugehörigen Aufruf-ID.

Öffentliche Methoden

abstract void addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName)

Verfolgen Sie eine Karte des Konfigurationsgerätenamens, der einem ITestDevice zugeordnet ist.

abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)

Fügen Sie ein ITestDevice hinzu, das anhand der Metadaten verfolgt werden soll, wenn das Gerät zugewiesen wird.

abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)

Fügen Sie eine IBuildInfo hinzu, die mit dem Gerätekonfigurationsnamen verfolgt werden soll.

abstract void addInvocationAttribute (String attributeName, String attributeValue)

Fügen Sie ein Aufrufattribut hinzu.

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

Fügen Sie über eine UniqueMultiMap mehrere Aufrufattribute gleichzeitig hinzu.

default void addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Fügen Sie eine Aufruf-Timing-Metrik hinzu.

abstract void addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials)

Fügen Sie eine zu verfolgende Seriennummer hinzu, die einem der Shards zugewiesen ist, auf denen einige Tests ausgeführt werden.

default String getAttribute (String key)

Eine praktische Methode zum Abrufen des Aufrufkontextattributs als einzelnes Schlüssel-Wert-Paar.

abstract MultiMap <String, String> getAttributes ()

Gibt eine Kopie der Karte zurück, die alle Aufrufattribute enthält.

abstract IBuildInfo getBuildInfo (String deviceName)

Gibt die IBuildInfo zurück, die dem angegebenen Gerätekonfigurationsnamen zugeordnet ist.

abstract IBuildInfo getBuildInfo ( ITestDevice testDevice)

Gibt die IBuildInfo zurück, die dem ITestDevice zugeordnet ist

abstract String getBuildInfoName ( IBuildInfo info)

Gibt den Namen des in der XML-Konfiguration festgelegten Geräts aus IBuildInfo zurück.

abstract getBuildInfos ()

Gibt alle für diesen Aufruf verfolgten IBuildInfo zurück.

abstract ConfigurationDescriptor getConfigurationDescriptor ()

Gibt den Deskriptor zurück, der der Testkonfiguration zugeordnet ist, die den Aufruf gestartet hat

abstract ITestDevice getDevice (String deviceName)

Gibt das ITestDevice zurück, das dem angegebenen Gerätekonfigurationsnamen zugeordnet ist.

abstract getDeviceBuildMap ()

Gibt die Karte der Geräte-/Build-Info-Zuordnung zurück

abstract ITestDevice getDeviceBySerial (String serial)

Gibt das ITestDevice zurück, das der angegebenen Seriennummer zugeordnet ist.

abstract getDeviceConfigNames ()

Gibt die Liste der Gerätekonfigurationsnamen des in diesem Aufruf verfolgten Geräts zurück

abstract String getDeviceName ( ITestDevice device)

Gibt den Namen des in der XML-Konfiguration festgelegten Geräts von ITestDevice zurück.

abstract getDevices ()

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

abstract String getInvocationId ()
default getInvocationTimingMetrics ()

Gibt die Karte zurück, die die Aufruf-Timing-Metriken enthält.

abstract IInvocationContext getModuleInvocationContext ()

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

abstract int getNumDevicesAllocated ()

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

abstract getSerials ()

Gibt die Liste der Seriennummern des in diesem Aufruf verfolgten Geräts zurück

abstract getShardsSerials ()

Gibt die Karte aller verfolgten Serien und ihrer am Sharding beteiligten Shards zurück.

abstract String getTestTag ()

Gibt das Aufruftest-Tag zurück.

abstract void markReleasedEarly ()

Markieren Sie, dass die Geräte frühzeitig freigegeben werden.

abstract void setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)

Legt den Deskriptor fest, der der Testkonfiguration zugeordnet ist, die den Aufruf gestartet hat

abstract void setModuleInvocationContext ( IInvocationContext invocationContext)

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

abstract void setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)

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

abstract void setTestTag (String testTag)

Legt das Aufruftest-Tag fest.

abstract InvocationContext.Context toProto ()

Serialisieren Sie die Kontextinstanz in einen Protobuf.

abstract boolean wasReleasedEarly ()

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

Konstanten

INVOCATION_ID

public static final String INVOCATION_ID

Schlüssel zum Speichern der zugehörigen Aufruf-ID.

Konstanter Wert: „invocation-id“

Öffentliche Methoden

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Verfolgen Sie eine Karte des Konfigurationsgerätenamens, der einem ITestDevice zugeordnet ist. Die vorherige Nachverfolgung wird vor dem Hinzufügen nicht gelöscht.

Parameter
deviceWithName : der ERROR(/Map) des zusätzlich zu verfolgenden Geräts

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Fügen Sie ein ITestDevice hinzu, das anhand der Metadaten verfolgt werden soll, wenn das Gerät zugewiesen wird. setzt die Build-Informationen in der Karte auf Null.

Parameter
deviceName String : der Gerätekonfigurationsname, der dem ITestDevice zugeordnet werden soll

testDevice ITestDevice : wird zu den zugewiesenen Geräten hinzugefügt.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Fügen Sie eine IBuildInfo hinzu, die mit dem Gerätekonfigurationsnamen verfolgt werden soll.

Parameter
deviceName String : der Gerätekonfigurationsname

buildinfo IBuildInfo : eine IBuildInfo die dem Gerätekonfigurationsnamen zugeordnet ist.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Fügen Sie ein Aufrufattribut hinzu.

Parameter
attributeName String

attributeValue String

addInvocationAttributes

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

Fügen Sie über eine UniqueMultiMap mehrere Aufrufattribute gleichzeitig hinzu.

Parameter
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Fügen Sie eine Aufruf-Timing-Metrik hinzu.

Parameter
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Fügen Sie eine zu verfolgende Seriennummer hinzu, die einem der Shards zugewiesen ist, auf denen einige Tests ausgeführt werden.

Parameter
index Integer : der Index des Shards, der die Seriennummern verwendet

serials : Die Liste der zu verfolgenden Zeitschriften.

getAttribute

public String getAttribute (String key)

Eine praktische Methode zum Abrufen des Aufrufkontextattributs als einzelnes Schlüssel-Wert-Paar. Geben Sie niemals null zurück.

Parameter
key String

Kehrt zurück
String leere Zeichenfolge, wenn der Schlüssel nicht vorhanden ist, andernfalls der Wert.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Gibt eine Kopie der Karte zurück, die alle Aufrufattribute enthält.

Kehrt zurück
MultiMap <String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Gibt die IBuildInfo zurück, die dem angegebenen Gerätekonfigurationsnamen zugeordnet ist. Gibt null zurück, wenn der Gerätename nicht übereinstimmen kann.

Parameter
deviceName String

Kehrt zurück
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Gibt die IBuildInfo zurück, die dem ITestDevice zugeordnet ist

Parameter
testDevice ITestDevice

Kehrt zurück
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Gibt den Namen des in der XML-Konfiguration festgelegten Geräts aus IBuildInfo zurück. Gibt null zurück, wenn die IBuildInfo nicht abgeglichen werden kann

Parameter
info IBuildInfo

Kehrt zurück
String

getBuildInfos

public abstract  getBuildInfos ()

Gibt alle für diesen Aufruf verfolgten IBuildInfo zurück.

Kehrt zurück

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Gibt den Deskriptor zurück, der der Testkonfiguration zugeordnet ist, die den Aufruf gestartet hat

Kehrt zurück
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Gibt das ITestDevice zurück, das dem angegebenen Gerätekonfigurationsnamen zugeordnet ist.

Parameter
deviceName String

Kehrt zurück
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Gibt die Karte der Geräte-/Build-Info-Zuordnung zurück

Kehrt zurück

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Gibt das ITestDevice zurück, das der angegebenen Seriennummer zugeordnet ist. Verwenden Sie nicht zu viel, da dies nicht die schnellste Suche ist.

Parameter
serial String

Kehrt zurück
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Gibt die Liste der Gerätekonfigurationsnamen des in diesem Aufruf verfolgten Geräts zurück

Kehrt zurück

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Gibt den Namen des in der XML-Konfiguration festgelegten Geräts von ITestDevice zurück. Gibt null zurück, wenn ITestDevice nicht gefunden werden kann.

Parameter
device ITestDevice

Kehrt zurück
String

getDevices

public abstract  getDevices ()

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

Kehrt zurück

getInvocationId

public abstract String getInvocationId ()

Kehrt zurück
String zugehörige Aufruf-ID oder null , wenn nicht mit einem Aufruf verknüpft

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Gibt die Karte zurück, die die Aufruf-Timing-Metriken enthält.

Kehrt zurück

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

Kehrt zurück
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

Kehrt zurück
int

getSerials

public abstract  getSerials ()

Gibt die Liste der Seriennummern des in diesem Aufruf verfolgten Geräts zurück

Kehrt zurück

getShardsSerials

public abstract  getShardsSerials ()

Gibt die Karte aller verfolgten Serien und ihrer am Sharding beteiligten Shards zurück. Leer, wenn es sich nicht um einen Shard-Aufruf handelt.

Kehrt zurück

getTestTag

public abstract String getTestTag ()

Gibt das Aufruftest-Tag zurück.

Kehrt zurück
String

markReleasedEarly

public abstract void markReleasedEarly ()

Markieren Sie, dass die Geräte frühzeitig freigegeben werden.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Legt den Deskriptor fest, der der Testkonfiguration zugeordnet ist, die den Aufruf gestartet hat

Parameter
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

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

Parameter
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Parameter
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Legt das Aufruftest-Tag fest.

Parameter
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Serialisieren Sie die Kontextinstanz in einen Protobuf.

Kehrt zurück
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

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

Kehrt zurück
boolean