叫用內容

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

---

IInvocationContext 的一般實作。

摘要

公用建構函式
InvocationContext() 使用預設屬性值建立 BuildInfo。

公用方法
void	addAllocatedDevice( deviceWithName) 追蹤與 ITestDevice 相關聯的設定裝置名稱對應。
void	addAllocatedDevice(String devicename, ITestDevice testDevice) 新增要在裝置分配時，中繼資料追蹤的 ITestDevice。
void	addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo) 新增要使用裝置設定名稱追蹤的 IBuildInfo。
void	addInvocationAttribute(String attributeName, String attributeValue) 新增叫用屬性。
void	addInvocationAttributes(MultiMap<String, String> attributesMap) 透過 UniqueMultiMap 一次新增多個叫用屬性。
void	addSerialsFromShard(Integer index, serials) 新增序列，系統會將該序列指派給執行部分測試的其中一個資料分割。
static InvocationContext	fromProto(InvocationContext.Context protoContext) 對 InvocationContext#toProto() 進行反向作業，取回執行個體。
MultiMap<String, String>	getAttributes() 傳回包含所有叫用屬性的地圖副本。
IBuildInfo	getBuildInfo(String deviceName) 傳回與所提供裝置設定名稱相關聯的 IBuildInfo。
IBuildInfo	getBuildInfo(ITestDevice testDevice) 傳回與 ITestDevice 相關聯的 IBuildInfo
String	getBuildInfoName(IBuildInfo info) 傳回 IBuildInfo 的 XML 設定中設定的裝置名稱。
	getBuildInfos() 傳回為此叫用活動追蹤的所有 IBuildInfo。
ConfigurationDescriptor	getConfigurationDescriptor() 傳回與啟動叫用的測試設定相關聯的描述元
ITestDevice	getDevice(String deviceName) 傳回與所提供裝置設定名稱相關聯的 ITestDevice。
	getDeviceBuildMap() 傳回裝置/版本資訊關聯的地圖
ITestDevice	getDeviceBySerial(String serial) 傳回與所提供序列相關聯的 ITestDevice。
	getDeviceConfigNames() 傳回此叫用中追蹤的裝置設定名稱清單
String	getDeviceName(ITestDevice device) 傳回 ITestDevice 的 XML 設定中所設定的裝置名稱。
	getDevices() 傳回為此叫用追蹤的所有已分配裝置。
String	getInvocationId()
IInvocationContext	getModuleInvocationContext() 傳回模組在套件中執行時叫用的內容。
int	getNumDevicesAllocated() 傳回分配給叫用的裝置數量。
	getSerials() 傳回此叫用中追蹤的裝置序號清單
	getShardsSerials() 傳回所有追蹤序列及其資料分割的「地圖」。
String	getTestTag() 傳回叫用測試標記。
void	lockAttributes() 鎖定結構定義，即可避免加入更多叫用屬性。
void	logInvocationMetrics() 將 InvocationMetricLogger 屬性記錄到叫用。
void	markReleasedEarly() 標示裝置即將提早發布。
void	setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor) 設定與啟動叫用的測試設定相關聯的描述元
void	setModuleInvocationContext(IInvocationContext invocationContext) 設定模組做為套件的一部分執行時的叫用內容。
void	setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode) 設定情境中所有裝置的 RecoveryMode
void	setTestTag(String testTag) 設定叫用測試標記。
InvocationContext.Context	toProto() 將結構定義例項序列化為 protobuf。
boolean	wasReleasedEarly() 傳回裝置是否提早發布，且不再使用。

公用建構函式

叫用內容

public InvocationContext ()

使用預設屬性值建立 BuildInfo。

公用方法

addAllocationsDevice

public void addAllocatedDevice ( deviceWithName)

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

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

addAllocationsDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

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

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

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

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

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

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

新增叫用屬性。

參數
attributeName	String
attributeValue	String

addInvocationAttributes

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

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

參數
attributesMap	MultiMap

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                 serials)

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

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

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

對 InvocationContext#toProto() 進行反向作業，取回執行個體。

參數
protoContext	InvocationContext.Context

傳回
InvocationContext

getAttributes

public MultiMap<String, String> getAttributes ()

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

傳回
MultiMap<String, String>

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

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

參數
deviceName	String

傳回
IBuildInfo

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

傳回與 ITestDevice 相關聯的 IBuildInfo

參數
testDevice	ITestDevice

傳回
IBuildInfo

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

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

參數
info	IBuildInfo

傳回
String

getBuildInfos

public  getBuildInfos ()

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

傳回

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

傳回
ConfigurationDescriptor

getDevice

public ITestDevice getDevice (String deviceName)

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

參數
deviceName	String

傳回
ITestDevice

getDeviceBuildMap

public  getDeviceBuildMap ()

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

傳回

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

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

參數
serial	String

傳回
ITestDevice

getDeviceConfigNames

public  getDeviceConfigNames ()

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

傳回

getDeviceName

public String getDeviceName (ITestDevice device)

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

參數
device	ITestDevice

傳回
String

get 裝置

public  getDevices ()

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

傳回

getInvocationId

public String getInvocationId ()

傳回
String

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

傳回
IInvocationContext

getNumDeviceAllocations

public int getNumDevicesAllocated ()

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

傳回
int

getSerials

public  getSerials ()

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

傳回

getShardsSerials

public  getShardsSerials ()

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

傳回

getTestTag

public String getTestTag ()

傳回叫用測試標記。

傳回
String

鎖定屬性

public void lockAttributes ()

鎖定結構定義，即可避免加入更多叫用屬性。

logInvocationMetrics

public void logInvocationMetrics ()

將 InvocationMetricLogger 屬性記錄到叫用。

MarkReleasedEarly

public void markReleasedEarly ()

標示裝置即將提早發布。

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

參數
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

參數
invocationContext	IInvocationContext

setRecoveryModeForAllDevice

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定情境中所有裝置的 RecoveryMode

參數
mode	ITestDevice.RecoveryMode

setTestTag

public void setTestTag (String testTag)

設定叫用測試標記。

參數
testTag	String

通訊協定

public InvocationContext.Context toProto ()

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

傳回
InvocationContext.Context

提早發布

public boolean wasReleasedEarly ()

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

傳回
boolean