IInvocationContext
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
必要に応じてテストがアクセスするための呼び出しに関する情報を保持します。テストでは、ここに含まれるコンテキストを変更しないでください。そのため、レポート目的のコンテキスト属性を除いて、getter のみが使用可能になります。
まとめ
定数 | |
---|---|
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 () デバイスが早期にリリースされ、今後使用されないかどうかを返します。 |
定数
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)
呼び出し属性を追加します。
パラメーター | |
---|---|
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)
いくつかのテストを実行しているシャードの 1 つに割り当てられたものとして追跡されるシリアルを追加します。
パラメーター | |
---|---|
index | Integer : シリアルを使用したシャードのインデックス |
serials |
getAttribute
public String getAttribute (String key)
呼び出しコンテキスト属性を単一のキーと値のペアとして取得するための便利な方法。 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 |
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
呼び出しを開始したテスト構成に関連付けられた記述子を返します
戻り値 | |
---|---|
ConfigurationDescriptor |
getDevice
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 ()
この呼び出しで追跡されたデバイスのデバイス構成名のリストを返します
戻り値 | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
ITestDevice
からの xml 構成で設定されたデバイスの名前を返します。 ITestDevice が一致しない場合は null を返します。
パラメーター | |
---|---|
device | ITestDevice |
戻り値 | |
---|---|
String |
getDevices
public abstractgetDevices ()
この呼び出しで追跡された、割り当てられたすべてのデバイスを返します。
戻り値 | |
---|---|
getInvocationId
public abstract String getInvocationId ()
戻り値 | |
---|---|
String | 関連付けられた呼び出し ID または呼び出しにリンクされていない場合はnull |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
呼び出しタイミング メトリックを含むマップを返します。
戻り値 | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
スイートの一部として実行されているモジュールの呼び出しコンテキストを返します。
戻り値 | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
呼び出しに割り当てられたデバイスの数を返します。
戻り値 | |
---|---|
int |
getSerials
public abstractgetSerials ()
この呼び出しで追跡されたデバイスのシリアルのリストを返します
戻り値 | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
シャーディングに関係するすべての追跡されたシリアルとそのシャードのマップを返します。分割された呼び出しでない場合は空です。
戻り値 | |
---|---|
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 |
早くリリースされた
public abstract boolean wasReleasedEarly ()
デバイスが早期にリリースされ、今後使用されないかどうかを返します。
戻り値 | |
---|---|
boolean |