呼叫上下文
public interface IInvocationContext
com.android.tradefed.invoker.IInspirationContext |
保存有關調用的信息,以便測試在需要時存取。測試不應修改此處包含的上下文,因此只有 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 的密鑰。
常數值:“呼叫 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 ConfigurationDescriptor getConfigurationDescriptor ()
傳回與啟動呼叫的測試配置關聯的描述符
退貨 | |
---|---|
ConfigurationDescriptor |
取得設備
public abstract ITestDevice getDevice (String deviceName)
傳回與提供的裝置配置名稱相關聯的ITestDevice
。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
ITestDevice |
取得設備建置映射
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 ()
傳回為此呼叫追蹤的所有已指派裝置。
退貨 | |
---|---|
取得呼叫ID
public abstract String getInvocationId ()
退貨 | |
---|---|
String | 關聯的呼叫 ID,如果未連結到呼叫則為null |
取得呼叫計時指標
publicgetInvocationTimingMetrics ()
傳回包含呼叫計時指標的對應。
退貨 | |
---|---|
取得模組呼叫上下文
public abstract IInvocationContext getModuleInvocationContext ()
返回模組作為套件的一部分執行時的呼叫上下文。
退貨 | |
---|---|
IInvocationContext |
取得分配的設備數量
public abstract int getNumDevicesAllocated ()
傳回為呼叫分配的設備數量。
退貨 | |
---|---|
int |
獲取連續出版物
public abstractgetSerials ()
傳回此呼叫中追蹤的裝置的序號列表
退貨 | |
---|---|
取得ShardsSerials
public abstractgetShardsSerials ()
傳回所有追蹤的連續劇及其參與分片的分片的地圖。如果不是分片呼叫則為空。
退貨 | |
---|---|
取得測試標籤
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 |