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

傳回所有追蹤序列及其資料分割的「地圖」。

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