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 |
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 |
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 |
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 |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Gibt die |
abstract String | getBuildInfoName ( IBuildInfo info) Gibt den Namen des in der XML-Konfiguration festgelegten Geräts aus |
abstract | getBuildInfos () Gibt alle für diesen Aufruf verfolgten |
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 |
abstract | getDeviceBuildMap () Gibt die Karte der Geräte-/Build-Info-Zuordnung zurück |
abstract ITestDevice | getDeviceBySerial (String serial) Gibt das |
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 |
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 |
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 | 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 |
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 abstractgetBuildInfos ()
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 abstractgetDeviceBuildMap ()
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 abstractgetDeviceConfigNames ()
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 abstractgetDevices ()
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
publicgetInvocationTimingMetrics ()
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 abstractgetSerials ()
Gibt die Liste der Seriennummern des in diesem Aufruf verfolgten Geräts zurück
Kehrt zurück | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
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 |