IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.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()

傳回所有已追蹤序列的 Map，以及分割作業中涉及的分割區。
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"

公用方法

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

追蹤與 ITestDevice 相關聯的設定裝置名稱對應表。新增前不會清除先前的追蹤。

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

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

新增 ITestDevice，以便在裝置分配時由中繼資料追蹤。會將建構資訊設為地圖中的空值。

參數
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 的區塊索引
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

getDevices

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

getSerials

public abstract  getSerials ()

傳回在這個叫用中追蹤的裝置序號清單

傳回

getShardsSerials

public abstract  getShardsSerials ()

傳回所有已追蹤序列的 Map，以及分割作業中涉及的分割區。如果不是分割的叫用，則為空白。

傳回

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

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定情境中所有裝置部分的 RecoveryMode

參數
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

設定叫用測試標記。

參數
testTag String

toProto

public abstract InvocationContext.Context toProto ()

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

傳回
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

傳回裝置是否提前釋出，且不會再使用。

傳回
boolean