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

Switch to English

呼叫上下文

public interface IInvocationContext

com.android.tradefed.invoker.IInspirationContext

已知的間接子類

呼叫上下文

呼叫上下文 IInvocationContext的通用實作。

保存有關調用的信息，以便測試在需要時存取。測試不應修改此處包含的上下文，因此只有 getter 可用，但用於報告目的的上下文屬性除外。

概括

常數
`String`	`INVOCATION_ID` 用於儲存關聯調用 ID 的密鑰。

公共方法
`abstract void`	`addAllocatedDevice ( deviceWithName)` `addAllocatedDevice ( deviceWithName)` 追蹤與`ITestDevice`關聯的設定設備名稱的對應。
`abstract void`	`addAllocatedDevice (String deviceName, ITestDevice testDevice)` 新增一個 ITestDevice，以便在分配裝置時透過元資料進行追蹤。
`abstract void`	`addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)` 新增要使用裝置配置名稱進行追蹤的`IBuildInfo` 。
`abstract void`	`addInvocationAttribute (String attributeName, String attributeValue)` 新增調用屬性。
`abstract void`	`addInvocationAttributes ( MultiMap <String, String> attributesMap)` 透過`UniqueMultiMap`一次新增多個呼叫屬性。
`default void`	`addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis)` 新增調用計時指標。
`abstract void`	`addSerialsFromShard (Integer index, serials)` `addSerialsFromShard (Integer index, serials)` 新增要追蹤的序號，分配給執行某些測試的分片之一。
`default String`	`getAttribute (String key)` 一種以單一鍵值對形式檢索呼叫上下文屬性的便捷方法。
`abstract MultiMap <String, String>`	`getAttributes ()` 傳回包含所有呼叫屬性的映射副本。
`abstract IBuildInfo`	`getBuildInfo (String deviceName)` 傳回與提供的裝置配置名稱關聯的`IBuildInfo` 。
`abstract IBuildInfo`	`getBuildInfo ( ITestDevice testDevice)` 傳回與`ITestDevice`關聯的`IBuildInfo`
`abstract String`	`getBuildInfoName ( IBuildInfo info)` 從`IBuildInfo`傳回 xml 配置中設定的設備名稱。
`abstract`	`getBuildInfos ()` 傳回為此呼叫追蹤的所有`IBuildInfo` 。
`abstract ConfigurationDescriptor`	`getConfigurationDescriptor ()` 傳回與啟動呼叫的測試配置關聯的描述符
`abstract ITestDevice`	`getDevice (String deviceName)` 傳回與提供的裝置配置名稱相關聯的`ITestDevice` 。
`abstract`	`getDeviceBuildMap ()` 返回設備/建構資訊關聯的地圖
`abstract ITestDevice`	`getDeviceBySerial (String serial)` 傳回與所提供的序號關聯的`ITestDevice` 。
`abstract`	`getDeviceConfigNames ()` 傳回此呼叫中追蹤的裝置的裝置配置名稱列表
`abstract String`	`getDeviceName ( ITestDevice device)` 從`ITestDevice`傳回 xml 設定中設定的設備名稱。
`abstract`	`getDevices ()` 傳回為此呼叫追蹤的所有已指派裝置。
`abstract String`	`getInvocationId ()`
`default`	`getInvocationTimingMetrics ()` 傳回包含呼叫計時指標的對應。
`abstract IInvocationContext`	`getModuleInvocationContext ()` 返回模組作為套件的一部分執行時的呼叫上下文。
`abstract int`	`getNumDevicesAllocated ()` 傳回為呼叫分配的設備數量。
`abstract`	`getSerials ()` 傳回此呼叫中追蹤的裝置的序號列表
`abstract`	`getShardsSerials ()` 傳回所有追蹤的連續劇及其參與分片的分片的地圖。
`abstract String`	`getTestTag ()` 返回呼叫測試標籤。
`abstract void`	`markReleasedEarly ()` 標記這些設備正在提前發布。
`abstract void`	`setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)` 設定與啟動呼叫的測試配置關聯的描述符
`abstract void`	`setModuleInvocationContext ( IInvocationContext invocationContext)` 設定模組作為套件的一部分執行時的呼叫上下文。
`abstract void`	`setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)` 設定上下文中所有設備部分的`RecoveryMode`
`abstract void`	`setTestTag (String testTag)` 設定調用測試標籤。
`abstract InvocationContext.Context`	`toProto ()` 將上下文實例序列化到 protobuf 中。
`abstract boolean`	`wasReleasedEarly ()` 返回設備是否已提前發布且不再使用。

常數

INVOCATION_ID

public static final String INVOCATION_ID

用於儲存關聯調用 ID 的密鑰。

常數值：“呼叫 ID”

公共方法

新增分配的設備

public abstract void addAllocatedDevice ( deviceWithName)

追蹤與ITestDevice關聯的設定設備名稱的對應。新增之前不會清除先前的追蹤。

參數
`deviceWithName`	：要追蹤的附加設備的`ERROR(/Map)`

新增分配的設備

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

新增一個 ITestDevice，以便在分配裝置時透過元資料進行追蹤。將在地圖中將建置資訊設為 null。

