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

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 IBuildInfo , które ma być śledzone za pomocą nazwy konfiguracji urządzenia.

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ą UniqueMultiMap .

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óć IBuildInfo skojarzone z podaną nazwą konfiguracji urządzenia.

abstract IBuildInfo getBuildInfo ( ITestDevice testDevice)

Zwróć IBuildInfo skojarzone z ITestDevice

abstract String getBuildInfoName ( IBuildInfo info)

Zwraca nazwę urządzenia ustawioną w konfiguracji XML z IBuildInfo .

abstract getBuildInfos ()

Zwróć wszystkie informacje IBuildInfo śledzone dla tego wywołania.

abstract ConfigurationDescriptor getConfigurationDescriptor ()

Zwraca deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie

abstract ITestDevice getDevice (String deviceName)

Zwróć ITestDevice skojarzone z podaną nazwą konfiguracji urządzenia.

abstract getDeviceBuildMap ()

Zwróć mapę powiązania informacji o urządzeniu/kompilacji

abstract ITestDevice getDeviceBySerial (String serial)

Zwraca ITestDevice powiązany z podanym numerem seryjnym.

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

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 RecoveryMode wszystkich urządzeń w kontekście

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 : Lista seriali, które mają być śledzone.

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

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

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

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

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

public  getInvocationTimingMetrics ()

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

Zwróć listę numerów seryjnych urządzenia śledzonego w tym wywołaniu

Zwroty

pobierzShardsSerials

public abstract  getShardsSerials ()

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