IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Znane podklasy pośrednie InvocationContext InvocationContext Ogólna implementacja IInvocationContext.

---

Zawiera informacje o wywołaniu, aby umożliwić dostęp do testów w razie potrzeby. Testy nie powinny modyfikować zawartego tutaj kontekstu, więc dostępne będą tylko metody getter, z wyjątkiem atrybutów kontekstu do celów raportowania.

Podsumowanie

Stałe
String	INVOCATION_ID Klucz używany do przechowywania powiązanego identyfikatora wywołania.

Metody publiczne
abstract void	addAllocatedDevice( deviceWithName) Śledzenie mapy nazwy urządzenia konfiguracyjnego powiązanego z ITestDevice.
abstract void	addAllocatedDevice(String deviceName, ITestDevice testDevice) Dodaj ITestDevice, aby metadane mogły śledzić urządzenie po jego przydzieleniu.
abstract void	addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo) Dodaj IBuildInfo, który będzie śledzony 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 jednocześnie za pomocą UniqueMultiMap.
default void	addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis) Dodaj dane o czasie wywołania.
abstract void	addSerialsFromShard(Integer index, serials) Dodaj numer seryjny, który ma być śledzony jako przypisany do jednego z fragmentów, na których przeprowadzane są testy.
default String	getAttribute(String key) Wygodna metoda umożliwiająca pobieranie 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) Zwraca IBuildInfo powiązany z podaną nazwą konfiguracji urządzenia.
abstract IBuildInfo	getBuildInfo(ITestDevice testDevice) Zwraca IBuildInfo powiązany z ITestDevice
abstract String	getBuildInfoName(IBuildInfo info) Zwraca nazwę zestawu urządzeń w konfiguracji XML z IBuildInfo.
abstract	getBuildInfos() Zwraca wszystkie IBuildInfo śledzone w przypadku tego wywołania.
abstract ConfigurationDescriptor	getConfigurationDescriptor() Zwraca opis powiązany z konfiguracją testową, która uruchomiła wywołanie.
abstract ITestDevice	getDevice(String deviceName) Zwraca ITestDevice powiązany z podaną nazwą konfiguracji urządzenia.
abstract	getDeviceBuildMap() Zwraca mapę powiązań informacji o urządzeniu/kompilacji
abstract ITestDevice	getDeviceBySerial(String serial) Zwraca ITestDevice powiązany z podanym numerem seryjnym.
abstract	getDeviceConfigNames() Zwraca listę nazw konfiguracji urządzenia śledzonego w tym wywołaniu.
abstract String	getDeviceName(ITestDevice device) Zwraca nazwę zestawu urządzeń w konfiguracji XML z ITestDevice.
abstract	getDevices() Zwraca wszystkie przypisane urządzenia śledzone w przywołaniu.
abstract String	getInvocationId()
default	getInvocationTimingMetrics() Zwraca mapę zawierającą dane o czasie wywołania.
abstract IInvocationContext	getModuleInvocationContext() Zwraca kontekst wywołania modułu podczas jego wykonywania w ramach zestawu.
abstract int	getNumDevicesAllocated() Zwraca liczbę urządzeń przypisanych do wywołania.
abstract	getSerials() Zwraca listę numerów seryjnych urządzenia śledzonego w ramach tego wywołania.
abstract	getShardsSerials() Zwraca mapę wszystkich śledzonych seriali i ich fragmentów uczestniczących w dzieleniu.
abstract String	getTestTag() Zwraca tag testowy wywołania.
abstract void	markReleasedEarly() Oznacz urządzenia, które są wczesniej udostępniane.
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 w ramach pakietu.
abstract void	setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode) Ustawia RecoveryMode wszystkich urządzeń, które są częścią kontekstu.
abstract void	setTestTag(String testTag) Ustawia tag testowy wywołania.
abstract InvocationContext.Context	toProto() Serializuj instancję kontekstu w formacie protobuf.
abstract boolean	wasReleasedEarly() Zwraca informacje o tym, czy urządzenia zostały wcześniej wydane i czy 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.

Wartość stała: "invocation-id"

Metody publiczne

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

Śledzenie mapy nazwy urządzenia konfiguracyjnego powiązanego z ITestDevice. Nie czyści poprzedniego śledzenia przed dodaniem.

Parametry
deviceWithName	: ERROR(/Map) dodatkowego urządzenia do śledzenia

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Dodaj ITestDevice, aby metadane mogły śledzić urządzenie po jego przydzieleniu. ustawi na mapie informacje o kompilacji na null.

