IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

已知間接子類別 InvocationContext InvocationContext IInvocationContext 的一般實作。

---

保留叫用相關資訊，以便視需要存取測試。不得修改測試 因此只會保留 getter，但情境屬性除外 製作報告

摘要

常數
String	INVOCATION_ID 用來儲存相關叫用 ID 的金鑰。

公用方法
abstract void	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) 新增序列，系統會將該序列指派給執行部分測試的其中一個資料分割。
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」

公用方法

addAllocationsDevice

public abstract void addAllocatedDevice ( deviceWithName)

追蹤與 ITestDevice 相關聯的設定裝置名稱對應。內容不清楚 別忘了先追蹤先前的追蹤功能

參數
deviceWithName	：待追蹤的其他裝置 ERROR(/Map)

addAllocationsDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

新增要在裝置分配時，中繼資料追蹤的 ITestDevice。 會在地圖中將建構資訊設為 null。

參數
deviceName	String：要與 ITestDevice 建立關聯的裝置設定名稱
testDevice	ITestDevice：會新增至已分配的裝置。

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

新增要使用裝置設定名稱追蹤的 IBuildInfo。

參數
deviceName	String：裝置設定名稱
buildinfo	IBuildInfo：與裝置設定名稱相關聯的 IBuildInfo。

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

新增叫用屬性。

參數
attributeName	String
attributeValue	String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

透過 UniqueMultiMap 一次新增多個叫用屬性。

參數
attributesMap	MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

新增叫用時間指標。

參數
timingEvent	IInvocationContext.TimingEvent
durationMillis	Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

新增序列，系統會將該序列指派給執行部分測試的其中一個資料分割。

參數
index	Integer：使用序列的資料分割索引
serials	：要追蹤的序列清單。

getAttribute

public String getAttribute (String key)

輕鬆擷取叫用結構定義屬性，做為單一鍵/值組合的方法。 永遠不會傳回空值。

參數
key	String

傳回
String	空白字串時，否則該值。

getAttributes

public abstract MultiMap<String, String> getAttributes ()

傳回包含所有叫用屬性的地圖副本。

傳回
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

傳回與所提供裝置設定名稱相關聯的 IBuildInfo。退貨程序 如果無法比對 deviceName，則為空值。

參數
deviceName	String

傳回
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

傳回與 ITestDevice 相關聯的 IBuildInfo

參數
testDevice	ITestDevice

傳回
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

傳回 IBuildInfo 的 XML 設定中設定的裝置名稱。退貨程序 如果無法比對 IBuildInfo，則傳回空值

參數
info	IBuildInfo

傳回
String

getBuildInfos

public abstract  getBuildInfos ()

傳回為此叫用活動追蹤的所有 IBuildInfo。

傳回

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

傳回與啟動叫用的測試設定相關聯的描述元

傳回
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

傳回與所提供裝置設定名稱相關聯的 ITestDevice。

參數
deviceName	String

傳回
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

傳回裝置/版本資訊關聯的地圖

傳回

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

傳回與所提供序列相關聯的 ITestDevice。 查詢最快的速度，因此請避免過度使用。

參數
serial	String

傳回
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

傳回此叫用中追蹤的裝置設定名稱清單

傳回

getDeviceName

public abstract String getDeviceName (ITestDevice device)

傳回 ITestDevice 的 XML 設定中所設定的裝置名稱。 如果無法比對 ITestDevice，則傳回空值。

參數
device	ITestDevice

傳回
String

get 裝置

public abstract  getDevices ()

傳回為此叫用追蹤的所有已分配裝置。

傳回

getInvocationId

public abstract String getInvocationId ()

傳回
String	相關聯的叫用 ID；如果未連結至叫用，則為 null

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

傳回包含叫用時間指標的地圖。

傳回

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

傳回模組在套件中執行時叫用的內容。

傳回
IInvocationContext

getNumDeviceAllocations

public abstract int getNumDevicesAllocated ()

傳回分配給叫用的裝置數量。

傳回
int

getSerials

public abstract  getSerials ()

傳回此叫用中追蹤的裝置序號清單

傳回

getShardsSerials

public abstract  getShardsSerials ()

傳回所有追蹤序列及其資料分割的「地圖」。如果不是，則為空白 進行資料分割叫用。

傳回

getTestTag

public abstract String getTestTag ()

傳回叫用測試標記。

傳回
String

MarkReleasedEarly

public abstract void markReleasedEarly ()

標示裝置即將提早發布。

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

設定與啟動叫用的測試設定相關聯的描述元

參數
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

設定模組做為套件的一部分執行時的叫用內容。

參數
invocationContext	IInvocationContext

setRecoveryModeForAllDevice

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定情境中所有裝置的 RecoveryMode

參數
mode	ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

設定叫用測試標記。

參數
testTag	String

通訊協定

public abstract InvocationContext.Context toProto ()

將結構定義例項序列化為 protobuf。

傳回
InvocationContext.Context

提早發布

public abstract boolean wasReleasedEarly ()

傳回裝置是否提早發布，且不再使用。

傳回
boolean