為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

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

IInvocationContext 的一般實作。

摘要

公用建構函式
`InvocationContext()` 使用預設屬性值建立 `BuildInfo`。

公用方法
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` 追蹤與 `ITestDevice` 相關聯的設定裝置名稱地圖。
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` 新增 ITestDevice，以便在分配裝置時追蹤中繼資料。
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` 新增 `IBuildInfo`，以便使用裝置設定名稱追蹤。
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` 新增 Invocation 屬性。
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` 透過 `UniqueMultiMap` 一次新增多個叫用屬性。
`void`	`addSerialsFromShard(Integer index, List<String> serials)` 新增要追蹤的序號，並指派給執行部分測試的其中一個分片。
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` 反向操作 `InvocationContext.toProto()` 即可還原執行個體。
`MultiMap<String, String>`	`getAttributes()` 傳回包含所有叫用屬性的對應項副本。
`IBuildInfo`	`getBuildInfo(String deviceName)` 傳回與所提供裝置設定名稱相關聯的 `IBuildInfo`。
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` 傳回與 `ITestDevice` 相關聯的 `IBuildInfo`
`String`	`getBuildInfoName(IBuildInfo info)` 從 `IBuildInfo` 的 XML 設定中傳回裝置群組名稱。
`List<IBuildInfo>`	`getBuildInfos()` 傳回這項呼叫追蹤的所有 `IBuildInfo`。
`ConfigurationDescriptor`	`getConfigurationDescriptor()` 傳回與啟動調用的測試設定相關聯的描述元
`ITestDevice`	`getDevice(String deviceName)` 傳回與所提供裝置設定名稱相關聯的 `ITestDevice`。
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` 傳回裝置/建構資訊關聯的地圖
`ITestDevice`	`getDeviceBySerial(String serial)` 傳回與所提供序號相關聯的 `ITestDevice`。
`List<String>`	`getDeviceConfigNames()` 傳回在此叫用中追蹤的裝置設定名稱清單
`String`	`getDeviceName(ITestDevice device)` 從 `ITestDevice` 的 xml 設定中傳回裝置群組名稱。
`List<ITestDevice>`	`getDevices()` 傳回此呼叫所追蹤的所有已分配裝置。
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` Returns the invocation context of module while being executed as part of a suite.
`int`	`getNumDevicesAllocated()` 傳回為叫用作業分配的裝置數量。
`List<String>`	`getSerials()` 傳回在此呼叫中追蹤的裝置序號清單
`Map<Integer, List<String>>`	`getShardsSerials()` 傳回所有追蹤序號的地圖，以及參與分片的相關分片。
`String`	`getTestTag()` 傳回呼叫測試標記。
`static boolean`	`isApiTrigger(IInvocationContext context)` Returns whether we detect API based test invocation based on trigger type.
`static boolean`	`isOnDemand(IInvocationContext context)` 根據觸發類型，傳回是否偵測到隨選測試呼叫。
`static boolean`	`isPresubmit(IInvocationContext context)` 根據觸發條件類型，傳回是否偵測到預先提交。
`void`	`lockAttributes()` 鎖定內容，防止新增更多叫用屬性。
`void`	`logInvocationMetrics()` 將 `InvocationMetricLogger` 屬性記錄到呼叫中。
`void`	`markReleasedEarly()` 標示裝置提早發布。
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` 設定與啟動調用的測試設定相關聯的描述元
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` Sets the invocation context of module while being executed as part of a suite.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` 設定情境中所有裝置的 `RecoveryMode`
`void`	`setTestTag(String testTag)` 設定叫用測試標記。
`InvocationContext.Context`	`toProto()` 將內容例項序列化為 protobuf。
`boolean`	`wasReleasedEarly()` 傳回裝置是否已提早釋出，且不再使用。

公用建構函式

InvocationContext

public InvocationContext ()

使用預設屬性值建立 BuildInfo。

公用方法

addAllocatedDevice

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

追蹤與 ITestDevice 相關聯的設定裝置名稱地圖。不會在新增前清除先前的追蹤記錄。

參數
`deviceWithName`	`Map`：要追蹤的其他裝置的 `Map`

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

