IInvocationContext
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
保存有關調用的信息,供測試在需要時訪問。測試不應修改此處包含的上下文,因此除了用於報告目的的上下文屬性外,只有 getter 可用。
概括
常量 | |
---|---|
String | INVOCATION_ID 用於存儲關聯調用 ID 的密鑰。 |
公共方法 | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) 跟踪與 |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) 添加一個 ITestDevice 以在分配設備時由元數據跟踪。 |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) 添加要使用設備配置名稱進行跟踪的 |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) 添加調用屬性。 |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) 通過 |
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) 返回與提供的設備配置名稱關聯的 |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) 返回與 |
abstract String | getBuildInfoName ( IBuildInfo info) 從 |
abstract | getBuildInfos () 返回為此調用跟踪的所有 |
abstract ConfigurationDescriptor | getConfigurationDescriptor () 返回與啟動調用的測試配置關聯的描述符 |
abstract ITestDevice | getDevice (String deviceName) 返回與提供的設備配置名稱關聯的 |
abstract | getDeviceBuildMap () 返回設備/構建信息關聯的映射 |
abstract ITestDevice | getDeviceBySerial (String serial) 返回與提供的序列關聯的 |
abstract | getDeviceConfigNames () 返回在此調用中跟踪的設備的設備配置名稱列表 |
abstract String | getDeviceName ( ITestDevice device) 從 |
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) 設置上下文的所有設備部分的 |
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 ConfigurationDescriptor getConfigurationDescriptor ()
返回與啟動調用的測試配置關聯的描述符
退貨 | |
---|---|
ConfigurationDescriptor |
獲取設備
public abstract ITestDevice getDevice (String deviceName)
返回與提供的設備配置名稱關聯的ITestDevice
。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
返回設備/構建信息關聯的映射
退貨 | |
---|---|
通過序列號獲取設備
public abstract ITestDevice getDeviceBySerial (String serial)
返回與提供的序列關聯的ITestDevice
。不要使用太多,因為它不是最快的查找。
參數 | |
---|---|
serial | String |
退貨 | |
---|---|
ITestDevice |
獲取設備配置名稱
public abstractgetDeviceConfigNames ()
返回在此調用中跟踪的設備的設備配置名稱列表
退貨 | |
---|---|
獲取設備名稱
public abstract String getDeviceName (ITestDevice device)
從ITestDevice
返回 xml 配置中設置的設備名稱。如果無法匹配 ITestDevice,則返回 null。
參數 | |
---|---|
device | ITestDevice |
退貨 | |
---|---|
String |
獲取設備
public abstractgetDevices ()
返回為此調用跟踪的所有已分配設備。
退貨 | |
---|---|
getInvocationId
public abstract String getInvocationId ()
退貨 | |
---|---|
String | 關聯的調用 ID 或null (如果未鏈接到調用) |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
返回包含調用計時指標的映射。
退貨 | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
在作為套件的一部分執行時返回模塊的調用上下文。
退貨 | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
返回為調用分配的設備數。
退貨 | |
---|---|
int |
獲取連載
public abstractgetSerials ()
返回在此調用中跟踪的設備的序列號列表
退貨 | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
返回所有跟踪的連續劇的地圖及其參與分片的分片。如果不是分片調用則為空。
退貨 | |
---|---|
獲取測試標籤
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 |