IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.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