新增 ITestDevice，以便在分配裝置時追蹤中繼資料。會將地圖中的建構資訊設為空值。

參數
`devicename`	`String`：要與 `ITestDevice` 建立關聯的裝置設定名稱
`testDevice`	`ITestDevice`：要新增至已分配裝置。

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

新增 IBuildInfo，以便追蹤裝置設定名稱。

參數
`deviceName`	`String`：裝置設定名稱
`buildinfo`	`IBuildInfo`：與裝置設定名稱相關聯的 `IBuildInfo`。

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

新增 Invocation 屬性。

參數
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

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

透過 UniqueMultiMap 一次新增多個叫用屬性。

參數
`attributesMap`	`MultiMap`

addSerialsFromShard

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

新增要追蹤的序號，並指派給執行部分測試的其中一個分片。

參數
`index`	`Integer`：使用序號的分片索引
`serials`	`List`：要追蹤的序號清單。

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

反向操作 InvocationContext.toProto() 即可還原執行個體。

參數
`protoContext`	`InvocationContext.Context`

傳回
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

傳回包含所有叫用屬性的對應副本。

傳回
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

傳回與所提供裝置設定名稱相關聯的 IBuildInfo。如果無法比對 deviceName，則傳回空值。

參數
`deviceName`	`String`

傳回
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

傳回與 ITestDevice 相關聯的 IBuildInfo

參數
`testDevice`	`ITestDevice`

傳回
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

從 IBuildInfo 傳回 XML 設定中的裝置集名稱。如果 IBuildInfo 無法比對，則傳回空值

參數
`info`	`IBuildInfo`

傳回
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

傳回這項呼叫追蹤的所有 IBuildInfo。

傳回
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

傳回與啟動調用的測試設定相關聯的描述元

傳回
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

傳回與所提供裝置設定名稱相關聯的 ITestDevice。

參數
`deviceName`	`String`

傳回
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

傳回裝置/建構資訊關聯的地圖

傳回
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

傳回與所提供序號相關聯的 ITestDevice。請勿過度使用，因為這不是最快的查閱方式。

參數
`serial`	`String`

傳回
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

傳回在此呼叫中追蹤的裝置設定名稱清單

傳回
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

從 ITestDevice 傳回 XML 設定中的裝置集名稱。如果無法比對 ITestDevice，則傳回空值。

參數
`device`	`ITestDevice`

傳回
`String`

getDevices

public List<ITestDevice> getDevices ()

傳回此呼叫所追蹤的所有已分配裝置。

傳回
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

傳回
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

以套件的一部分執行時，傳回模組的叫用內容。

傳回
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

傳回為叫用作業分配的裝置數量。

傳回
`int`

getSerials

public List<String> getSerials ()

傳回在此呼叫中追蹤的裝置序號清單

傳回
`List<String>`

getShardsSerials

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

傳回所有追蹤序號的地圖，以及參與分片的相關分片。如果不是分片呼叫，則為空白。

傳回
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

傳回呼叫測試代碼。

傳回
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

根據觸發類型，傳回是否偵測到以 API 為基礎的測試呼叫。

參數
`context`	`IInvocationContext`

傳回
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

根據觸發類型，傳回是否偵測到隨選測試呼叫。

參數
`context`	`IInvocationContext`

傳回
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

根據觸發條件類型，傳回是否偵測到預先提交。

參數
`context`	`IInvocationContext`

傳回
`boolean`

lockAttributes

public void lockAttributes ()

鎖定內容，防止新增更多叫用屬性。

logInvocationMetrics

public void logInvocationMetrics ()

將 InvocationMetricLogger 屬性記錄到呼叫中。

markReleasedEarly

public void markReleasedEarly ()

標示裝置提早發布。

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

設定與啟動調用的測試設定相關聯的描述元

參數
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

Sets the invocation context of module while being executed as part of a suite.

參數
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定情境中所有裝置的 RecoveryMode

參數
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

設定叫用測試代碼。

參數
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

將內容例項序列化為 protobuf。

傳回
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

傳回裝置是否已提早發布，且不再使用。

傳回
`boolean`