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

Switch to English

IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

已知的間接子類

調用上下文

調用上下文 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 的密鑰。

常數值：“invocation-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`

addSerialsFromShard

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`

getBuildInfoName

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`

getDeviceBuildMap

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

返回為此調用跟踪的所有已分配設備。

退貨

getInvocationId

public abstract String getInvocationId ()

退貨
`String`	關聯的調用 ID 或`null` （如果未鏈接到調用）

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

返回包含調用計時指標的映射。

退貨

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

在作為套件的一部分執行時返回模塊的調用上下文。

退貨
`IInvocationContext`

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

返回為調用分配的設備數。

退貨
`int`

獲取連載

public abstract  getSerials ()

返回在此調用中跟踪的設備的序列號列表

退貨

getShardsSerials

public abstract  getShardsSerials ()

返回所有跟踪的連續劇的地圖及其參與分片的分片。如果不是分片調用則為空。

退貨

獲取測試標籤

public abstract String getTestTag ()

返回調用測試標籤。

退貨
`String`

標記發布早

public abstract void markReleasedEarly ()

標記設備提前發布。

設置配置描述符

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

設置與啟動調用的測試配置關聯的描述符

參數
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

在作為套件的一部分執行時設置模塊的調用上下文。

參數
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

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`