呼び出し実行
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
ダウンロードのビルド、target_prep、テストの実行、クリーンアップなど、すべての呼び出し手順を記述するクラス。一部のステップのデフォルトの動作をオーバーライドするように拡張できます。ステップの順序はTestInvocation
によって決定されます。
まとめ
田畑 | |
---|---|
public static final String | ADB_VERSION_KEY |
public static final String | JAVA_CLASSPATH_KEY |
public static final String | JAVA_VERSION_KEY
|
パブリック コンストラクター | |
---|---|
InvocationExecution () |
公開メソッド | |
---|---|
void | cleanUpBuilds ( IInvocationContext context, IConfiguration config) build_provider のクリーンアップ手順を実行します。 |
void | doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception) target_preparer および multi_target_preparer cleanUp ステップを実行します。 |
void | doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) target_preparer および multi_target_preparer の setUp ステップを実行します。 |
void | doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) target_preparer および multi_target_preparer のティアダウン ステップを実行します。 |
boolean | fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) 呼び出しの build_provider ステップを実行します。 |
void | reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) 呼び出しのさまざまな段階でいくつかのデバイス ログを報告します。 |
void | runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception) 呼び出しのデバイス部分ごとに |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) |
void | runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener) テストを実行します。 |
boolean | shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) 複数のリソースで並行して実行するように再スケジュールするために、構成をサブ構成に分割しようとします。 |
保護されたメソッド | |
---|---|
void | collectAutoInfo ( IConfiguration config, TestInformation info) テスト対象のプライマリ デバイスに関する情報を自動的に収集します。 |
IShardHelper | createShardHelper () 使用する |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) preInvocationSetup の前に、デバイスの一部をカスタマイズする機会を与えます。 |
String | getAdbVersion () 呼び出しに使用されている adb のバージョンを返します。 |
getLabPreparersToRun ( IConfiguration config, String deviceName) このデバイスで実行するラボ準備ツールのリストを取得します。 | |
getTargetPreparersToRun ( IConfiguration config, String deviceName) このデバイスで実行するターゲット作成プログラムのリストを取得します。 | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) $TMPDIR/adb.$UID.log からログを収集します。 |
Throwable | runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) |
void | setTestTag ( IBuildInfo info, IConfiguration config) ビルド情報でのテスト タグの設定を処理します。 |
田畑
ADB_VERSION_KEY
public static final String ADB_VERSION_KEY
JAVA_CLASSPATH_KEY
public static final String JAVA_CLASSPATH_KEY
JAVA_VERSION_KEY
public static final String JAVA_VERSION_KEY
パブリック コンストラクター
呼び出し実行
public InvocationExecution ()
公開メソッド
クリーンアップビルド
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
build_provider のクリーンアップ手順を実行します。ビルドのフェッチに関連付けられています。
パラメーター | |
---|---|
context | IInvocationContext : 呼び出しのIInvocationContext 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
target_preparer および multi_target_preparer cleanUp ステップを実行します。デバイスをクリーンアップしますか。
パラメーター | |
---|---|
context | IInvocationContext : 呼び出しのIInvocationContext 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
exception | Throwable : テストの実行によってスローされた元の例外。 |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
target_preparer および multi_target_preparer の setUp ステップを実行します。テストの実行に必要なすべてのデバイスのセットアップを行います。
パラメーター | |
---|---|
testInfo | TestInformation : 呼び出しのTestInformation 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
listener | ITestLogger : セットアップ失敗ログを報告するITestLogger 。 |
スロー | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
doTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
target_preparer および multi_target_preparer のティアダウン ステップを実行します。セットアップに関連するデバイスは破棄されますか。
パラメーター | |
---|---|
testInfo | TestInformation : 呼び出しのTestInformation 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
logger | ITestLogger : ログを報告するITestLogger 。 |
exception | Throwable : テストの実行によってスローされた元の例外。 |
フェッチビルド
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
呼び出しの build_provider ステップを実行します。
パラメーター | |
---|---|
testInfo | TestInformation : 呼び出しのTestInformation 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
rescheduler | IRescheduler : 別のリソースで実行するために呼び出しの一部を再スケジュールするためのIRescheduler |
listener | ITestInvocationListener : ビルドのダウンロードの失敗を報告するITestInvocation 。 |
戻り値 | |
---|---|
boolean | ビルドのダウンロードに成功した場合は true、それ以外の場合は false。 |
スロー | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
レポートログ
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
呼び出しのさまざまな段階でいくつかのデバイス ログを報告します。例: logcat.
パラメーター | |
---|---|
device | ITestDevice : ログを報告するデバイス。 |
listener | ITestLogger : ログのロガー。 |
stage | TestInvocation.Stage : 現在の呼び出しの段階。 |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
呼び出しのデバイス部分ごとにITestDevice#postInvocationTearDown(Throwable)
を呼び出します。
パラメーター | |
---|---|
context | IInvocationContext : 呼び出しのIInvocationContext 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
exception | Throwable : 実行中のテストによってスローされた元の例外 (存在する場合)。 |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
パラメーター | |
---|---|
context | IInvocationContext : 呼び出しのIInvocationContext 。 |
config | IConfiguration : このテスト実行のIConfiguration 。 |
logger | ITestLogger : ログを報告するITestLogger 。 |
スロー | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
runTests
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
テストを実行します。
パラメーター | |
---|---|
info | TestInformation : テストを実行するためのTestInformation 。 |
config | IConfiguration : 実行するIConfiguration |
listener | ITestInvocationListener : テスト結果のITestInvocationListener |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
複数のリソースで並行して実行するように再スケジュールするために、構成をサブ構成に分割しようとします。
シャード数が 1 より大きい場合、シャード インデックスを設定して再スケジュールすることで、各シャードの構成を作成するだけです。シャード数が設定されていない場合は、 IShardHelper#shardConfig
にフォールバックします。
パラメーター | |
---|---|
config | IConfiguration : 現在のIConfiguration 。 |
testInfo | TestInformation : テストの情報を保持するTestInformation 。 |
rescheduler | IRescheduler : IRescheduler 。 |
logger | ITestLogger : シャーディング中にファイルをログに記録するために使用されるITestLogger 。 |
戻り値 | |
---|---|
boolean | テストが分割された場合は true。それ以外の場合はfalse を返します |
保護されたメソッド
collectAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
テスト対象のプライマリ デバイスに関する情報を自動的に収集します。
パラメーター | |
---|---|
config | IConfiguration |
info | TestInformation |
スロー | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
使用するIShardHelper
を返すを作成します。
戻り値 | |
---|---|
IShardHelper |
CustomizeDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
preInvocationSetup の前に、デバイスの一部をカスタマイズする機会を与えます。
パラメーター | |
---|---|
config | IConfiguration : 呼び出しの構成。 |
context | IInvocationContext : 現在の呼び出しコンテキスト。 |
getAdbVersion
protected String getAdbVersion ()
呼び出しに使用されている adb のバージョンを返します。
戻り値 | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
このデバイスで実行するラボ準備ツールのリストを取得します。
ラボ準備ツールがサンドボックスの子内で実行されないように制限するために、サンドボックス クラスでオーバーライドされます。
パラメーター | |
---|---|
config | IConfiguration |
deviceName | String |
戻り値 | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
このデバイスで実行するターゲット作成プログラムのリストを取得します。
ラボ準備ツールがサンドボックスの子内で実行されないように制限するために、サンドボックス クラスでオーバーライドされます。
パラメーター | |
---|---|
config | IConfiguration |
deviceName | String |
戻り値 | |
---|---|
logHostAdb
protected void logHostAdb (IConfiguration config, ITestLogger logger)
$TMPDIR/adb.$UID.log からログを収集します。
パラメーター | |
---|---|
config | IConfiguration |
logger | ITestLogger |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun, trackPreparersMap)
パラメーター | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun | |
trackPreparersMap |
戻り値 | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
ビルド情報でのテスト タグの設定を処理します。
パラメーター | |
---|---|
info | IBuildInfo |
config | IConfiguration |