本頁面由 Cloud Translation API 翻譯而成。

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

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

IInvocationContext 的一般實作方式。

摘要

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

公用方法
`void`	`addAllocatedDevice( deviceWithName)` 追蹤與 `ITestDevice` 相關聯的設定裝置名稱對應。
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` 新增 ITestDevice，以便在裝置分配時由中繼資料追蹤。
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` 新增 `IBuildInfo`，以便透過裝置設定名稱進行追蹤。
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` 新增叫用屬性。
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` 透過 `UniqueMultiMap` 一次新增多個啟動作業屬性。
`void`	`addSerialsFromShard(Integer index, 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 設定檔中的裝置組合名稱。
	`getBuildInfos()` 傳回此叫用作業追蹤的所有 `IBuildInfo`。
`ConfigurationDescriptor`	`getConfigurationDescriptor()` 傳回與啟動叫用作業的測試設定相關聯的描述元
`ITestDevice`	`getDevice(String deviceName)` 傳回與提供的裝置設定名稱相關聯的 `ITestDevice`。
	`getDeviceBuildMap()` 傳回裝置/版本資訊關聯的對應表
`ITestDevice`	`getDeviceBySerial(String serial)` 傳回與所提供序列相關聯的 `ITestDevice`。
	`getDeviceConfigNames()` 傳回在這個叫用中追蹤的裝置所屬的裝置設定名稱清單
`String`	`getDeviceName(ITestDevice device)` 從 `ITestDevice` 傳回 XML 設定檔中裝置組合的名稱。
	`getDevices()` 傳回為此叫用追蹤的所有已分配裝置。
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` 傳回模組在套件中執行時叫用的內容。
`int`	`getNumDevicesAllocated()` 傳回分配給叫用的裝置數量。
	`getSerials()` 傳回在這個叫用中追蹤的裝置序號清單
	`getShardsSerials()` 傳回所有已追蹤序列與分割作業中涉及的分割項目的 Map。
`String`	`getTestTag()` 傳回叫用測試標記。
`static boolean`	`isPresubmit(IInvocationContext context)` 傳回是否根據觸發條件類型偵測預提交。
`void`	`lockAttributes()` 鎖定結構定義，即可避免加入更多叫用屬性。
`void`	`logInvocationMetrics()` 將 `InvocationMetricLogger` 屬性記錄至叫用作業。
`void`	`markReleasedEarly()` 標示裝置是否提前發布。
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` 設定與啟動叫用的測試設定相關聯的描述元
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` 在套件執行時，設定模組的叫用內容。
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` 設定結構定義所有裝置的 `RecoveryMode`
`void`	`setTestTag(String testTag)` 設定叫用測試標記。
`InvocationContext.Context`	`toProto()` 將結構定義例項序列化為 protobuf。
`boolean`	`wasReleasedEarly()` 傳回裝置是否提早發布，且不再使用。

公用建構函式

InvocationContext

public InvocationContext ()

使用預設屬性值建立 BuildInfo。

公用方法

addAllocationsDevice

public void addAllocatedDevice ( deviceWithName)

追蹤與 ITestDevice 相關聯的設定裝置名稱對應表。新增前無法清除先前的追蹤項目。

參數
`deviceWithName`	：要追蹤的其他裝置 `ERROR(/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)

新增叫用屬性。

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

addInvocationAttributes

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

透過 UniqueMultiMap 一次新增多個啟動程序屬性。

參數
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                 serials)

新增序列，系統會將該序列指派給執行部分測試的其中一個資料分割。

參數
`index`	`Integer`：使用 serials 的區塊索引
`serials`	：要追蹤的連續劇清單。

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

傳回此叫用作業追蹤的所有 IBuildInfo。

傳回

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

傳回
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

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

參數
`deviceName`	`String`

傳回
`ITestDevice`

getDeviceBuildMap

public  getDeviceBuildMap ()

傳回裝置/版本資訊關聯的對應表

傳回

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

傳回與所提供序列相關聯的 ITestDevice。查詢最快的速度，因此請避免過度使用。

參數
`serial`	`String`

傳回
`ITestDevice`

getDeviceConfigNames

public  getDeviceConfigNames ()

傳回在這個呼叫中追蹤的裝置所屬的裝置設定名稱清單

傳回

getDeviceName

public String getDeviceName (ITestDevice device)

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

參數
`device`	`ITestDevice`

傳回
`String`

getDevices

public  getDevices ()

傳回為此叫用動作追蹤的所有已分配裝置。

傳回

getInvocationId

public String getInvocationId ()

傳回
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

傳回模組在套件中執行時叫用的內容。

傳回
`IInvocationContext`

getNumDeviceAllocations

public int getNumDevicesAllocated ()

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

傳回
`int`

getSerials

public  getSerials ()

傳回在這個叫用中追蹤的裝置序號清單

傳回

getShardsSerials

public  getShardsSerials ()

傳回所有已追蹤序列與分割作業中涉及的分割項目的 Map。如果不是分割的叫用，則為空白。

傳回

getTestTag

public String getTestTag ()

傳回叫用測試標記。

傳回
`String`

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)

在套件執行時，設定模組的叫用程序背景。

參數
`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`

提早發布

public boolean wasReleasedEarly ()

會傳回裝置是否提早釋出，且不會再使用。

傳回
`boolean`