呼び出し実行

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.オブジェクト
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)

呼び出しのデバイス部分ごとに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

クリーンアップする

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

分解する

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

テストを実行する

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

テストを実行します。

パラメーター
info TestInformation : テストを実行するためのTestInformation

config IConfiguration : 実行するIConfiguration

listener ITestInvocationListener : テスト結果のITestInvocationListener

シャード構成

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を返します

保護されたメソッド

自動情報の収集

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

テスト対象のプライマリ デバイスに関する一部の情報を自動的に収集します。

パラメーター
config IConfiguration

info TestInformation

投げる
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

使用するIShardHelperを返すように作成します。

戻り値
IShardHelper

カスタマイズDevicePreInvocation

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

実行準備者引き裂く

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

テストタグを設定

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

ビルド情報に対するテストタグの設定を処理します。

パラメーター
info IBuildInfo

config IConfiguration