Kontekst wywołania
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Przechowuje informacje o Inwokacji, aby testy mogły uzyskać do nich dostęp w razie potrzeby. Testy nie powinny modyfikować zawartego tutaj kontekstu, więc 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 skojarzonego z |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Dodaj ITestDevice do śledzenia przez metadane podczas przydzielania urządzenia. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Dodaj |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) Dodaj atrybut Inwokacja. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Dodaj kilka atrybutów inwokacji jednocześnie 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, w których przeprowadzane są niektóre testy. |
default String | getAttribute (String key) Wygodna metoda pobierania atrybutu kontekstu wywołania jako 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 ustawionego w konfiguracji xml z |
abstract | getBuildInfos () Zwróć wszystkie |
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ę skojarzenia 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 ustawionego 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 wykonywania w ramach zestawu. |
abstract int | getNumDevicesAllocated () Zwróć 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 zaangażowanych w sharding. |
abstract String | getTestTag () Zwraca znacznik testowy wywołania. |
abstract void | markReleasedEarly () Zaznacz, że urządzenia zostaną wypuszczone wcześniej. |
abstract void | setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) Ustawia deskryptor skojarzony z konfiguracją testu, która uruchomiła wywołanie |
abstract void | setModuleInvocationContext ( IInvocationContext invocationContext) Ustawia kontekst wywołania modułu podczas wykonywania w ramach pakietu. |
abstract void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) Ustawia |
abstract void | setTestTag (String testTag) Ustawia znacznik testowy wywołania. |
abstract InvocationContext.Context | toProto () Serializacja instancji kontekstu do protobuf. |
abstract boolean | wasReleasedEarly () Zwraca informację, czy urządzenia zostały wydane wcześniej i nie będą już używane. |
Stałe
INVOCATION_ID
public static final String INVOCATION_ID
Klucz używany do przechowywania powiązanego identyfikatora wywołania.
Stała wartość: „identyfikator wywołania”
Metody publiczne
dodajPrzydzieloneUrządzenie
public abstract void addAllocatedDevice (deviceWithName)
Śledź mapę nazwy urządzenia konfiguracyjnego skojarzonego z ITestDevice
. Nie usuwa poprzedniego śledzenia przed dodaniem.
Parametry | |
---|---|
deviceWithName | ERROR(/Map) dodatkowego urządzenia do śledzenia |
dodajPrzydzieloneUrządzenie
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Dodaj ITestDevice do śledzenia przez metadane podczas przydzielania urządzenia. ustawi informacje o kompilacji na null na mapie.
Parametry | |
---|---|
deviceName | String : nazwa konfiguracji urządzenia do skojarzenia z ITestDevice |
testDevice | ITestDevice : do dodania do przydzielonych urządzeń. |
dodaj informacje o kompilacji urządzenia
public abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
Dodaj IBuildInfo
do śledzenia za pomocą nazwy konfiguracji urządzenia.
Parametry | |
---|---|
deviceName | String : nazwa konfiguracji urządzenia |
buildinfo | IBuildInfo : IBuildInfo powiązany z nazwą konfiguracji urządzenia. |
addInvocationAtrybut
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Dodaj atrybut Inwokacja.
Parametry | |
---|---|
attributeName | String |
attributeValue | String |
dodaj atrybuty wywołania
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Dodaj kilka atrybutów inwokacji jednocześnie 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 |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Dodaj numer seryjny, który ma być śledzony, jako przypisany do jednego z fragmentów, w których przeprowadzane są niektóre testy.
Parametry | |
---|---|
index | Integer : indeks odłamka przy użyciu seriali |
serials |
pobierz atrybut
public String getAttribute (String key)
Wygodna metoda pobierania atrybutu kontekstu wywołania jako pojedynczej pary klucz-wartość. Nigdy nie zwracaj wartości null.
Parametry | |
---|---|
key | String |
Zwroty | |
---|---|
String | pusty ciąg, gdy klucz nie istnieje, wartość w przeciwnym razie. |
pobierz atrybuty
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
skojarzony 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
skojarzony z ITestDevice
Parametry | |
---|---|
testDevice | ITestDevice |
Zwroty | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Zwraca nazwę urządzenia ustawionego w konfiguracji xml z IBuildInfo
. Zwraca null, jeśli nie można dopasować IBuildInfo
Parametry | |
---|---|
info | IBuildInfo |
Zwroty | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Zwróć wszystkie 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 |
pobierzUrządzenie
public abstract ITestDevice getDevice (String deviceName)
Zwróć ITestDevice
powiązany z podaną nazwą konfiguracji urządzenia.
Parametry | |
---|---|
deviceName | String |
Zwroty | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Zwróć mapę skojarzenia informacji o urządzeniu/kompilacji
Zwroty | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Zwraca ITestDevice
skojarzony z podanym numerem seryjnym. Powstrzymaj się od używania zbyt wielu, ponieważ nie jest to najszybsze wyszukiwanie.
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
ITestDevice |
getDeviceConfigNames
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 ustawionego w konfiguracji xml z ITestDevice
. Zwraca null, jeśli nie można dopasować ITestDevice.
Parametry | |
---|---|
device | ITestDevice |
Zwroty | |
---|---|
String |
pobierzUrządzenia
public abstractgetDevices ()
Zwróć wszystkie przydzielone urządzenia śledzone dla tego wywołania.
Zwroty | |
---|---|
getInvocationId
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 wykonywania w ramach pakietu.
Zwroty | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Zwróć liczbę urządzeń przydzielonych do wywołania.
Zwroty | |
---|---|
int |
getSerials
public abstractgetSerials ()
Zwróć listę numerów seryjnych urządzenia śledzonego w tym wywołaniu
Zwroty | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Zwraca mapę wszystkich śledzonych seriali i ich fragmentów zaangażowanych w sharding. Puste, jeśli nie fragmentaryczne wywołanie.
Zwroty | |
---|---|
pobierzTestTag
public abstract String getTestTag ()
Zwraca znacznik testowy wywołania.
Zwroty | |
---|---|
String |
markWcześnie wydany
public abstract void markReleasedEarly ()
Zaznacz, że urządzenia zostaną wypuszczone wcześniej.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Ustawia deskryptor skojarzony z konfiguracją testu, która uruchomiła wywołanie
Parametry | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Ustawia kontekst wywołania modułu podczas wykonywania w ramach pakietu.
Parametry | |
---|---|
invocationContext | IInvocationContext |
ustaw tryb odzyskiwania dla wszystkich urządzeń
public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
Ustawia RecoveryMode
wszystkich urządzeń będących częścią kontekstu
Parametry | |
---|---|
mode | ITestDevice.RecoveryMode |
ustaw znacznik testowy
public abstract void setTestTag (String testTag)
Ustawia znacznik testowy wywołania.
Parametry | |
---|---|
testTag | String |
doProto
public abstract InvocationContext.Context toProto ()
Serializacja instancji kontekstu do protobuf.
Zwroty | |
---|---|
InvocationContext.Context |
został wydany wcześnie
public abstract boolean wasReleasedEarly ()
Zwraca informację, czy urządzenia zostały wydane wcześniej i nie będą już używane.
Zwroty | |
---|---|
boolean |