IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

Zawiera informacje o wywołaniu, do których testy mogą w razie potrzeby uzyskać dostęp. Testy nie powinny modyfikować kontekstu zawartego w tym miejscu, więc dostępne będą tylko metody pobierające, z wyjątkiem atrybutów kontekstu na potrzeby raportowania.

Podsumowanie

Stałe

String INVOCATION_ID

Klucz używany do przechowywania powiązanego identyfikatora wywołania.

Metody publiczne

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

Śledź mapę nazw urządzeń konfiguracji powiązanych z ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Dodaj ITestDevice, który będzie śledzony przez metadane po przydzieleniu urządzenia.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Dodaj IBuildInfo, aby śledzić nazwę konfiguracji urządzenia.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Dodaj atrybut Invocation.

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

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

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

Dodaj dane dotyczące czasu wywołania.

abstract void addSerialsFromShard(Integer index, List<String> serials)

Dodaj numer seryjny, który ma być śledzony jako przypisany do jednego z fragmentów uruchamiających 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óć IBuildInfo powiązany z podaną nazwą konfiguracji urządzenia.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Zwróć wartość IBuildInfo powiązaną z wartością ITestDevice.

abstract String getBuildInfoName(IBuildInfo info)

Zwraca nazwę zestawu urządzeń w konfiguracji XML z IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

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

abstract ConfigurationDescriptor getConfigurationDescriptor()

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

abstract ITestDevice getDevice(String deviceName)

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

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

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

abstract ITestDevice getDeviceBySerial(String serial)

Zwraca ITestDevice powiązany z podanym numerem seryjnym.

abstract List<String> getDeviceConfigNames()

Zwraca listę nazw konfiguracji urządzeń śledzonych w tym wywołaniu.

abstract String getDeviceName(ITestDevice device)

Zwraca nazwę zestawu urządzeń w konfiguracji XML z ITestDevice.

abstract List<ITestDevice> getDevices()

Zwraca wszystkie przydzielone urządzenia śledzone w ramach tego wywołania.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

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

abstract IInvocationContext getModuleInvocationContext()

Zwraca kontekst wywołania modułu podczas wykonywania go w ramach pakietu.

abstract int getNumDevicesAllocated()

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

abstract List<String> getSerials()

Zwraca listę numerów seryjnych urządzenia śledzonego w tym wywołaniu.

abstract Map<Integer, List<String>> getShardsSerials()

Zwraca mapę wszystkich śledzonych numerów seryjnych i ich fragmentów biorących udział w dzieleniu.

abstract String getTestTag()

Zwraca tag testowy wywołania.

abstract void markReleasedEarly()

Oznacz, że urządzenia zostaną udostępnione wcześniej.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Ustawia deskryptor powiązany z konfiguracją testu, która uruchomiła wywołanie.

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Ustawia kontekst wywołania modułu podczas wykonywania go w ramach pakietu.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Ustawia RecoveryMode wszystkich urządzeń w kontekście.

abstract void setTestTag(String testTag)

Ustawia tag testowy wywołania.

abstract InvocationContext.Context toProto()

Serializuj instancję kontekstu do protokołu protobuf.

abstract boolean wasReleasedEarly()

Zwraca informację, czy urządzenia zostały wcześniej wycofane 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.

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

Metody publiczne

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Śledź mapę nazw urządzeń konfiguracji powiązanych z ITestDevice. Nie usuwa poprzedniego śledzenia przed dodaniem.

Parametry
deviceWithName Map: Map dodatkowego urządzenia do śledzenia

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Dodaj ITestDevice, który będzie śledzony przez metadane po przydzieleniu urządzenia. ustawi w mapie informacje o kompilacji na wartość null.

Parametry
deviceName String: nazwa konfiguracji urządzenia, która ma być powiązana z ITestDevice
testDevice ITestDevice: do dodania na przydzielonych urządzeniach.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Dodaj IBuildInfo, aby śledzić nazwę 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 Invocation.

Parametry
attributeName String

attributeValue String

addInvocationAttributes

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

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

Parametry
attributesMap MultiMap

addInvocationTimingMetric

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

Dodaj dane dotyczące czasu wywołania.

Parametry
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

Dodaj numer seryjny, który ma być śledzony jako przypisany do jednego z fragmentów uruchamiających testy.

Parametry
index Integer: indeks fragmentu używającego numerów seryjnych.
serials List: lista numerów seryjnych, które mają być śledzone.

getAttribute

public String getAttribute (String key)

Wygodna metoda pobierania atrybutu kontekstu wywołania jako pojedynczej pary klucz-wartość. Nigdy nie zwraca wartości null.

Parametry
key String

Zwraca
String pusty ciąg znaków, jeśli klucz nie istnieje, w przeciwnym razie wartość.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

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

Zwraca
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

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

Parametry
deviceName String

Zwraca
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Zwróć wartość IBuildInfo powiązaną z wartością ITestDevice.

Parametry
testDevice ITestDevice

Zwraca
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ć IBuildInfo

Parametry
info IBuildInfo

Zwraca
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

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

Zwraca
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Zwraca
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

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

Parametry
deviceName String

Zwraca
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

Zwraca
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Zwraca ITestDevice powiązany z podanym numerem seryjnym. Nie używaj zbyt wielu, ponieważ nie jest to najszybsze wyszukiwanie.

Parametry
serial String

Zwraca
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Zwraca listę nazw konfiguracji urządzeń śledzonych w tym wywołaniu.

Zwraca
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

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

Parametry
device ITestDevice

Zwraca
String

getDevices

public abstract List<ITestDevice> getDevices ()

Zwraca wszystkie przydzielone urządzenia śledzone w ramach tego wywołania.

Zwraca
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

Zwraca
String powiązany identyfikator wywołania lub null, jeśli nie jest połączony z wywołaniem;

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

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

Zwraca
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Zwraca kontekst wywołania modułu podczas wykonywania go w ramach pakietu.

Zwraca
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

Zwraca
int

getSerials

public abstract List<String> getSerials ()

Zwraca listę numerów seryjnych urządzenia śledzonego w tym wywołaniu.

Zwraca
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Zwraca mapę wszystkich śledzonych numerów seryjnych i ich fragmentów biorących udział w dzieleniu. Puste, jeśli nie jest to wywołanie z podziałem na fragmenty.

Zwraca
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Zwraca tag testowy wywołania.

Zwraca
String

markReleasedEarly

public abstract void markReleasedEarly ()

Oznacz, że urządzenia zostaną udostępnione wcześniej.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Ustawia deskryptor powiązany 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 go w ramach pakietu.

Parametry
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Ustawia RecoveryMode wszystkich urządzeń w kontekście.

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 do protokołu protobuf.

Zwraca
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Zwraca informację, czy urządzenia zostały wcześniej wycofane i nie będą już używane.

Zwraca
boolean