呼び出し実行

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

既知の直接サブクラス DelegatedInvocationExecution 、 ParentSandboxInvocationExecution 、 RemoteInvocationExecution 、 SandboxedInvocationExecution DelegatedInvocationExecution 別の Tradefed バイナリに実行を委譲するInvocationExecution 。 親サンドボックス呼び出し実行 サンドボックス実行時の親呼び出しの特別なアクションのInvocationExecutionのバージョン。 リモート呼び出し実行 リモート実行を駆動するInvocationExecutionの実装。 SandboxedInvocationExecution 呼び出しの特別なサンドボックス実行: これは、コマンドを実行しているサンドボックス内にいるときの InvocationExection です。

---

ダウンロードのビルド、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) 呼び出しのデバイス部分ごとにITestDevice#postInvocationTearDown(Throwable)を呼び出します。
void	runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) 呼び出しのデバイス部分ごとにERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))呼び出します。
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 () 使用するIShardHelperを返すを作成します。
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)

呼び出しのデバイス部分ごとにERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))呼び出します。

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

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

このデバイスで実行するラボ準備ツールのリストを取得します。

ラボ準備ツールがサンドボックスの子内で実行されないように制限するために、サンドボックス クラスでオーバーライドされます。

パラメーター
config	IConfiguration
deviceName	String

戻り値

getTargetPreparersToRun

protected  getTargetPreparersToRun (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