本頁面由 Cloud Translation API 翻譯而成。

調用上下文

public class InvocationContext
extends Object implements IInvocationContext

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

IInvocationContext的通用實現。

概括

公共構造函數
`InvocationContext ()` 使用默認屬性值創建`BuildInfo` 。

公共方法
`void`	`addAllocatedDevice ( deviceWithName)` `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)` `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 。

公共方法

添加分配的設備

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`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                 serials)

添加要跟踪的序列，因為它已分配給運行某些測試的分片之一。

參數
`index`	`Integer` : 使用序列號的分片索引
`serials`	：要跟踪的連續劇列表。

來自原型

public static InvocationContext fromProto (InvocationContext.Context protoContext)

對InvocationContext#toProto()進行逆向操作以取回實例。

參數
`protoContext`	`InvocationContext.Context`

退貨
`InvocationContext`

獲取屬性

public MultiMap<String, String> getAttributes ()

返回包含所有調用屬性的地圖副本。

退貨
`MultiMap <String, String>`

獲取構建信息

public IBuildInfo getBuildInfo (String deviceName)

返回與提供的設備配置名稱關聯的IBuildInfo 。如果無法匹配 deviceName，則返回 null。

參數
`deviceName`	`String`

退貨
`IBuildInfo`

獲取構建信息

public IBuildInfo getBuildInfo (ITestDevice testDevice)

返回與ITestDevice關聯的IBuildInfo

參數
`testDevice`	`ITestDevice`

退貨
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

從IBuildInfo返回 xml 配置中的設備集名稱。如果無法匹配 IBuildInfo，則返回 null

參數
`info`	`IBuildInfo`

退貨
`String`

獲取構建信息

public  getBuildInfos ()

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

退貨

獲取配置描述符

public ConfigurationDescriptor getConfigurationDescriptor ()

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

退貨
`ConfigurationDescriptor`

獲取設備

public ITestDevice getDevice (String deviceName)

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

參數
`deviceName`	`String`

退貨
`ITestDevice`

getDeviceBuildMap

public  getDeviceBuildMap ()

返回設備/構建信息關聯的映射

退貨

通過序列號獲取設備

public ITestDevice getDeviceBySerial (String serial)

返回與提供的序列關聯的ITestDevice 。不要使用太多，因為它不是最快的查找。

參數
`serial`	`String`

退貨
`ITestDevice`

獲取設備配置名稱

public  getDeviceConfigNames ()

返回在此調用中跟踪的設備的設備配置名稱列表

退貨

獲取設備名稱

public String getDeviceName (ITestDevice device)

從ITestDevice返回 xml 配置中設置的設備名稱。如果無法匹配 ITestDevice，則返回 null。

參數
`device`	`ITestDevice`

退貨
`String`

獲取設備

public  getDevices ()

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

退貨

getInvocationId

public String getInvocationId ()

退貨
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

退貨
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

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

退貨
`int`

獲取連載

public  getSerials ()

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

退貨

getShardsSerials

public  getShardsSerials ()

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

退貨

獲取測試標籤

public String getTestTag ()

返回調用測試標籤。

退貨
`String`

鎖定屬性

public void lockAttributes ()

鎖定上下文以防止添加更多調用屬性。

日誌調用指標

public void logInvocationMetrics ()

將InvocationMetricLogger屬性記錄到調用中。

標記發布早

public void markReleasedEarly ()

標記設備提前發布。

設置配置描述符

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

參數
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

參數
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

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`