呼叫上下文

public interface IInvocationContext

com.android.tradefed.invoker.IInspirationContext


保存有關調用的信息,以便測試在需要時存取。測試不應修改此處包含的上下文,因此只有 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 的密鑰。

常數值:“呼叫 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  getBuildInfos ()

傳回為此呼叫追蹤的所有IBuildInfo

退貨

取得配置描述符

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

傳回與啟動呼叫的測試配置關聯的描述符

退貨
ConfigurationDescriptor

取得設備

public abstract ITestDevice getDevice (String deviceName)

傳回與提供的裝置配置名稱相關聯的ITestDevice

參數
deviceName String

退貨
ITestDevice

取得設備建置映射

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

傳回為此呼叫追蹤的所有已指派裝置。

退貨

取得呼叫ID

public abstract String getInvocationId ()

退貨
String關聯的呼叫 ID,如果未連結到呼叫則為null

取得呼叫計時指標

public  getInvocationTimingMetrics ()

傳回包含呼叫計時指標的對應。

退貨

取得模組呼叫上下文

public abstract IInvocationContext getModuleInvocationContext ()

返回模組作為套件的一部分執行時的呼叫上下文。

退貨
IInvocationContext

取得分配的設備數量

public abstract int getNumDevicesAllocated ()

傳回為呼叫分配的設備數量。

退貨
int

獲取連續出版物

public abstract  getSerials ()

傳回此呼叫中追蹤的裝置的序號列表

退貨

取得ShardsSerials

public abstract  getShardsSerials ()

傳回所有追蹤的連續劇及其參與分片的分片的地圖。如果不是分片呼叫則為空。

退貨

取得測試標籤

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