IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

既知の間接的なサブクラス InvocationContext InvocationContext IInvocationContext の汎用実装。

---

必要に応じてテストがアクセスする呼び出しに関する情報を保持します。テストでは、ここに含まれるコンテキストを変更しないようにする必要があります。そのため、レポート用のコンテキスト属性を除き、ゲッターのみを使用できます。

概要

定数
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) Invocation 属性を追加します。
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) 呼び出しコンテキスト属性を 1 つの Key-Value ペアとして取得するための便利なメソッドです。
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"

パブリック メソッド

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

ITestDevice に関連付けられた構成デバイス名のマップを追跡します。追加前に以前のトラッキングを消去しません。

パラメータ
deviceWithName	: 追跡する追加デバイスの ERROR(/Map)

addAllocatedDevice

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)

Invocation 属性を追加します。

パラメータ
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)

呼び出しコンテキスト属性を 1 つの Key-Value ペアとして取得するのに便利なメソッドです。null を返さないでください。

パラメータ
key	String

戻り値
String	キーが存在しない場合、空の文字列。存在する場合は値。

getAttributes

public abstract MultiMap<String, String> getAttributes ()

すべての呼び出し属性を含むマップのコピーを返します。

戻り値
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

指定されたデバイス構成名に関連付けられている IBuildInfo を返します。deviceName が一致しない場合は null を返します。

パラメータ
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 を照合できない場合は null を返します。

パラメータ
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 を照合できない場合は null を返します。

パラメータ
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 ()

シャーディングに関連するすべての追跡済みシリアルとシャードのマップを返します。シャーディングされた呼び出しでない場合は空になります。

戻り値

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