Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

Ogólna implementacja IInvocationContext.

Podsumowanie

Konstruktory publiczne
`InvocationContext()` Tworzy `BuildInfo`, używając domyślnych wartości atrybutów.

Metody publiczne
`void`	`addAllocatedDevice( deviceWithName)` Śledzenie mapy nazwy urządzenia konfiguracyjnego powiązanego z `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Dodaj ITestDevice, aby metadane mogły śledzić urządzenie po jego przydzieleniu.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Dodaj `IBuildInfo`, który będzie śledzony za pomocą nazwy konfiguracji urządzenia.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Dodaj atrybut wywołania.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Dodaj kilka atrybutów wywołania jednocześnie za pomocą `UniqueMultiMap`.
`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.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Odwrotna operacja do `InvocationContext.toProto()`, aby przywrócić instancję.
`MultiMap<String, String>`	`getAttributes()` Zwraca kopię mapy zawierającą wszystkie atrybuty wywołania.
`IBuildInfo`	`getBuildInfo(String deviceName)` Zwraca `IBuildInfo` powiązany z podaną nazwą konfiguracji urządzenia.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Zwraca `IBuildInfo` powiązany z `ITestDevice`
`String`	`getBuildInfoName(IBuildInfo info)` Zwraca nazwę zestawu urządzeń w konfiguracji XML z `IBuildInfo`.
	`getBuildInfos()` Zwraca wszystkie `IBuildInfo` śledzone w przypadku tego wywołania.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Zwraca opis powiązany z konfiguracją testową, która uruchomiła wywołanie.
`ITestDevice`	`getDevice(String deviceName)` Zwraca `ITestDevice` powiązany z podaną nazwą konfiguracji urządzenia.
	`getDeviceBuildMap()` Zwraca mapę powiązań informacji o urządzeniu/kompilacji
`ITestDevice`	`getDeviceBySerial(String serial)` Zwraca `ITestDevice` powiązany z podanym numerem seryjnym.
	`getDeviceConfigNames()` Zwraca listę nazw konfiguracji urządzenia śledzonego w tym wywołaniu.
`String`	`getDeviceName(ITestDevice device)` Zwraca nazwę zestawu urządzeń w konfiguracji XML z `ITestDevice`.
	`getDevices()` Zwraca wszystkie przypisane urządzenia śledzone w przywołaniu.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Zwraca kontekst wywołania modułu podczas jego wykonywania w ramach zestawu.
`int`	`getNumDevicesAllocated()` Zwraca liczbę urządzeń przypisanych do wywołania.
	`getSerials()` Zwraca listę numerów seryjnych urządzenia śledzonego w ramach tego wywołania.
	`getShardsSerials()` Zwraca mapę wszystkich śledzonych seriali i ich fragmentów uczestniczących w dzieleniu.
`String`	`getTestTag()` Zwraca tag testowy wywołania.
`static boolean`	`isOnDemand(IInvocationContext context)` Zwraca informację, czy wykryliśmy wywołanie testu na żądanie na podstawie typu wyzwalacza.
`static boolean`	`isPresubmit(IInvocationContext context)` Zwraca informację, czy wykryliśmy przesłanie wstępne na podstawie typu aktywatora.
`void`	`lockAttributes()` Zablokuj kontekst, aby zapobiec dodawaniu kolejnych atrybutów wywołania.
`void`	`logInvocationMetrics()` Zaloguj atrybuty `InvocationMetricLogger` do wywołania.
`void`	`markReleasedEarly()` Oznacz urządzenia, które są wczesniej udostępniane.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Ustawia deskryptor powiązany z konfiguracją testową, która uruchomiła wywołanie.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Ustawia kontekst wywołania modułu podczas jego wykonywania w ramach pakietu.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Ustawia `RecoveryMode` wszystkich urządzeń, które są częścią kontekstu.
`void`	`setTestTag(String testTag)` Ustawia tag testowy wywołania.
`InvocationContext.Context`	`toProto()` Serializuj instancję kontekstu w formacie protobuf.
`boolean`	`wasReleasedEarly()` Zwraca informacje o tym, czy urządzenia zostały wcześniej wydane i czy nie będą już używane.

Konstruktory publiczne

InvocationContext

public InvocationContext ()

Tworzy BuildInfo, używając domyślnych wartości atrybutów.

Metody publiczne

addAllocatedDevice

public 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 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 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 void addInvocationAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut wywołania.

Parametry
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

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

Parametry
`attributesMap`	`MultiMap`

addSerialsFromShard

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

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Odwrotna operacja do InvocationContext.toProto(), aby przywrócić instancję.

Parametry
`protoContext`	`InvocationContext.Context`

Zwroty
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

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

Zwroty
`MultiMap<String, String>`

getBuildInfo

public 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 IBuildInfo getBuildInfo (ITestDevice testDevice)

Zwraca IBuildInfo powiązany z ITestDevice

Parametry
`testDevice`	`ITestDevice`

Zwroty
`IBuildInfo`

getBuildInfoName

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

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

Zwroty

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

Zwroty
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

Parametry
`deviceName`	`String`

Zwroty
`ITestDevice`

getDeviceBuildMap

public  getDeviceBuildMap ()

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

Zwroty

getDeviceBySerial

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

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

Zwroty

getDeviceName

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

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

Zwroty

getInvocationId

public String getInvocationId ()

Zwroty
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

Zwroty
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

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

Zwroty
`int`

getSerials

public  getSerials ()

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

Zwroty

getShardsSerials

public  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 String getTestTag ()

Zwraca tag testowy wywołania.

Zwroty
`String`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

Zwraca informację, czy wykryliśmy wywołanie testu na żądanie na podstawie typu wyzwalacza.

Parametry
`context`	`IInvocationContext`

Zwroty
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

Zwraca informację, czy wykryliśmy przesłanie wstępne na podstawie typu aktywatora.

Parametry
`context`	`IInvocationContext`

Zwroty
`boolean`

lockAttributes

public void lockAttributes ()

Zablokuj kontekst, aby zapobiec dodawaniu kolejnych atrybutów wywołania.

logInvocationMetrics

public void logInvocationMetrics ()

Zaloguj atrybuty InvocationMetricLogger do wywołania.

markReleasedEarly

public void markReleasedEarly ()

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

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Parametry
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

Parametry
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

Parametry
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

Ustawia tag testowy wywołania.

Parametry
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

Serializuj instancję kontekstu w formacie protobuf.

Zwroty
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

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

Zwroty
`boolean`