IInvocationContext
public
interface
IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Enthält Informationen zum Aufruf für die Tests, auf die bei Bedarf zugegriffen werden kann. Tests sollten nicht verändern Kontext, der hier enthalten ist, sodass nur Getter verfügbar sind, mit Ausnahme der Kontextattribute für die Berichterstellung.
Zusammenfassung
Konstanten | |
---|---|
String |
INVOCATION_ID
Schlüssel zum Speichern der zugehörigen Aufruf-ID. |
Öffentliche Methoden | |
---|---|
abstract
void
|
addAllocatedDevice(
Karte des Konfigurationsgerätenamens verfolgen, der mit einem |
abstract
void
|
addAllocatedDevice(String deviceName, ITestDevice testDevice)
Füge ein ITestDevice hinzu, das bei der Zuweisung des Geräts durch die Metadaten verfolgt werden soll. |
abstract
void
|
addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)
Fügen Sie eine |
abstract
void
|
addInvocationAttribute(String attributeName, String attributeValue)
Fügen Sie ein Invocation-Attribut hinzu. |
abstract
void
|
addInvocationAttributes(MultiMap<String, String> attributesMap)
Fügen Sie über |
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 als einem der Shards, die einige Tests ausführen, zugewiesen werden soll. |
default
String
|
getAttribute(String key)
Eine bequeme 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)
|
abstract
String
|
getBuildInfoName(IBuildInfo info)
Gibt den Namen des Gerätes zurück, das in der XML-Konfiguration aus dem |
abstract
|
getBuildInfos()
Gibt alle |
abstract
ConfigurationDescriptor
|
getConfigurationDescriptor()
Gibt den Deskriptor zurück, der mit der Testkonfiguration verknüpft ist, die den Aufruf gestartet hat |
abstract
ITestDevice
|
getDevice(String deviceName)
Gibt die |
abstract
|
getDeviceBuildMap()
Karte der Verknüpfung mit Geräte-/Build-Informationen zurückgeben |
abstract
ITestDevice
|
getDeviceBySerial(String serial)
Gibt das |
abstract
|
getDeviceConfigNames()
Liste der Gerätekonfigurationsnamen des in diesem Aufruf erfassten Geräts zurückgeben |
abstract
String
|
getDeviceName(ITestDevice device)
Gibt den Namen des Gerätesatzes in der XML-Konfiguration aus dem |
abstract
|
getDevices()
Gibt das gesamte zugewiesene Gerät zurück, das für diesen Aufruf erfasst wurde. |
abstract
String
|
getInvocationId()
|
default
|
getInvocationTimingMetrics()
Gibt die Karte zurück, die die Aufrufzeitmesswerte 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 erfassten Geräts zurück |
abstract
|
getShardsSerials()
Gibt die Karte aller nachverfolgten Seriennummern und deren Shard, die an der Fragmentierung beteiligt sind, zurück. |
abstract
String
|
getTestTag()
Gibt das Aufruftest-Tag zurück. |
abstract
void
|
markReleasedEarly()
Gibt an, dass die Geräte frühzeitig auf den Markt kommen. |
abstract
void
|
setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)
Legt den Deskriptor fest, der mit der Testkonfiguration verknüpft 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 die |
abstract
void
|
setTestTag(String testTag)
Legt das Aufruftest-Tag fest. |
abstract
InvocationContext.Context
|
toProto()
Serialisiert die Kontextinstanz in einen protobuf. |
abstract
boolean
|
wasReleasedEarly()
Gibt an, ob Geräte früher veröffentlicht wurden und nicht mehr verwendet werden. |
Konstanten
INVOCATION_ID (INVOCATION_ID)
public static final String INVOCATION_ID
Schlüssel zum Speichern der zugehörigen Aufruf-ID.
Konstantenwert: „invocation-id“
Öffentliche Methoden
AddAlAssignedDevice (Gerät zuweisen)
public abstract void addAllocatedDevice (deviceWithName)
Karte des Konfigurationsgerätenamens verfolgen, der mit einem ITestDevice
verknüpft ist. Nicht löschbar
vorherigen Tracking-Zeitraums.
Parameter | |
---|---|
deviceWithName |
: die ERROR(/Map) des zusätzlichen Geräts, das erfasst werden soll |
AddAlAssignedDevice (Gerät zuweisen)
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Füge ein ITestDevice hinzu, das bei der Zuweisung des Geräts durch die Metadaten verfolgt werden soll. setzt die Build-Informationen in der Karte auf null.
Parameter | |
---|---|
deviceName |
String : Name der Gerätekonfiguration, die mit ITestDevice verknüpft werden soll |
testDevice |
ITestDevice : wird den zugewiesenen Geräten hinzugefügt. |
addDeviceBuildInfo
public abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
Fügen Sie eine IBuildInfo
hinzu, die mit dem Namen der Gerätekonfiguration verfolgt werden soll.
Parameter | |
---|---|
deviceName |
String : der Name der Gerätekonfiguration |
buildinfo |
IBuildInfo : Eine IBuildInfo , die dem Gerätekonfigurationsnamen zugeordnet ist. |
addInvocationAttribute (Attribut „AddInvocation“)
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Fügen Sie ein Invocation-Attribut hinzu.
Parameter | |
---|---|
attributeName |
String |
attributeValue |
String |
addInvocationAttributes
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Fügen Sie über UniqueMultiMap
mehrere Aufrufattribute gleichzeitig hinzu.
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 als einem der Shards, die einige Tests ausführen, zugewiesen werden soll.
Parameter | |
---|---|
index |
Integer : Index des Shards unter Verwendung der Seriennummern |
serials |
: Die Liste der Seriennummern, die verfolgt werden sollen. |
getAttribute
public String getAttribute (String key)
Eine praktische Methode zum Abrufen des Aufrufkontextattributs als einzelnes Schlüssel/Wert-Paar. Gibt niemals null zurück.
Parameter | |
---|---|
key |
String |
Returns | |
---|---|
String |
Leerer String, 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.
Returns | |
---|---|
MultiMap<String, String> |
getBuildInfo
public abstract IBuildInfo getBuildInfo (String deviceName)
Gibt die IBuildInfo
zurück, die dem angegebenen Gerätekonfigurationsnamen zugeordnet ist. Rückgaben
null, wenn der deviceName nicht zugeordnet werden kann.
Parameter | |
---|---|
deviceName |
String |
Returns | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
IBuildInfo
zurückgeben, die mit ITestDevice
verknüpft ist
Parameter | |
---|---|
testDevice |
ITestDevice |
Returns | |
---|---|
IBuildInfo |
GetBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Gibt den Namen des Gerätes zurück, das in der XML-Konfiguration aus dem IBuildInfo
festgelegt ist. Rückgaben
null, wenn die IBuildInfo nicht abgeglichen werden kann.
Parameter | |
---|---|
info |
IBuildInfo |
Returns | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Gibt alle IBuildInfo
zurück, die für diesen Aufruf erfasst wurden.
Returns | |
---|---|
|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Gibt den Deskriptor zurück, der mit der Testkonfiguration verknüpft ist, die den Aufruf gestartet hat
Returns | |
---|---|
ConfigurationDescriptor |
getDevice
public abstract ITestDevice getDevice (String deviceName)
Gibt die ITestDevice
zurück, die dem angegebenen Gerätekonfigurationsnamen zugeordnet ist.
Parameter | |
---|---|
deviceName |
String |
Returns | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Karte der Verknüpfung mit Geräte-/Build-Informationen zurückgeben
Returns | |
---|---|
|
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 |
Returns | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Liste der Gerätekonfigurationsnamen des in diesem Aufruf erfassten Geräts zurückgeben
Returns | |
---|---|
|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Gibt den Namen des Gerätesatzes in der XML-Konfiguration aus dem ITestDevice
zurück.
Gibt null zurück, wenn ITestDevice nicht zugeordnet werden kann.
Parameter | |
---|---|
device |
ITestDevice |
Returns | |
---|---|
String |
getGeräte
public abstractgetDevices ()
Gibt das gesamte zugewiesene Gerät zurück, das für diesen Aufruf erfasst wurde.
Returns | |
---|---|
|
getInvocationId (Abruf-ID)
public abstract String getInvocationId ()
Returns | |
---|---|
String |
zugehörige Aufruf-ID oder null , wenn nicht mit einem Aufruf verknüpft |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Gibt die Karte zurück, die die Aufrufzeitmesswerte enthält.
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 |
getNumDevicesAllocation
public abstract int getNumDevicesAllocated ()
Gibt die Anzahl der für den Aufruf zugewiesenen Geräte zurück.
Returns | |
---|---|
int |
getSerials
public abstractgetSerials ()
Gibt die Liste der Seriennummern des in diesem Aufruf erfassten Geräts zurück
Returns | |
---|---|
|
getShardsSerials
public abstractgetShardsSerials ()
Gibt die Karte aller nachverfolgten Seriennummern und deren Shard, die an der Fragmentierung beteiligt sind, zurück. Leer, wenn kein fragmentierten Aufruf.
Returns | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Gibt das Aufruftest-Tag zurück.
Returns | |
---|---|
String |
MarkierungFrühzeitig freigegeben
public abstract void markReleasedEarly ()
Gibt an, dass die Geräte frühzeitig auf den Markt kommen.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Legt den Deskriptor fest, der mit der Testkonfiguration verknüpft 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 |
Wiederherstellungsmodus fürAlleGeräte festlegen
public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
Legt die RecoveryMode
aller Geräte im Kontext fest
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 ()
Serialisiert die Kontextinstanz in einen protobuf.
Returns | |
---|---|
InvocationContext.Context |
wasFrühzeitig veröffentlicht
public abstract boolean wasReleasedEarly ()
Gibt an, ob Geräte früher veröffentlicht wurden und nicht mehr verwendet werden.
Returns | |
---|---|
boolean |