呼叫上下文
public class InvocationContext
extends Object
implements IInvocationContext
java.lang.Object | |
↳ | com.android.tradefed.invoker.InitationContext |
IInvocationContext
的通用實作。
概括
公共構造函數 | |
---|---|
InvocationContext () 使用預設屬性值建立 |
公共方法 | |
---|---|
void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) 追蹤與 |
void | addAllocatedDevice (String devicename, ITestDevice testDevice) 新增一個 ITestDevice,以便在分配裝置時透過元資料進行追蹤。 |
void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) 新增要使用裝置配置名稱進行追蹤的 |
void | addInvocationAttribute (String attributeName, String attributeValue) 新增調用屬性。 |
void | addInvocationAttributes ( MultiMap <String, String> attributesMap) 透過 |
void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) 新增要追蹤的序號,分配給執行某些測試的分片之一。 |
static InvocationContext | fromProto (InvocationContext.Context protoContext) |
MultiMap <String, String> | getAttributes () 傳回包含所有呼叫屬性的映射副本。 |
IBuildInfo | getBuildInfo (String deviceName) 傳回與提供的裝置配置名稱關聯的 |
IBuildInfo | getBuildInfo ( ITestDevice testDevice) 傳回與 |
String | getBuildInfoName ( IBuildInfo info) 從 |
getBuildInfos () 傳回為此呼叫追蹤的所有 | |
ConfigurationDescriptor | getConfigurationDescriptor () 傳回與啟動呼叫的測試配置關聯的描述符 |
ITestDevice | getDevice (String deviceName) 傳回與提供的裝置配置名稱相關聯的 |
getDeviceBuildMap () 返回設備/建構資訊關聯的地圖 | |
ITestDevice | getDeviceBySerial (String serial) 傳回與所提供的序號關聯的 |
getDeviceConfigNames () 傳回此呼叫中追蹤的裝置的裝置配置名稱列表 | |
String | getDeviceName ( ITestDevice device) 從 |
getDevices () 傳回為此呼叫追蹤的所有已指派裝置。 | |
String | getInvocationId () |
IInvocationContext | getModuleInvocationContext () 返回模組作為套件的一部分執行時的呼叫上下文。 |
int | getNumDevicesAllocated () 傳回為呼叫分配的設備數量。 |
getSerials () 傳回此呼叫中追蹤的裝置的序號列表 | |
getShardsSerials () 傳回所有追蹤的連續劇及其參與分片的分片的地圖。 | |
String | getTestTag () 返回呼叫測試標籤。 |
void | lockAttributes () 鎖定上下文以防止新增更多呼叫屬性。 |
void | logInvocationMetrics () 將 |
void | markReleasedEarly () 標記這些設備正在提前發布。 |
void | setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) 設定與啟動呼叫的測試配置關聯的描述符 |
void | setModuleInvocationContext ( IInvocationContext invocationContext) 設定模組作為套件的一部分執行時的呼叫上下文。 |
void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) 設定上下文中所有設備部分的 |
void | setTestTag (String testTag) 設定調用測試標籤。 |
InvocationContext.Context | toProto () 將上下文實例序列化到 protobuf 中。 |
boolean | wasReleasedEarly () 返回設備是否已提前發布且不再使用。 |
公共構造函數
公共方法
新增分配的設備
public void addAllocatedDevice (deviceWithName)
追蹤與ITestDevice
關聯的設定設備名稱的對應。新增之前不會清除先前的追蹤。
參數 | |
---|---|
deviceWithName | ERROR(/Map) |
新增分配的設備
public void addAllocatedDevice (String devicename, ITestDevice testDevice)
新增一個 ITestDevice,以便在分配裝置時透過元資料進行追蹤。將在地圖中將建置資訊設為 null。
參數 | |
---|---|
devicename | String :與ITestDevice 關聯的裝置設定名稱 |
testDevice | ITestDevice :新增到已指派的設備。 |
新增設備建置資訊
public void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
新增要使用裝置配置名稱進行追蹤的IBuildInfo
。
參數 | |
---|---|
deviceName | String : 裝置配置名稱 |
buildinfo | IBuildInfo :與裝置設定名稱關聯的IBuildInfo 。 |
新增呼叫屬性
public void addInvocationAttribute (String attributeName, String attributeValue)
新增調用屬性。
參數 | |
---|---|
attributeName | String |
attributeValue | String |
新增呼叫屬性
public void addInvocationAttributes (MultiMap<String, String> attributesMap)
透過UniqueMultiMap
一次新增多個呼叫屬性。
參數 | |
---|---|
attributesMap | MultiMap |
從分片添加序號
public void addSerialsFromShard (Integer index,serials)
新增要追蹤的序號,分配給執行某些測試的分片之一。
參數 | |
---|---|
index | Integer :使用序號的分片索引 |
serials |
來自原型
public static InvocationContext fromProto (InvocationContext.Context protoContext)
InvocationContext#toProto()
的逆操作以取得實例。
參數 | |
---|---|
protoContext | InvocationContext.Context |
退貨 | |
---|---|
InvocationContext |
獲取建構資訊
public IBuildInfo getBuildInfo (String deviceName)
傳回與提供的裝置配置名稱關聯的IBuildInfo
。如果 deviceName 無法匹配,則傳回 null。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
IBuildInfo |
獲取建構資訊
public IBuildInfo getBuildInfo (ITestDevice testDevice)
傳回與ITestDevice
關聯的IBuildInfo
參數 | |
---|---|
testDevice | ITestDevice |
退貨 | |
---|---|
IBuildInfo |
取得建置資訊名稱
public String getBuildInfoName (IBuildInfo info)
從IBuildInfo
傳回 xml 配置中設定的設備名稱。如果 IBuildInfo 無法匹配,則傳回 null
參數 | |
---|---|
info | IBuildInfo |
退貨 | |
---|---|
String |
取得配置描述符
public ConfigurationDescriptor getConfigurationDescriptor ()
傳回與啟動呼叫的測試配置關聯的描述符
退貨 | |
---|---|
ConfigurationDescriptor |
取得設備
public ITestDevice getDevice (String deviceName)
傳回與提供的裝置配置名稱相關聯的ITestDevice
。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
ITestDevice |
取得設備建置映射
publicgetDeviceBuildMap ()
返回設備/建構資訊關聯的地圖
退貨 | |
---|---|
透過序號取得設備
public ITestDevice getDeviceBySerial (String serial)
傳回與所提供的序號關聯的ITestDevice
。不要使用太多,因為這不是最快的查找。
參數 | |
---|---|
serial | String |
退貨 | |
---|---|
ITestDevice |
取得設備配置名稱
publicgetDeviceConfigNames ()
傳回此呼叫中追蹤的裝置的裝置配置名稱列表
退貨 | |
---|---|
取得設備名稱
public String getDeviceName (ITestDevice device)
從ITestDevice
傳回 xml 設定中設定的設備名稱。如果 ITestDevice 無法匹配,則傳回 null。
參數 | |
---|---|
device | ITestDevice |
退貨 | |
---|---|
String |
取得設備
publicgetDevices ()
傳回為此呼叫追蹤的所有已指派裝置。
退貨 | |
---|---|
取得呼叫ID
public String getInvocationId ()
退貨 | |
---|---|
String |
取得模組呼叫上下文
public IInvocationContext getModuleInvocationContext ()
返回模組作為套件的一部分執行時的呼叫上下文。
退貨 | |
---|---|
IInvocationContext |
取得分配的設備數量
public int getNumDevicesAllocated ()
傳回為呼叫分配的設備數量。
退貨 | |
---|---|
int |
獲取連續出版物
publicgetSerials ()
傳回此呼叫中追蹤的裝置的序號列表
退貨 | |
---|---|
取得ShardsSerials
publicgetShardsSerials ()
傳回所有追蹤的連續劇及其參與分片的分片的地圖。如果不是分片呼叫則為空。
退貨 | |
---|---|
取得測試標籤
public String getTestTag ()
返回呼叫測試標籤。
退貨 | |
---|---|
String |
鎖屬性
public void lockAttributes ()
鎖定上下文以防止新增更多呼叫屬性。
標記提前發布
public void markReleasedEarly ()
標記這些設備正在提前發布。
設定配置描述符
public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
設定與啟動呼叫的測試配置關聯的描述符
參數 | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
設定模組呼叫上下文
public void setModuleInvocationContext (IInvocationContext invocationContext)
設定模組作為套件的一部分執行時的呼叫上下文。
參數 | |
---|---|
invocationContext | IInvocationContext |
設定所有設備的恢復模式
public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
設定上下文中所有設備部分的RecoveryMode
參數 | |
---|---|
mode | ITestDevice.RecoveryMode |
設定測試標籤
public void setTestTag (String testTag)
設定調用測試標籤。
參數 | |
---|---|
testTag | String |
原型
public InvocationContext.Context toProto ()
將上下文實例序列化到 protobuf 中。
退貨 | |
---|---|
InvocationContext.Context |
提前發布
public boolean wasReleasedEarly ()
返回設備是否已提前發布且不再使用。
退貨 | |
---|---|
boolean |