IInvocationContext
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
必要に応じてアクセスするテストの呼び出しに関する情報を保持します。レポート目的のコンテキスト属性を除き、ゲッターのみが使用可能になるように、テストではここに含まれるコンテキストを変更しないでください。
まとめ
定数 | |
---|---|
String | INVOCATION_ID 関連付けられた呼び出し ID を格納するために使用されるキー。 |
パブリックメソッド | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) デバイスが割り当てられたときにメタデータによって追跡される ITestDevice を追加します。 |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) デバイス構成名で追跡される |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) 呼び出し属性を追加します。 |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) 呼び出しタイミングメトリックを追加します。 |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) いくつかのテストを実行しているシャードの 1 つに割り当てられるように追跡するシリアルを追加します。 |
default String | getAttribute (String key) 呼び出しコンテキスト属性を単一のキーと値のペアとして取得するための便利なメソッド。 |
abstract MultiMap <String, String> | getAttributes () すべての呼び出し属性を含むマップのコピーを返します。 |
abstract IBuildInfo | getBuildInfo (String deviceName) 指定されたデバイス構成名に関連付けられた |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) |
abstract String | getBuildInfoName ( IBuildInfo info) |
abstract | getBuildInfos () この呼び出しに関して追跡されたすべての |
abstract ConfigurationDescriptor | getConfigurationDescriptor () 呼び出しを開始したテスト構成に関連付けられた記述子を返します。 |
abstract ITestDevice | getDevice (String deviceName) 指定されたデバイス構成名に関連付けられた |
abstract | getDeviceBuildMap () デバイス/ビルド情報の関連付けのマップを返します |
abstract ITestDevice | getDeviceBySerial (String serial) 提供されたシリアルに関連付けられた |
abstract | getDeviceConfigNames () この呼び出しで追跡されるデバイスのデバイス構成名のリストを返します。 |
abstract String | getDeviceName ( ITestDevice device) |
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) コンテキストのすべてのデバイスの |
abstract void | setTestTag (String testTag) 呼び出しテストタグを設定します。 |
abstract InvocationContext.Context | toProto () コンテキスト インスタンスを protobuf にシリアル化します。 |
abstract boolean | wasReleasedEarly () デバイスが早期にリリースされ、今後使用されないかどうかを返します。 |
定数
呼び出し_ID
public static final String INVOCATION_ID
関連付けられた呼び出し ID を格納するために使用されるキー。
定数値: "呼び出し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)
呼び出し属性を追加します。
パラメーター | |
---|---|
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 |
シャードからシリアルを追加
public abstract void addSerialsFromShard (Integer index,serials)
いくつかのテストを実行しているシャードの 1 つに割り当てられるように追跡するシリアルを追加します。
パラメーター | |
---|---|
index | Integer : シリアルを使用したシャードのインデックス |
serials |
属性の取得
public String getAttribute (String key)
呼び出しコンテキスト属性を単一のキーと値のペアとして取得するための便利なメソッド。決して null を返さないでください。
パラメーター | |
---|---|
key | String |
戻り値 | |
---|---|
String | キーが存在しない場合は空の文字列、それ以外の場合は値。 |
属性の取得
public abstract MultiMap<String, String> getAttributes ()
すべての呼び出し属性を含むマップのコピーを返します。
戻り値 | |
---|---|
MultiMap <String, String> |
ビルド情報の取得
public abstract IBuildInfo getBuildInfo (String deviceName)
指定されたデバイス構成名に関連付けられたIBuildInfo
を返します。 deviceName が一致しない場合は null を返します。
パラメーター | |
---|---|
deviceName | String |
戻り値 | |
---|---|
IBuildInfo |
ビルド情報の取得
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 |
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
呼び出しを開始したテスト構成に関連付けられた記述子を返します。
戻り値 | |
---|---|
ConfigurationDescriptor |
デバイスの取得
public abstract ITestDevice getDevice (String deviceName)
指定されたデバイス構成名に関連付けられたITestDevice
を返します。
パラメーター | |
---|---|
deviceName | String |
戻り値 | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
デバイス/ビルド情報の関連付けのマップを返します
戻り値 | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
提供されたシリアルに関連付けられたITestDevice
を返します。最速の検索ではないため、多用しないようにしてください。
パラメーター | |
---|---|
serial | String |
戻り値 | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
この呼び出しで追跡されるデバイスのデバイス構成名のリストを返します。
戻り値 | |
---|---|
getデバイス名
public abstract String getDeviceName (ITestDevice device)
ITestDevice
から XML 構成に設定されているデバイスの名前を返します。 ITestDevice が一致しない場合は null を返します。
パラメーター | |
---|---|
device | ITestDevice |
戻り値 | |
---|---|
String |
デバイスの取得
public abstractgetDevices ()
この呼び出しに対して追跡されたすべての割り当てられたデバイスを返します。
戻り値 | |
---|---|
getInvocationId
public abstract String getInvocationId ()
戻り値 | |
---|---|
String | 関連付けられた呼び出し ID、または呼び出しにリンクされていない場合はnull |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
呼び出しタイミングメトリクスを含むマップを返します。
戻り値 | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
スイートの一部として実行中のモジュールの呼び出しコンテキストを返します。
戻り値 | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
呼び出しに割り当てられたデバイスの数を返します。
戻り値 | |
---|---|
int |
シリアルを取得する
public abstractgetSerials ()
この呼び出しで追跡されたデバイスのシリアルのリストを返します。
戻り値 | |
---|---|
getShardsシリアル
public abstractgetShardsSerials ()
シャーディングに関与するすべての追跡されたシリアルとそのシャードのマップを返します。シャード呼び出しでない場合は空です。
戻り値 | |
---|---|
テストタグの取得
public abstract String getTestTag ()
呼び出しテストタグを返します。
戻り値 | |
---|---|
String |
マーク早期リリース
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 |
テストタグを設定
public abstract void setTestTag (String testTag)
呼び出しテストタグを設定します。
パラメーター | |
---|---|
testTag | String |
プロトへ
public abstract InvocationContext.Context toProto ()
コンテキスト インスタンスを protobuf にシリアル化します。
戻り値 | |
---|---|
InvocationContext.Context |
早期にリリースされました
public abstract boolean wasReleasedEarly ()
デバイスが早期にリリースされ、今後使用されないかどうかを返します。
戻り値 | |
---|---|
boolean |