InvocationContext

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

傳回所有已追蹤序列與分割作業中涉及的分割項目的 Map。

String getTestTag()

傳回叫用測試標記。

static boolean isPresubmit(IInvocationContext context)

傳回是否根據觸發條件類型偵測預提交。

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

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

公用建構函式

InvocationContext

public InvocationContext ()

使用預設屬性值建立 BuildInfo

公用方法

addAllocationsDevice

public void addAllocatedDevice ( deviceWithName)

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

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

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

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

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

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

getDevices

public  getDevices ()

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

傳回

getInvocationId

public String getInvocationId ()

傳回
String

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

傳回
IInvocationContext

getNumDeviceAllocations

public int getNumDevicesAllocated ()

傳回為叫用作業分配的裝置數量。

傳回
int

getSerials

public  getSerials ()

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

傳回

getShardsSerials

public  getShardsSerials ()

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

傳回

getTestTag

public String getTestTag ()

傳回叫用測試標記。

傳回
String

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

傳回是否根據觸發條件類型偵測預先提交。

參數
context IInvocationContext

傳回
boolean

lockAttributes

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

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

設定上下文中所有裝置部分的 RecoveryMode

參數
mode ITestDevice.RecoveryMode

setTestTag

public void setTestTag (String testTag)

設定叫用測試標記。

參數
testTag String

toProto

public InvocationContext.Context toProto ()

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

傳回
InvocationContext.Context

提早發布

public boolean wasReleasedEarly ()

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

傳回
boolean