Parametry
deviceName	String: nazwa konfiguracji urządzenia do powiązania z ITestDevice
testDevice	ITestDevice: dodanie do przypisanych urządzeń.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Dodaj IBuildInfo, który będzie śledzony za pomocą nazwy konfiguracji urządzenia.

Parametry
deviceName	String: nazwa konfiguracji urządzenia
buildinfo	IBuildInfo: IBuildInfo powiązany z nazwą konfiguracji urządzenia.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut wywołania.

Parametry
attributeName	String
attributeValue	String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Dodaj kilka atrybutów wywołania jednocześnie za pomocą UniqueMultiMap.

Parametry
attributesMap	MultiMap

addInvocationTimingMetric

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

Dodaj dane o czasie 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, na których przeprowadzane są testy.

Parametry
index	Integer: indeks fragmentu, który używa numerów seryjnych
serials	: lista seriali do śledzenia.

getAttribute

public String getAttribute (String key)

Wygodna metoda umożliwiająca pobieranie atrybutu kontekstu wywołania jako pojedynczej pary klucz-wartość. Nigdy nie zwracaj wartości null.

Parametry
key	String

Zwroty
String	pusty ciąg znaków, gdy klucz nie istnieje, a w przeciwnym razie wartość.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Zwraca kopię mapy zawierającą wszystkie atrybuty wywołania.

Zwroty
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Zwraca IBuildInfo powiązany z podaną nazwą konfiguracji urządzenia. Zwraca wartość null, jeśli nie można dopasować nazwy urządzenia.

Parametry
deviceName	String

Zwroty
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Zwraca IBuildInfo powiązany z ITestDevice

Parametry
testDevice	ITestDevice

Zwroty
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Zwraca nazwę zestawu urządzeń w konfiguracji XML z IBuildInfo. Zwraca wartość null, jeśli nie można dopasować obiektu IBuildInfo.

Parametry
info	IBuildInfo

Zwroty
String

getBuildInfos

public abstract  getBuildInfos ()

Zwraca wszystkie IBuildInfo śledzone w przypadku tego wywołania.

Zwroty

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Zwroty
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Zwraca ITestDevice powiązany z podaną nazwą konfiguracji urządzenia.

Parametry
deviceName	String

Zwroty
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Zwraca mapę powiązań informacji o urządzeniu/kompilacji

Zwroty

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Zwraca ITestDevice powiązany z podanym numerem seryjnym. Nie używaj zbyt często tego operatora, ponieważ nie jest to najszybsze rozwiązanie.

Parametry
serial	String

Zwroty
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Zwraca listę nazw konfiguracji urządzenia śledzonego w tym wywołaniu.

Zwroty

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Zwraca nazwę zestawu urządzeń w konfiguracji XML z ITestDevice. Zwraca wartość null, jeśli nie można dopasować ITestDevice.

Parametry
device	ITestDevice

Zwroty
String

getDevices

public abstract  getDevices ()

Zwraca wszystkie przypisane urządzenia śledzone w przywołaniu.

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

public  getInvocationTimingMetrics ()

Zwraca mapę zawierającą dane o czasie wywołania.

Zwroty

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Zwraca kontekst wywołania modułu podczas jego wykonywania w ramach zestawu.

Zwroty
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Zwraca liczbę urządzeń przypisanych do wywołania.

Zwroty
int

getSerials

public abstract  getSerials ()

Zwraca listę numerów seryjnych urządzenia śledzonego w ramach tego wywołania.

Zwroty

getShardsSerials

public abstract  getShardsSerials ()

Zwraca mapę wszystkich śledzonych seriali i ich fragmentów uczestniczących w dzieleniu. Pusty, jeśli nie jest to wywołanie z użyciem fragmentacji.

Zwroty

getTestTag

public abstract String getTestTag ()

Zwraca tag testowy wywołania.

Zwroty
String

markReleasedEarly

public abstract void markReleasedEarly ()

Oznacz urządzenia, które są wczesniej udostępniane.

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 w ramach pakietu.

Parametry
invocationContext	IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Ustawia RecoveryMode wszystkich urządzeń, które są częścią kontekstu.

Parametry
mode	ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Ustawia tag testowy wywołania.

Parametry
testTag	String

toProto

public abstract InvocationContext.Context toProto ()

Serializuj instancję kontekstu w formacie protobuf.

Zwroty
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Zwraca informacje o tym, czy urządzenia zostały wcześniej wydane i czy nie będą już używane.

Zwroty
boolean