IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


保存有關調用的信息,供測試在需要時訪問。測試不應修改此處包含的上下文,因此除了用於報告目的的上下文屬性外,只有 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 的密鑰。

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

返回為此調用跟踪的所有IBuildInfo

退貨

獲取配置描述符

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

返回與啟動調用的測試配置關聯的描述符

退貨
ConfigurationDescriptor

獲取設備

public abstract ITestDevice getDevice (String deviceName)

返回與提供的設備配置名稱關聯的ITestDevice

參數
deviceName String

退貨
ITestDevice

getDeviceBuildMap

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

返回為此調用跟踪的所有已分配設備。

退貨

getInvocationId

public abstract String getInvocationId ()

退貨
String關聯的調用 ID 或null (如果未鏈接到調用)

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

返回包含調用計時指標的映射。

退貨

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

在作為套件的一部分執行時返回模塊的調用上下文。

退貨
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

返回為調用分配的設備數。

退貨
int

獲取連載

public abstract  getSerials ()

返回在此調用中跟踪的設備的序列號列表

退貨

getShardsSerials

public abstract  getShardsSerials ()

返回所有跟踪的連續劇的地圖及其參與分片的分片。如果不是分片調用則為空。

退貨

獲取測試標籤

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