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) 添加了调用属性。
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() 返回设备/build 信息关联的映射
ITestDevice	getDeviceBySerial(String serial) 返回与所提供的序列号关联的 ITestDevice。
List<String>	getDeviceConfigNames() 返回相应调用中跟踪的设备的设备配置名称列表
String	getDeviceName(ITestDevice device) 返回 XML 配置中设备集的名称（来自 ITestDevice）。
List<ITestDevice>	getDevices() 返回此调用中跟踪的所有已分配设备。
String	getInvocationId()
IInvocationContext	getModuleInvocationContext() 返回模块在作为套件的一部分执行时的调用上下文。
int	getNumDevicesAllocated() 返回为调用分配的设备数量。
List<String>	getSerials() 返回在此调用中跟踪的设备的序列号列表
Map<Integer, List<String>>	getShardsSerials() 返回所有跟踪的序列及其在分片中涉及的分片的 Map。
String	getTestTag() 返回调用测试标记。
static boolean	isApiTrigger(IInvocationContext context) 根据触发类型返回是否检测到基于 API 的测试调用。
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) 设置模块在作为测试套件的一部分执行时的调用上下文。
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。 会将 build 信息设置为地图中的 null。

参数
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, 
                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，则返回 null。

参数
deviceName	String

返回
IBuildInfo

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

返回与 ITestDevice 关联的 IBuildInfo

参数
testDevice	ITestDevice

返回
IBuildInfo

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

从 IBuildInfo 返回 XML 配置中设备集的名称。如果无法匹配 IBuildInfo，则返回 null

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

返回设备/build 信息关联的映射

返回
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，则返回 null。

参数
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。如果不是分片调用，则为空。

返回
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)

设置模块在作为套件的一部分执行时的调用上下文。

参数
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