IInvocationContext
public
interface
IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Enthält Informationen zur Aufrufabfolge, auf die die Tests bei Bedarf zugreifen können. Der hier enthaltene Kontext sollte durch Tests nicht geändert werden. Daher sind nur Getter verfügbar, 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(
Eine Zuordnung des Namens des Konfigurationsgeräts zu einer |
abstract
void
|
addAllocatedDevice(String deviceName, ITestDevice testDevice)
Fügen Sie ein ITestDevice hinzu, das von den Metadaten erfasst werden soll, wenn das Gerät zugewiesen wird. |
abstract
void
|
addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)
Fügen Sie ein |
abstract
void
|
addInvocationAttribute(String attributeName, String attributeValue)
Fügen Sie ein Aufrufattribut hinzu. |
abstract
void
|
addInvocationAttributes(MultiMap<String, String> attributesMap)
Mehrere Aufrufattribute gleichzeitig über eine |
default
void
|
addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Fügen Sie einen Messwert für die Aufrufzeit hinzu. |
abstract
void
|
addSerialsFromShard(Integer index,
Fügen Sie eine Seriennummer hinzu, die einem Shard zugewiesen werden soll, in dem einige Tests ausgeführt werden. |
default
String
|
getAttribute(String key)
Eine praktische Methode zum Abrufen des Attributs „Aufrufkontext“ als einzelnes Schlüssel/Wert-Paar. |
abstract
MultiMap<String, String>
|
getAttributes()
Gibt eine Kopie der Karte mit allen Aufrufattributen zurück. |
abstract
IBuildInfo
|
getBuildInfo(String deviceName)
Gibt den |
abstract
IBuildInfo
|
getBuildInfo(ITestDevice testDevice)
Gibt den |
abstract
String
|
getBuildInfoName(IBuildInfo info)
Gibt den Namen der Gerätegruppe in der XML-Konfiguration von |
abstract
|
getBuildInfos()
Gibt alle |
abstract
ConfigurationDescriptor
|
getConfigurationDescriptor()
Gibt den Deskriptor zurück, der mit der Testkonfiguration verknüpft ist, über die die Aufrufe gestartet wurden. |
abstract
ITestDevice
|
getDevice(String deviceName)
Gibt den |
abstract
|
getDeviceBuildMap()
Die Zuordnungstabelle von Geräte-/Build-Informationen zurückgeben |
abstract
ITestDevice
|
getDeviceBySerial(String serial)
Gibt die |
abstract
|
getDeviceConfigNames()
Liste der Namen der Gerätekonfigurationen des bei dieser Aufrufung erfassten Geräts zurückgeben |
abstract
String
|
getDeviceName(ITestDevice device)
Gibt den Namen der Gerätegruppe zurück, die in der XML-Konfiguration von |
abstract
|
getDevices()
Gibt alle zugewiesenen Geräte zurück, die für diese Aufrufe erfasst wurden. |
abstract
String
|
getInvocationId()
|
default
|
getInvocationTimingMetrics()
Die Karte mit den Messwerten für die Aufrufzeit wird zurückgegeben. |
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 Geräte zurück, die für die Aufrufe zugewiesen sind. |
abstract
|
getSerials()
Liste der Seriennummern des bei dieser Aufrufung erfassten Geräts zurückgeben |
abstract
|
getShardsSerials()
Gibt die Zuordnung aller erfassten Serien und ihrer Shards zurück, die am Sharding beteiligt sind. |
abstract
String
|
getTestTag()
Gibt das Test-Tag für die Aufrufe zurück. |
abstract
void
|
markReleasedEarly()
Markieren Sie die Geräte, die vorzeitig veröffentlicht werden. |
abstract
void
|
setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)
Legt den Descriptor für die Testkonfiguration fest, über die die Aufrufe gestartet wurden. |
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)
Hiermit wird das Test-Tag für die Aufrufe festgelegt. |
abstract
InvocationContext.Context
|
toProto()
Serialisieren Sie die Kontextinstanz in einen Protokollpuffer. |
abstract
boolean
|
wasReleasedEarly()
Gibt an, ob die Geräte vorzeitig veröffentlicht 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)
Eine Zuordnung des Namens des Konfigurationsgeräts zu einer ITestDevice
erfassen Das vorherige Tracking wird vor dem Hinzufügen nicht gelöscht.
Parameter | |
---|---|
deviceWithName |
: die ERROR(/Map) des zusätzlichen Geräts, das Sie erfassen möchten |
addAllocatedDevice
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Fügen Sie ein ITestDevice hinzu, das von den Metadaten erfasst werden soll, wenn das Gerät zugewiesen wird. werden die Gebäudeinformationen in der Karte auf „null“ gesetzt.
Parameter | |
---|---|
deviceName |
String : Der Name der Gerätekonfiguration, der mit der ITestDevice verknüpft werden soll. |
testDevice |
ITestDevice : die den zugewiesenen Geräten hinzugefügt werden soll. |
addDeviceBuildInfo
public abstract 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 : Name der Gerätekonfiguration |
buildinfo |
IBuildInfo : Ein IBuildInfo , das mit dem Namen der Gerätekonfiguration verknüpft 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)
Mehrere Aufrufattribute gleichzeitig über eine UniqueMultiMap
hinzufügen.
Parameter | |
---|---|
attributesMap |
MultiMap |
addInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Fügen Sie einen Messwert für die Aufrufzeit hinzu.
Parameter | |
---|---|
timingEvent |
IInvocationContext.TimingEvent |
durationMillis |
Long |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Fügen Sie eine Seriennummer hinzu, die einem Shard zugewiesen werden soll, in dem einige Tests ausgeführt werden.
Parameter | |
---|---|
index |
Integer : der Index der Shard, der die Seriennummern verwendet |
serials |
: Die Liste der zu verfolgenden Serien. |
getAttribute
public String getAttribute (String key)
Eine praktische Methode zum Abrufen des Attributs „Aufrufkontext“ als einzelnes Schlüssel/Wert-Paar. Gibt niemals null zurück.
Parameter | |
---|---|
key |
String |
Returns | |
---|---|
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 mit allen Aufrufattributen zurück.
Returns | |
---|---|
MultiMap<String, String> |
getBuildInfo
public abstract IBuildInfo getBuildInfo (String deviceName)
Gibt den IBuildInfo
zurück, der mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist. Gibt „null“ zurück, wenn der deviceName nicht zugeordnet werden kann.
Parameter | |
---|---|
deviceName |
String |
Returns | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Gibt den IBuildInfo
zurück, der mit dem ITestDevice
verknüpft ist.
Parameter | |
---|---|
testDevice |
ITestDevice |
Returns | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Gibt den Namen der Gerätegruppe in der XML-Konfiguration von IBuildInfo
zurück. Gibt NULL zurück, wenn die IBuildInfo nicht zugeordnet werden kann.
Parameter | |
---|---|
info |
IBuildInfo |
Returns | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Gibt alle IBuildInfo
zurück, die für diese Aufrufe erfasst wurden.
Returns | |
---|---|
|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Gibt den Deskriptor zurück, der mit der Testkonfiguration verknüpft ist, über die die Aufrufe gestartet wurden.
Returns | |
---|---|
ConfigurationDescriptor |
getDevice
public abstract ITestDevice getDevice (String deviceName)
Gibt den ITestDevice
zurück, der mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.
Parameter | |
---|---|
deviceName |
String |
Returns | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Die Zuordnungstabelle von Geräte-/Build-Informationen zurückgeben
Returns | |
---|---|
|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Gibt die ITestDevice
zurück, die mit der angegebenen Seriennummer verknüpft ist.
Verwenden Sie diese Funktion nicht zu oft, da sie nicht die schnellste Suche ist.
Parameter | |
---|---|
serial |
String |
Returns | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Liste der Namen der Gerätekonfigurationen des bei dieser Aufrufung erfassten Geräts zurückgeben
Returns | |
---|---|
|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Gibt den Namen der Gerätegruppe zurück, die in der XML-Konfiguration von ITestDevice
festgelegt ist.
Gibt „null“ zurück, wenn ITestDevice nicht zugeordnet werden kann.
Parameter | |
---|---|
device |
ITestDevice |
Returns | |
---|---|
String |
getDevices
public abstractgetDevices ()
Gibt alle zugewiesenen Geräte zurück, die für diese Aufrufe erfasst wurden.
Returns | |
---|---|
|
getInvocationId
public abstract String getInvocationId ()
Returns | |
---|---|
String |
Die zugehörige Aufruf-ID oder null , wenn keine Verknüpfung mit einem Aufruf besteht |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Die Karte mit den Messwerten für die Aufrufzeit wird zurückgegeben.
Returns | |
---|---|
|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Gibt den Aufrufkontext des Moduls zurück, während es als Teil einer Suite ausgeführt wird.
Returns | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Gibt die Anzahl der Geräte zurück, die für die Aufrufe zugewiesen sind.
Returns | |
---|---|
int |
getSerials
public abstractgetSerials ()
Liste der Seriennummern des bei dieser Aufrufung erfassten Geräts zurückgeben
Returns | |
---|---|
|
getShardsSerials
public abstractgetShardsSerials ()
Gibt die Zuordnung aller erfassten Serien und ihrer Shards zurück, die am Sharding beteiligt sind. Leer, wenn es sich nicht um eine ge shardete Aufrufe handelt.
Returns | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Gibt das Test-Tag für die Aufrufe zurück.
Returns | |
---|---|
String |
markReleasedEarly
public abstract void markReleasedEarly ()
Markieren Sie die Geräte, die vorzeitig veröffentlicht werden.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Legt den Descriptor für die Testkonfiguration fest, über die die Aufrufe gestartet wurden.
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)
Hiermit wird das Test-Tag für die Aufrufe festgelegt.
Parameter | |
---|---|
testTag |
String |
toProto
public abstract InvocationContext.Context toProto ()
Serialisieren Sie die Kontextinstanz in einen Protokollpuffer.
Returns | |
---|---|
InvocationContext.Context |
wasReleasedEarly
public abstract boolean wasReleasedEarly ()
Gibt an, ob die Geräte vorzeitig veröffentlicht wurden und nicht mehr verwendet werden.
Returns | |
---|---|
boolean |