IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

呼び出しの一部として実行されるアクションを記述するインターフェース。呼び出し TestInvocation 自体が呼び出しの順序を保証します。

概要

パブリック メソッド

default void cleanUpBuilds(IInvocationContext context, IConfiguration config)

build_provider のクリーンアップ ステップを実行します。
default void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

target_preparer と multi_target_preparer の cleanUp ステップを実行します。
default void doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)

target_preparer と multi_target_preparer の setUp ステップを実行します。
default void doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

target_preparer と multi_target_preparer のティアダウン ステップを実行します。
default boolean fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

呼び出しの build_provider ステップを実行します。
abstract void reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)

呼び出しのさまざまな段階でデバイスログをレポートします。

default void runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)

呼び出しのデバイス部分ごとに ITestDevice.postInvocationTearDown(Throwable) を呼び出します。
default 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)) を呼び出します。
default void runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)

テストを実行します。
default boolean shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

構成をサブ構成にシャーディングし、複数のリソースで並行して実行するように再スケジュールしようとします。

パブリック メソッド

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 logger)

target_preparer と multi_target_preparer の setUp ステップを実行します。テストの実行に必要なすべてのデバイス設定を行います。

パラメータ
testInfo TestInformation: 呼び出しの TestInformation。
config IConfiguration: このテスト実行の IConfiguration。
logger ITestLogger: 設定失敗ログを報告する ITestLogger。
例外
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.BuildError
com.android.tradefed.targetprep.TargetSetupError
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: テスト実行によってスローされた元の例外。
例外
java.lang.Throwable
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。
例外
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

呼び出しのさまざまな段階でデバイスログをレポートします。例: logcat。

パラメータ
device ITestDevice: ログを報告するデバイス。
logger 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。
例外
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

runTests

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

テストを実行します。

パラメータ
info TestInformation: テストの実行に使用する TestInformation。
config IConfiguration: 実行する IConfiguration
listener ITestInvocationListener: テスト結果の ITestInvocationListener
例外
java.lang.Throwable
Throwable

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