參數
`deviceName`	`String` ：與`ITestDevice`關聯的裝置設定名稱
`testDevice`	`ITestDevice` ：新增到已指派的設備。

新增設備建置資訊

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

新增要使用裝置配置名稱進行追蹤的IBuildInfo 。

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

新增呼叫屬性

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

新增調用屬性。

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

新增呼叫屬性

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

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

參數
`attributesMap`	`MultiMap`

新增呼叫計時指標

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

新增調用計時指標。

參數
`timingEvent`	`IInvocationContext.TimingEvent`
`durationMillis`	`Long`

從分片添加序號

public abstract void addSerialsFromShard (Integer index, 
                 serials)

新增要追蹤的序號，分配給執行某些測試的分片之一。

參數
`index`	`Integer` ：使用序號的分片索引
`serials`	：要追蹤的連續劇列表。

取得屬性

public String getAttribute (String key)

一種以單一鍵值對形式檢索呼叫上下文屬性的便捷方法。永遠不要回傳 null。

參數
`key`	`String`

退貨
`String`	當鍵不存在時為空字串，否則為值。

取得屬性

public abstract MultiMap<String, String> getAttributes ()

傳回包含所有呼叫屬性的映射副本。

退貨
`MultiMap <String, String>`

獲取建構資訊

public abstract IBuildInfo getBuildInfo (String deviceName)

傳回與提供的裝置配置名稱關聯的IBuildInfo 。如果 deviceName 無法匹配，則傳回 null。

參數
`deviceName`	`String`

退貨
`IBuildInfo`

獲取建構資訊

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

傳回與ITestDevice關聯的IBuildInfo

參數
`testDevice`	`ITestDevice`

退貨
`IBuildInfo`

取得建置資訊名稱

public abstract String getBuildInfoName (IBuildInfo info)

從IBuildInfo傳回 xml 配置中設定的設備名稱。如果 IBuildInfo 無法匹配，則傳回 null

參數
`info`	`IBuildInfo`

退貨
`String`

獲取建構資訊

public abstract  getBuildInfos ()

傳回為此呼叫追蹤的所有IBuildInfo 。

退貨

取得配置描述符

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

傳回與啟動呼叫的測試配置關聯的描述符

退貨
`ConfigurationDescriptor`

取得設備

public abstract ITestDevice getDevice (String deviceName)

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

參數
`deviceName`	`String`

退貨
`ITestDevice`

取得設備建置映射

public abstract  getDeviceBuildMap ()

返回設備/建構資訊關聯的地圖

退貨

透過序號取得設備

public abstract ITestDevice getDeviceBySerial (String serial)

傳回與所提供的序號關聯的ITestDevice 。不要使用太多，因為這不是最快的查找。

參數
`serial`	`String`

退貨
`ITestDevice`

取得設備配置名稱

public abstract  getDeviceConfigNames ()

傳回此呼叫中追蹤的裝置的裝置配置名稱列表

退貨

取得設備名稱

public abstract String getDeviceName (ITestDevice device)

從ITestDevice傳回 xml 設定中設定的設備名稱。如果 ITestDevice 無法匹配，則傳回 null。

參數
`device`	`ITestDevice`

退貨
`String`

取得設備

public abstract  getDevices ()

傳回為此呼叫追蹤的所有已指派裝置。

退貨

取得呼叫ID

public abstract String getInvocationId ()

退貨
`String`	關聯的呼叫 ID，如果未連結到呼叫則為`null`

取得呼叫計時指標

public  getInvocationTimingMetrics ()

傳回包含呼叫計時指標的對應。

退貨

取得模組呼叫上下文

public abstract IInvocationContext getModuleInvocationContext ()

返回模組作為套件的一部分執行時的呼叫上下文。

退貨
`IInvocationContext`

取得分配的設備數量

public abstract int getNumDevicesAllocated ()

傳回為呼叫分配的設備數量。

退貨
`int`

獲取連續出版物

public abstract  getSerials ()

傳回此呼叫中追蹤的裝置的序號列表

退貨

取得ShardsSerials

public abstract  getShardsSerials ()

傳回所有追蹤的連續劇及其參與分片的分片的地圖。如果不是分片呼叫則為空。

退貨

取得測試標籤

public abstract String getTestTag ()

返回呼叫測試標籤。

退貨
`String`

標記提前發布

public abstract void markReleasedEarly ()

標記這些設備正在提前發布。

設定配置描述符

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

設定與啟動呼叫的測試配置關聯的描述符

參數
`configurationDescriptor`	`ConfigurationDescriptor`

設定模組呼叫上下文

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

設定模組作為套件的一部分執行時的呼叫上下文。

參數
`invocationContext`	`IInvocationContext`

設定所有設備的恢復模式

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定上下文中所有設備部分的RecoveryMode

參數
`mode`	`ITestDevice.RecoveryMode`

設定測試標籤

public abstract void setTestTag (String testTag)

設定調用測試標籤。

參數
`testTag`	`String`

原型

public abstract InvocationContext.Context toProto ()

將上下文實例序列化到 protobuf 中。

退貨
`InvocationContext.Context`

提前發布

public abstract boolean wasReleasedEarly ()

返回設備是否已提前發布且不再使用。

退貨
`boolean`