TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

ITestInvocation のデフォルト実装。

IConfiguration に基づいて主要なオブジェクトを読み込む - ビルドを取得する - ターゲットを準備する - テストを実行する - 結果をレポートする

概要

定数

long AVAILABILITY_CHECK_TIMEOUT

String COMMAND_ARGS_KEY

コマンドライン引数属性のキー

String INVOCATION_EXTERNAL_DEPENDENCIES

String TRADEFED_CONFIG_NAME

String TRADEFED_END_HOST_LOG

String TRADEFED_INVOC_COMPLETE_HOST_LOG

String TRADEFED_LOG_NAME

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

TestInvocation()

パブリック メソッド

static IBuildInfo backFillBuildInfoForReporting(String commandLine)

ダウンロードが失敗した場合に、コマンドラインを使用してレポート用の IBuildInfo をバックフィルするヘルパー。
static FailureDescription createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)

呼び出し例外から FailureDescription を作成します。
IInvocationExecution createInvocationExec(TestInvocation.RunMode mode)

従うべき呼び出しパスを作成します。
static String getDeviceLogName(TestInvocation.Stage stage)
static String getEmulatorLogName(TestInvocation.Stage stage)
ITestInvocation.ExitInformation getExitInfo()

指定された呼び出しの終了情報。

void invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)

テスト呼び出しを実行します。
static boolean isSubprocess(IConfiguration config)

呼び出しが現在サブプロセス スコープ内にある場合は true を返します。
void notifyInvocationForceStopped(String message, ErrorIdentifier errorId)

TradeFed に停止がリクエストされたことを TestInvocation に通知します。
void notifyInvocationStopped(String message)

TradeFed が最終的にシャットダウンすることを TestInvocation に通知します。
static void printStageDelimiter(TestInvocation.Stage phase, boolean end)

呼び出しの特定の Stage の区切り文字を出力します。
void registerExecutionFiles(ExecutionFiles executionFiles)
void setClearcutClient(ClearcutClient client)

クリアカット クライアントを転送して指標をレポートします。

static boolean shouldSkipBugreportError(Throwable t)

バグレポートをスキップする必要がある場合にエラーを特定するヘルパー メソッド
String toString()

保護されたメソッド

void addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, String value)
void addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, long value)
void applyAutomatedReporters(IConfiguration config)
void setExitCode(CommandRunner.ExitCode code, Throwable stack)

終了コードを設定するヘルパー。

定数

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

定数値: 180000 (0x000000000002bf20)

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

コマンドライン引数属性のキー

定数値: "command_line_args"

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

定数値: "invocation-external-dependencies"

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

定数値: "tradefed-expanded-config"

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

定数値: "end_host_log"

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

定数値: "invoc_complete_host_log"

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

定数値: "host_log"

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

TestInvocation

public TestInvocation ()

パブリック メソッド

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

ダウンロードが失敗した場合に、コマンドラインを使用してレポート用の IBuildInfo をバックフィルするヘルパー。

パラメータ
commandLine String

戻り値
IBuildInfo

createFailureFromException

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

呼び出し例外から FailureDescription を作成します。

パラメータ
exception Throwable: 変換する例外
defaultStatus TestRecordProto.FailureStatus: 例外が IHarnessException でない場合にデフォルトで使用するステータス。
戻り値
FailureDescription

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

従うべき呼び出しパスを作成します。

パラメータ
mode TestInvocation.RunMode: 現在実行中のモード。
戻り値
IInvocationExecution 呼び出しを記述する IInvocationExecution。

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

パラメータ
stage TestInvocation.Stage

戻り値
String

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

パラメータ
stage TestInvocation.Stage

戻り値
String

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

指定された呼び出しの終了情報。

戻り値
ITestInvocation.ExitInformation

呼び出す

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

テスト呼び出しを実行します。

パラメータ
context IInvocationContext: テストを実行する IInvocationContext。
config IConfiguration: このテスト実行の IConfiguration。
rescheduler IRescheduler: IRescheduler。別のリソースで実行するために呼び出しの一部を再スケジュールします。
extraListeners ITestInvocationListener: config の他に通知する ITestInvocationListener
例外
DeviceNotAvailableException

isSubprocess

public static boolean isSubprocess (IConfiguration config)

呼び出しが現在サブプロセス スコープ内にある場合は true を返します。

パラメータ
config IConfiguration

戻り値
boolean

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

TradeFed の停止がリクエストされたことを TestInvocation に通知します。

パラメータ
message String: 呼び出しの停止に関連付けられたメッセージ
errorId ErrorIdentifier: 強制停止に関連付けられた識別子

notifyInvocationStopped

public void notifyInvocationStopped (String message)

TradeFed が最終的にシャットダウンすることを TestInvocation に通知します。

パラメータ
message String: 呼び出しの停止に関連付けられたメッセージ

printStageDelimiter

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

呼び出しの特定の Stage の区切り文字を出力します。

パラメータ
phase TestInvocation.Stage

end boolean

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

パラメータ
executionFiles ExecutionFiles

setClearcutClient

public void setClearcutClient (ClearcutClient client)

指標をレポートするクリアカット クライアントを転送します。

パラメータ
client ClearcutClient

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

バグレポートをスキップすべき場合のエラーを特定するヘルパー メソッド

パラメータ
t Throwable

戻り値
boolean

toString

public String toString ()

戻り値
String

保護されたメソッド

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

パラメータ
key InvocationMetricLogger.InvocationMetricKey

value String

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

パラメータ
key InvocationMetricLogger.InvocationMetricKey

value long

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

パラメータ
config IConfiguration

setExitCode

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

終了コードを設定するヘルパー。テスト用に公開されています。

パラメータ
code CommandRunner.ExitCode

stack Throwable