此页面由 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`