SubprocessResultsReporter
public
class
SubprocessResultsReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
result_reporter として指定され、転送元として指定される ITestInvocationListener
を実装します。
テスト、テスト実行、テスト呼び出しの結果をサブプロセスします。
概要
パブリック コンストラクタ | |
---|---|
SubprocessResultsReporter()
|
パブリック メソッド | |
---|---|
void
|
close()
|
TestSummary
|
getSummary()
InvocationListener がサマリーを返すことを許可します。 |
void
|
invocationEnded(long elapsedTime)
正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。 |
void
|
invocationFailed(FailureDescription failure)
エラー条件により不完全な呼び出しを報告します。 |
void
|
invocationFailed(Throwable cause)
エラー条件により不完全な呼び出しを報告します。 |
void
|
invocationStarted(IInvocationContext context)
テスト呼び出しの開始を報告します。 |
void
|
logAssociation(String dataName, LogFile logFile)
ログとテストケースとの関連性が強く求められる場合がありますが、
直線の |
void
|
printEvent(String key, Object event)
イベントキーと JSON オブジェクトを出力するヘルパー。 |
void
|
setOutputTestLog(boolean outputTestLog)
ログに記録されたテストを出力するかどうかを設定します。 |
boolean
|
supportGranularResults()
レポーターが詳細な結果をサポートしている場合は true、それ以外の場合は false を返します。 |
void
|
testAssumptionFailure(TestDescription testId, String trace)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます |
void
|
testAssumptionFailure(TestDescription testId, FailureDescription failure)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます |
void
|
testEnded(TestDescription testId, long endTime,
終了時間を指定できる |
void
|
testEnded(TestDescription testId,
個々のテストケースの実行終了を報告します。 |
void
|
testFailed(TestDescription testId, FailureDescription failure)
個々のテストケースの失敗を報告します。 |
void
|
testFailed(TestDescription testId, String reason)
個々のテストケースの失敗を報告します。 |
void
|
testIgnored(TestDescription testId)
テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。 |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
テスト呼び出しの関連ログまたはデバッグデータを提供します。 |
void
|
testModuleEnded()
モジュール実行の終了をレポートします。 |
void
|
testModuleStarted(IInvocationContext moduleContext)
実行中のモジュールの開始を報告します。 |
void
|
testRunEnded(long time,
テスト実行の終了をレポートします。 |
void
|
testRunFailed(FailureDescription failure)
|
void
|
testRunFailed(String reason)
致命的なエラーのため、テスト実行を完了できなかったことをレポートします。 |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
テスト実行の開始を報告します。 |
void
|
testRunStarted(String runName, int testCount)
テスト実行の開始を報告します。 |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
テスト実行の開始を報告します。 |
void
|
testRunStopped(long arg0)
ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。 |
void
|
testSkipped(TestDescription testId, SkipReason reason)
テストがスキップされ、通常は予期されない理由でテストが実行されなかった場合に呼び出されます。 |
void
|
testStarted(TestDescription testId, long startTime)
|
void
|
testStarted(TestDescription testId)
個々のテストケースの開始を報告します。 |
パブリック コンストラクタ
SubprocessResultsReporter
public SubprocessResultsReporter ()
パブリック メソッド
閉じる
public void close ()
getSummary
public TestSummary getSummary ()
InvocationListener がサマリーを返すことを許可します。
戻り値 | |
---|---|
TestSummary |
実行を要約した TestSummary 、または null |
invocationEnded
public void invocationEnded (long elapsedTime)
正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。
TradeFederation フレームワークによって自動的に呼び出されます。
パラメータ | |
---|---|
elapsedTime |
long : 呼び出しの経過時間(ミリ秒) |
invocationFailed
public void invocationFailed (FailureDescription failure)
エラー条件により不完全な呼び出しを報告します。
TradeFederation フレームワークによって自動的に呼び出されます。
パラメータ | |
---|---|
failure |
FailureDescription : 失敗の原因を説明する FailureDescription |
invocationFailed
public void invocationFailed (Throwable cause)
エラー条件により不完全な呼び出しを報告します。
TradeFederation フレームワークによって自動的に呼び出されます。
パラメータ | |
---|---|
cause |
Throwable : 失敗の Throwable 原因 |
invocationStarted
public void invocationStarted (IInvocationContext context)
テスト呼び出しの開始を報告します。
TradeFederation フレームワークによって自動的に呼び出されます。レポーターはオーバーライドする必要があります 複数のデバイスのレポートに対応できます。
パラメータ | |
---|---|
context |
IInvocationContext : 呼び出しに関する情報 |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
ログとテストケースとの関連性が強く求められる場合がありますが、
直線の testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
です。
できません。したがって、このコールバックを使用すると、
明示的に指定することもできます。
パラメータ | |
---|---|
dataName |
String : データの名前 |
logFile |
LogFile : 以前にログに記録された LogFile に関連付ける必要があります。
テストケースです |
printEvent
public void printEvent (String key, Object event)
イベントキーと JSON オブジェクトを出力するヘルパー。
パラメータ | |
---|---|
key |
String |
event |
Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
ログに記録されたテストを出力するかどうかを設定します。
パラメータ | |
---|---|
outputTestLog |
boolean |
supportGranularResults
public boolean supportGranularResults ()
レポーターが詳細な結果をサポートしている場合は true、それ以外の場合は false を返します。
戻り値 | |
---|---|
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
trace |
String : 障害のスタック トレース |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
failure |
FailureDescription : エラーとそのコンテキストを記述する FailureDescription 。 |
testEnded
public void testEnded (TestDescription testId, long endTime,metrics)
終了時間を指定できる ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
の代替
直接渡されます。testStarted(com.android.tradefed.result.TestDescription, long)
と組み合わせて使用すると、正確に測定できます。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
endTime |
long : テストが終了した時刻(System.currentTimeMillis() で測定) |
metrics |
: 出力された指標の ERROR(/Map) |
testEnded
public void testEnded (TestDescription testId,metrics)
個々のテストケースの実行終了を報告します。
testFailed(TestDescription, FailureDescription)
が呼び出されなかった場合、このテストは合格です。また、任意の Key-Value を返します。
テストケースの実行中に出力された可能性のある指標を示します。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
metrics |
: 出力された指標の ERROR(/Map) |
testFailed
public void testFailed (TestDescription testId, FailureDescription failure)
個々のテストケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
failure |
FailureDescription : エラーとそのコンテキストを記述する FailureDescription 。 |
testFailed
public void testFailed (TestDescription testId, String reason)
個々のテストケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
reason |
String : 障害のスタック トレース |
testIgnored
public void testIgnored (TestDescription testId)
テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
テスト呼び出しの関連ログまたはデバッグデータを提供します。
ERROR(/ITestInvocationListener#invocationFailed(Throwable))
または
ERROR(/ITestInvocationListener#invocationEnded(long))
TradeFederation フレームワークは自動的にこのメソッドを呼び出し、ホストログを提供します。 デバイスの logcat(該当する場合)
パラメータ | |
---|---|
dataName |
String : String でデータのわかりやすい名前。例:「device_logcat」。備考
dataName は呼び出しごとに一意であってはなりません。つまり 実装担当者は
同じ dataName を持つ複数の呼び出し |
dataType |
LogDataType : データの LogDataType |
dataStream |
InputStreamSource : データの InputStreamSource 。実装担当者は
createInputStream を実装してデータの読み取りを開始し、
InputStream。呼び出し元は、データソースが確実に
存在し、testLog メソッドが完了するまでアクセスできます。 |
testModuleEnded
public void testModuleEnded ()
モジュール実行の終了をレポートします。
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
実行中のモジュールの開始を報告します。このコールバックは testModuleEnded()
に関連付けられており、シーケンスでは省略可能です。これは、Pod を使用する実行時にのみ
スイートベースのランナーです。
パラメータ | |
---|---|
moduleContext |
IInvocationContext : モジュールの IInvocationContext 。 |
testRunEnded
public void testRunEnded (long time,runMetrics)
テスト実行の終了をレポートします。修正: 2 つの Map<> は使用できないインターフェースが異なるため、 ここでは HashMap を使用する必要があります。
パラメータ | |
---|---|
time |
long : デバイスで報告された経過時間(ミリ秒単位) |
runMetrics |
: Metric を使用してテスト実行終了時にレポートされる Key-Value ペア。 |
testRunFailed
public void testRunFailed (FailureDescription failure)
FailureDescription
で説明されているエラーのため、テスト実行を完了できなかったことをレポートします。
パラメータ | |
---|---|
failure |
FailureDescription : エラーとそのコンテキストを記述する FailureDescription 。 |
testRunFailed
public void testRunFailed (String reason)
致命的なエラーのため、テスト実行を完了できなかったことをレポートします。
パラメータ | |
---|---|
reason |
String : 実行失敗の理由を説明する String 。 |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
テスト実行の開始を報告します。
パラメータ | |
---|---|
runName |
String : テスト実行名 |
testCount |
int : テスト実行中のテストの合計数 |
attemptNumber |
int : 同じ runName の異なる試行を識別する注文番号
実行されるリソースのことですtryNumber の値は、0 から始まる番号で、毎回増分する必要があります。
発生します。例:テストは詳細に 3 回再試行され、合計 4 回試行される必要がある
同じ runName で実行され、AttemptNumber の値は 0 ~ 3 です。 |
testRunStarted
public void testRunStarted (String runName, int testCount)
テスト実行の開始を報告します。
パラメータ | |
---|---|
runName |
String : テスト実行名 |
testCount |
int : テスト実行中のテストの合計数 |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
テスト実行の開始を報告します。
パラメータ | |
---|---|
runName |
String : テスト実行名 |
testCount |
int : テスト実行中のテストの合計数 |
attemptNumber |
int : 同じ runName の異なる試行を識別する注文番号
実行されるリソースのことですtryNumber の値はインデックスが 0 で、
発生します。例:テストを細かく 3 回再試行します。合計 4 回の実行が必要です。
同じ runName の下にあり、AttemptNumber は 0 ~ 3 です。 |
startTime |
long : 実行の開始時刻(System.currentTimeMillis() で測定) |
testRunStopped
public void testRunStopped (long arg0)
ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。
TODO: 現在は使用されていないため、削除を検討してください
パラメータ | |
---|---|
arg0 |
long : デバイスで報告された経過時間(ミリ秒単位) |
testSkipped
public void testSkipped (TestDescription testId, SkipReason reason)
テストがスキップされ、通常は予期されない理由でテストが実行されなかった場合に呼び出されます。 これらのテストは、適切な実行を行うために再試行されます。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription testId, long startTime)
testStarted(com.android.tradefed.result.TestDescription)
に代わるもので、テストがいつ実行されたかも指定します。
開始され、正確な測定のために ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
と組み合わせて使用されます。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |
startTime |
long : テストが開始された時刻(System.currentTimeMillis() で測定) |
testStarted
public void testStarted (TestDescription testId)
個々のテストケースの開始を報告します。古いインターフェースの場合は、可能な限り testStarted(com.android.tradefed.result.TestDescription)
を使用してください。
パラメータ | |
---|---|
testId |
TestDescription : テストを識別します。 |