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( deviceWithName)

Eine Zuordnung des Namens des Konfigurationsgeräts zu einer ITestDevice erfassen

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 IBuildInfo hinzu, das mit dem Namen der Gerätekonfiguration erfasst werden soll.

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 UniqueMultiMap hinzufügen.

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

Fügen Sie einen Messwert für die Aufrufzeit hinzu.

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.

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 IBuildInfo zurück, der mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Gibt den IBuildInfo zurück, der mit dem ITestDevice verknüpft ist.

abstract String getBuildInfoName(IBuildInfo info)

Gibt den Namen der Gerätegruppe in der XML-Konfiguration von IBuildInfo zurück.

abstract getBuildInfos()

Gibt alle IBuildInfo zurück, die für diese Aufrufe erfasst wurden.

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 ITestDevice zurück, der mit dem angegebenen Namen der Gerätekonfiguration verknüpft ist.

abstract getDeviceBuildMap()

Die Zuordnungstabelle von Geräte-/Build-Informationen zurückgeben

abstract ITestDevice getDeviceBySerial(String serial)

Gibt die ITestDevice zurück, die mit der angegebenen Seriennummer verknüpft ist.

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 ITestDevice festgelegt ist.

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 RecoveryMode aller Geräte fest, die Teil des Kontexts sind

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 abstract  getBuildInfos ()

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 abstract  getDeviceBuildMap ()

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 abstract  getDeviceConfigNames ()

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 abstract  getDevices ()

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

public  getInvocationTimingMetrics ()

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 abstract  getSerials ()

Liste der Seriennummern des bei dieser Aufrufung erfassten Geräts zurückgeben

Returns

getShardsSerials

public abstract  getShardsSerials ()

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