W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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(Map<String, ITestDevice> deviceWithName)` Śledź mapę nazw urządzeń konfiguracji powiązanych z `ITestDevice`.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` Dodaj ITestDevice, który będzie śledzony przez metadane po przydzieleniu urządzenia.
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` Dodaj `IBuildInfo`, aby śledzić nazwę konfiguracji urządzenia.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` Dodaj atrybut Invocation.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` Dodaj kilka atrybutów wywołania jednocześnie za pomocą znaku `UniqueMultiMap`.
`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.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` Wykonaj operację odwrotną do `InvocationContext.toProto()`, aby przywrócić instancję.
`MultiMap<String, String>`	`getAttributes()` Zwraca kopię mapy zawierającą wszystkie atrybuty wywołania.
`IBuildInfo`	`getBuildInfo(String deviceName)` Zwróć `IBuildInfo` powiązany z podaną nazwą konfiguracji urządzenia.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` Zwróć wartość `IBuildInfo` powiązaną z wartością `ITestDevice`.
`String`	`getBuildInfoName(IBuildInfo info)` Zwraca nazwę zestawu urządzeń w konfiguracji XML z `IBuildInfo`.
`List<IBuildInfo>`	`getBuildInfos()` Zwraca wszystkie `IBuildInfo` śledzone w ramach tego wywołania.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` Zwraca deskryptor powiązany z konfiguracją testu, która uruchomiła wywołanie.
`ITestDevice`	`getDevice(String deviceName)` Zwróć `ITestDevice` powiązany z podaną nazwą konfiguracji urządzenia.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` Zwraca mapę powiązań informacji o urządzeniu i kompilacji.
`ITestDevice`	`getDeviceBySerial(String serial)` Zwraca `ITestDevice` powiązany z podanym numerem seryjnym.
`List<String>`	`getDeviceConfigNames()` Zwraca listę nazw konfiguracji urządzeń śledzonych w tym wywołaniu.
`String`	`getDeviceName(ITestDevice device)` Zwraca nazwę zestawu urządzeń w konfiguracji XML z `ITestDevice`.
`List<ITestDevice>`	`getDevices()` Zwraca wszystkie przydzielone urządzenia śledzone w ramach tego wywołania.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Zwraca kontekst wywołania modułu podczas wykonywania go w ramach pakietu.
`int`	`getNumDevicesAllocated()` Zwraca liczbę urządzeń przydzielonych do wywołania.
`List<String>`	`getSerials()` Zwraca listę numerów seryjnych urządzenia śledzonego w tym wywołaniu.
`Map<Integer, List<String>>`	`getShardsSerials()` Zwraca mapę wszystkich śledzonych numerów seryjnych i ich fragmentów biorących udział w dzieleniu.
`String`	`getTestTag()` Zwraca tag testowy wywołania.
`static boolean`	`isApiTrigger(IInvocationContext context)` Zwraca informację, czy wykryliśmy wywołanie testu opartego na interfejsie API na podstawie typu wyzwalacza.
`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 wstępne przesłanie na podstawie typu aktywatora.
`void`	`lockAttributes()` Zablokuj kontekst, aby uniemożliwić dodawanie kolejnych atrybutów wywołania.
`void`	`logInvocationMetrics()` Zaloguj atrybuty `InvocationMetricLogger` w wywołaniu.
`void`	`markReleasedEarly()` Oznacz, że urządzenia zostaną udostępnione wcześniej.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` Ustawia deskryptor powiązany z konfiguracją testu, która uruchomiła wywołanie.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Ustawia kontekst wywołania modułu podczas wykonywania go w ramach pakietu.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` Ustawia `RecoveryMode` wszystkich urządzeń w kontekście.
`void`	`setTestTag(String testTag)` Ustawia tag testowy wywołania.
`InvocationContext.Context`	`toProto()` Serializuj instancję kontekstu do protokołu protobuf.
`boolean`	`wasReleasedEarly()` Zwraca informację, czy urządzenia zostały wcześniej wycofane i 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 (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 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 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 void addInvocationAttribute (String attributeName, 
                String attributeValue)

Dodaj atrybut Invocation.

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

addInvocationAttributes

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

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

Parametry
`attributesMap`	`MultiMap`

addSerialsFromShard

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

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

Wykonaj operację odwrotną do InvocationContext.toProto(), aby przywrócić instancję.

Parametry
`protoContext`	`InvocationContext.Context`

Zwraca
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

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

Zwraca
`MultiMap<String, String>`

getBuildInfo

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

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

Parametry
`testDevice`	`ITestDevice`

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

Parametry
`info`	`IBuildInfo`

Zwraca
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

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

Zwraca
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

Zwraca
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

Parametry
`deviceName`	`String`

Zwraca
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

Zwraca
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

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

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

Zwraca
`List<String>`

getDeviceName

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

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

Zwraca
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

Zwraca
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

Zwraca
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

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

Zwraca
`int`

getSerials

public List<String> getSerials ()

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

Zwraca
`List<String>`

getShardsSerials

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

Zwraca tag testowy wywołania.

Zwraca
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

Zwraca informację, czy na podstawie typu wywołania wykryliśmy wywołanie testu opartego na interfejsie API.

Parametry
`context`	`IInvocationContext`

Zwraca
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

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

Parametry
`context`	`IInvocationContext`

Zwraca
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

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

Parametry
`context`	`IInvocationContext`

Zwraca
`boolean`

lockAttributes

public void lockAttributes ()

Zablokuj kontekst, aby uniemożliwić dodawanie kolejnych atrybutów wywołania.

logInvocationMetrics

public void logInvocationMetrics ()

Zaloguj atrybuty InvocationMetricLogger w wywołaniu.

markReleasedEarly

public void markReleasedEarly ()

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

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Parametry
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

Parametry
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

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

Zwraca
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

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

Zwraca
`boolean`