InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

---

呼び出しのすべてのステップ（ビルドのダウンロード、target_prep、テストの実行、クリーンアップ）を記述するクラス。一部のステップのデフォルトの動作をオーバーライドするために拡張できます。ステップの順序は TestInvocation によって決まります。

概要

定数
String	ADB_VERSION_KEY
String	JAVA_CLASSPATH_KEY
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	linkExternalDirs(IBuildInfo info, TestInformation testInfo)
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)
void	setTestTag(IBuildInfo info, IConfiguration config) ビルド情報にテストタグを設定する処理。

定数

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

定数値: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

定数値: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

定数値: "java_version"

パブリック コンストラクタ

InvocationExecution

public InvocationExecution ()

パブリック メソッド

cleanUpBuilds

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: テスト実行によってスローされた元の例外。

fetchBuild

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

reportLogs

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

戻り値

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

パラメータ
info	IBuildInfo
testInfo	TestInformation

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