Kontekst wywołania
public interface IInvocationContext
com.android.tradefed.invoker.IIInvocationContext |
Przechowuje informacje o wywołaniu, do których w razie potrzeby można uzyskać dostęp do testów. Testy nie powinny modyfikować zawartego tutaj kontekstu, dlatego dostępne będą tylko moduły pobierające, z wyjątkiem atrybutów kontekstu do celów raportowania.
Streszczenie
Stałe | |
---|---|
String | INVOCATION_ID Klucz używany do przechowywania powiązanego identyfikatora wywołania. |
Metody publiczne | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Śledź mapę nazwy urządzenia konfiguracyjnego powiązanego z |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Dodaj urządzenie ITestDevice, które ma być śledzone przez metadane po przydzieleniu urządzenia. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Dodaj |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) Dodaj atrybut wywołania. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Dodaj kilka atrybutów wywołania na raz za pomocą |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) Dodaj metrykę czasu wywołania. |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) Dodaj numer seryjny, który ma być śledzony, jako przypisany do jednego z fragmentów uruchamiających niektóre testy. |
default String | getAttribute (String key) Wygodna metoda pobierania atrybutu kontekstu wywołania w postaci pojedynczej pary klucz-wartość. |
abstract MultiMap <String, String> | getAttributes () Zwraca kopię mapy zawierającą wszystkie atrybuty wywołania. |
abstract IBuildInfo | getBuildInfo (String deviceName) Zwróć |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Zwróć |
abstract String | getBuildInfoName ( IBuildInfo info) Zwraca nazwę urządzenia ustawioną w konfiguracji XML z |
abstract | getBuildInfos () Zwróć wszystkie informacje |
abstract ConfigurationDescriptor | getConfigurationDescriptor () Zwraca deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie |
abstract ITestDevice | getDevice (String deviceName) Zwróć |
abstract | getDeviceBuildMap () Zwróć mapę powiązania informacji o urządzeniu/kompilacji |
abstract ITestDevice | getDeviceBySerial (String serial) Zwraca |
abstract | getDeviceConfigNames () Zwróć listę nazw konfiguracji urządzeń śledzonych w tym wywołaniu |
abstract String | getDeviceName ( ITestDevice device) Zwraca nazwę urządzenia ustawioną w konfiguracji XML z |
abstract | getDevices () Zwróć wszystkie przydzielone urządzenia śledzone dla tego wywołania. |
abstract String | getInvocationId () |
default | getInvocationTimingMetrics () Zwraca mapę zawierającą metryki czasu wywołania. |
abstract IInvocationContext | getModuleInvocationContext () Zwraca kontekst wywołania modułu podczas jego wykonywania jako część pakietu. |
abstract int | getNumDevicesAllocated () Zwraca liczbę urządzeń przydzielonych do wywołania. |
abstract | getSerials () Zwróć listę numerów seryjnych urządzenia śledzonego w tym wywołaniu |
abstract | getShardsSerials () Zwraca mapę wszystkich śledzonych seriali i ich fragmentów objętych fragmentowaniem. |
abstract String | getTestTag () Zwraca tag testowy wywołania. |
abstract void | markReleasedEarly () Zaznacz, że urządzenia zostaną wydane wcześniej. |
abstract void | setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) Ustawia deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie |
abstract void | setModuleInvocationContext ( IInvocationContext invocationContext) Ustawia kontekst wywołania modułu podczas jego wykonywania jako część pakietu. |
abstract void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) Ustawia |
abstract void | setTestTag (String testTag) Ustawia znacznik testowy wywołania. |
abstract InvocationContext.Context | toProto () Serializuj instancję kontekstu do protobufa. |
abstract boolean | wasReleasedEarly () Zwraca informację, czy urządzenia zostały wcześniej wydane i nie będą już używane. |
Stałe
INWOKACJA_ID
public static final String INVOCATION_ID
Klucz używany do przechowywania powiązanego identyfikatora wywołania.
Wartość stała: „id-inwokacji”
Metody publiczne
dodaj przydzielone urządzenie
public abstract void addAllocatedDevice (deviceWithName)
Śledź mapę nazwy urządzenia konfiguracyjnego powiązanego z ITestDevice
. Nie usuwa poprzedniego śledzenia przed dodaniem.
Parametry | |
---|---|
deviceWithName | ERROR(/Map) dodatkowego urządzenia do śledzenia |
dodaj przydzielone urządzenie
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Dodaj urządzenie ITestDevice, które ma być śledzone przez metadane po przydzieleniu urządzenia. ustawi informacje o kompilacji na wartość null na mapie.
Parametry | |
---|---|
deviceName | String : nazwa konfiguracji urządzenia, która ma zostać powiązana z ITestDevice |
testDevice | ITestDevice : do dodania do przydzielonych urządzeń. |
dodaj informacje o budowie urządzenia
public abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
Dodaj IBuildInfo
, które ma być śledzone za pomocą nazwy konfiguracji urządzenia.
Parametry | |
---|---|
deviceName | String : nazwa konfiguracji urządzenia |
buildinfo | IBuildInfo : IBuildInfo powiązany z nazwą konfiguracji urządzenia. |
dodaj atrybut wywołania
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Dodaj atrybut wywołania.
Parametry | |
---|---|
attributeName | String |
attributeValue | String |
dodaj atrybuty wywołania
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Dodaj kilka atrybutów wywołania na raz za pomocą UniqueMultiMap
.
Parametry | |
---|---|
attributesMap | MultiMap |
addInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Dodaj metrykę czasu wywołania.
Parametry | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
dodajSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Dodaj numer seryjny, który ma być śledzony, jako przypisany do jednego z fragmentów uruchamiających niektóre testy.
Parametry | |
---|---|
index | Integer : indeks fragmentu wykorzystujący seriale |
serials |
pobierz atrybut
public String getAttribute (String key)
Wygodna metoda pobierania atrybutu kontekstu wywołania w postaci pojedynczej pary klucz-wartość. Nigdy nie zwracaj wartości null.
Parametry | |
---|---|
key | String |
Zwroty | |
---|---|
String | pusty ciąg, gdy klucz nie istnieje, w przeciwnym razie wartość. |
pobierzAtrybuty
public abstract MultiMap<String, String> getAttributes ()
Zwraca kopię mapy zawierającą wszystkie atrybuty wywołania.
Zwroty | |
---|---|
MultiMap <String, String> |
pobierz informacje o kompilacji
public abstract IBuildInfo getBuildInfo (String deviceName)
Zwróć IBuildInfo
skojarzone z podaną nazwą konfiguracji urządzenia. Zwraca wartość null, jeśli nie można dopasować nazwy urządzenia.
Parametry | |
---|---|
deviceName | String |
Zwroty | |
---|---|
IBuildInfo |
pobierz informacje o kompilacji
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Zwróć IBuildInfo
skojarzone z ITestDevice
Parametry | |
---|---|
testDevice | ITestDevice |
Zwroty | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Zwraca nazwę urządzenia ustawioną w konfiguracji XML z IBuildInfo
. Zwraca wartość null, jeśli nie można dopasować IBuildInfo
Parametry | |
---|---|
info | IBuildInfo |
Zwroty | |
---|---|
String |
pobierzBuildInfos
public abstractgetBuildInfos ()
Zwróć wszystkie informacje IBuildInfo
śledzone dla tego wywołania.
Zwroty | |
---|---|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Zwraca deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie
Zwroty | |
---|---|
ConfigurationDescriptor |
pobierz urządzenie
public abstract ITestDevice getDevice (String deviceName)
Zwróć ITestDevice
skojarzone z podaną nazwą konfiguracji urządzenia.
Parametry | |
---|---|
deviceName | String |
Zwroty | |
---|---|
ITestDevice |
pobierz mapę kompilacji urządzenia
public abstractgetDeviceBuildMap ()
Zwróć mapę powiązania informacji o urządzeniu/kompilacji
Zwroty | |
---|---|
pobierzDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Zwraca ITestDevice
powiązany z podanym numerem seryjnym. Unikaj używania zbyt dużej liczby znaków, ponieważ nie jest to najszybsze wyszukiwanie.
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
ITestDevice |
pobierz nazwę konfiguracji urządzenia
public abstractgetDeviceConfigNames ()
Zwróć listę nazw konfiguracji urządzeń śledzonych w tym wywołaniu
Zwroty | |
---|---|
pobierz nazwę urządzenia
public abstract String getDeviceName (ITestDevice device)
Zwraca nazwę urządzenia ustawioną w konfiguracji XML z ITestDevice
. Zwraca null, jeśli nie można dopasować ITestDevice.
Parametry | |
---|---|
device | ITestDevice |
Zwroty | |
---|---|
String |
pobierz urządzenia
public abstractgetDevices ()
Zwróć wszystkie przydzielone urządzenia śledzone dla tego wywołania.
Zwroty | |
---|---|
pobierzIdInwokacji
public abstract String getInvocationId ()
Zwroty | |
---|---|
String | powiązany identyfikator wywołania lub null , jeśli nie jest powiązany z wywołaniem |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Zwraca mapę zawierającą metryki czasu wywołania.
Zwroty | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Zwraca kontekst wywołania modułu podczas jego wykonywania jako część pakietu.
Zwroty | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Zwraca liczbę urządzeń przydzielonych do wywołania.
Zwroty | |
---|---|
int |
pobierz Seriale
public abstractgetSerials ()
Zwróć listę numerów seryjnych urządzenia śledzonego w tym wywołaniu
Zwroty | |
---|---|
pobierzShardsSerials
public abstractgetShardsSerials ()
Zwraca mapę wszystkich śledzonych seriali i ich fragmentów objętych fragmentowaniem. Puste, jeśli nie wywołanie podzielone na fragmenty.
Zwroty | |
---|---|
pobierzTestTag
public abstract String getTestTag ()
Zwraca tag testowy wywołania.
Zwroty | |
---|---|
String |
markReleasedEarly
public abstract void markReleasedEarly ()
Zaznacz, że urządzenia zostaną wydane wcześniej.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Ustawia deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie
Parametry | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Ustawia kontekst wywołania modułu podczas jego wykonywania jako część pakietu.
Parametry | |
---|---|
invocationContext | IInvocationContext |
setRecoveryModeForAllDevices
public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
Ustawia RecoveryMode
wszystkich urządzeń w kontekście
Parametry | |
---|---|
mode | ITestDevice.RecoveryMode |
ustawTestTag
public abstract void setTestTag (String testTag)
Ustawia znacznik testowy wywołania.
Parametry | |
---|---|
testTag | String |
doProto
public abstract InvocationContext.Context toProto ()
Serializuj instancję kontekstu do protobufa.
Zwroty | |
---|---|
InvocationContext.Context |
został wydany wcześnie
public abstract boolean wasReleasedEarly ()
Zwraca informację, czy urządzenia zostały wcześniej wydane i nie będą już używane.
Zwroty | |
---|---|
boolean |