バグレポート コレクター

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.BugreportCollector

構成可能なイベントが発生したときにバグレポートを収集するパススルー ITestInvocationListener 発生するたびに、その子で ITestInvocationListener#testLog が呼び出されるたびに バグレポートが収集されます。

動作: （修正: これを終了）

  • テストケースが失敗した場合に各後にキャプチャする
  • 各テストケースの後にキャプチャ
  • 失敗した各テストケースの後のキャプチャ
  • キャプチャ

概要

ネストされたクラス

class BugreportCollector.Predicate

バグレポートをキャプチャするタイミングを記述する完全な述語。 

interface BugreportCollector.SubPredicate

 

フィールド

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

失敗した各テストケースの後に実行される、事前定義された述語

public static final BugreportCollector.Predicate AT_START

最初の呼び出しの開始時に起動する事前定義の述語

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

BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

パブリック メソッド

void addPredicate(BugreportCollector.Predicate p)
void blockUntilIdle()

コレクタがバグレポートを収集しなくなるまでブロックします。

TestSummary getSummary()

InvocationListener がサマリーを返すことを許可します。

void invocationEnded(long elapsedTime)

正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。

void invocationFailed(Throwable cause)

エラー条件により不完全な呼び出しを報告します。

void invocationStarted(IInvocationContext context)

テスト呼び出しの開始を報告します。

void setAsynchronous(boolean asynchronous)

バグレポート コレクションを別のスレッドで収集するかどうかを設定する （asynchronous = true）、またはバグレポートが取得されるまで発信者をブロックします。 （asynchronous = false）。

void setDescriptiveName(String name)

バグレポートを記録する際にわかりやすい名前を設定します。

void setDeviceWaitTime(int waitTime)

デバイスがオンラインになるのを待機する時間（秒単位）を設定してから バグレポート。

void testAssumptionFailure(TestDescription test, String trace)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

void testEnded(TestDescription test, testMetrics)

個々のテストケースの実行終了を報告します。

void testFailed(TestDescription test, String trace)

個々のテストケースの失敗を報告します。

void testIgnored(TestDescription test)

テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。

void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

テスト呼び出しの関連ログまたはデバッグデータを提供します。

void testRunEnded(long elapsedTime, runMetrics)

テスト実行の終了をレポートします。

void testRunFailed(String errorMessage)

致命的なエラーのため、テスト実行を完了できなかったことをレポートします。

void testRunStarted(String runName, int testCount)

テスト実行の開始を報告します。

void testRunStopped(long elapsedTime)

ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。

void testStarted(TestDescription test)

個々のテストケースの開始を報告します。

フィールド

AFTER_FAILED_TESTCASES（テスト失敗後）

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

失敗した各テストケースの後に実行される、事前定義された述語

AT_START

public static final BugreportCollector.Predicate AT_START

最初の呼び出しの開始時に起動する事前定義の述語

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

バグレポート コレクター

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

パラメータ
listener ITestInvocationListener

testDevice ITestDevice

パブリック メソッド

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

パラメータ
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

コレクタがバグレポートを収集しなくなるまでブロックします。コレクタがアクティブでない場合 バグレポートを収集したら、すぐに戻る

getSummary

public TestSummary getSummary ()

InvocationListener がサマリーを返すことを許可します。

戻り値
TestSummary 実行を要約した TestSummary、または null

invocationEnded

public void invocationEnded (long elapsedTime)

正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
elapsedTime long: 呼び出しの経過時間（ミリ秒）

invocationFailed

public void invocationFailed (Throwable cause)

エラー条件により不完全な呼び出しを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
cause Throwable: 失敗の Throwable 原因

invocationStarted

public void invocationStarted (IInvocationContext context)

テスト呼び出しの開始を報告します。

TradeFederation フレームワークによって自動的に呼び出されます。レポーターはオーバーライドする必要があります 複数のデバイスのレポートに対応できます。

パラメータ
context IInvocationContext: 呼び出しに関する情報

setAsynchronous

public void setAsynchronous (boolean asynchronous)

バグレポート コレクションを別のスレッドで収集するかどうかを設定する （asynchronous = true）、またはバグレポートが取得されるまで発信者をブロックします。 （asynchronous = false）。

パラメータ
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

バグレポートを記録する際にわかりやすい名前を設定します。null の場合、 BugreportCollector は、名前をシリアル化するデフォルトの動作にフォールバックします。 バグレポートが収集される原因となったイベント。

パラメータ
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

デバイスがオンラインになるのを待機する時間（秒単位）を設定してから バグレポート。負の値の場合、チェックは行われません。すべてのDeviceNotAvailableException すべてのオブジェクトはログに記録されて無視されます。

パラメータ
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

パラメータ
test TestDescription: テストを識別します。
trace String: 障害のスタック トレース

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestDescription, FailureDescription) が呼び出されなかった場合、このテストは合格です。また、任意の Key-Value を返します。 テストケースの実行中に出力された可能性のある指標を示します。

パラメータ
test TestDescription: テストを識別します。
testMetrics : 出力された指標の ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                String trace)

個々のテストケースの失敗を報告します。

testStarted と testEnded の間で呼び出されます。

パラメータ
test TestDescription: テストを識別します。
trace String: 障害のスタック トレース

testIgnored

public void testIgnored (TestDescription test)

テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。

パラメータ
test 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 メソッドが完了するまでアクセスできます。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了をレポートします。修正: 2 つの Map<> は使用できないインターフェースが異なるため、 ここでは HashMap を使用する必要があります。

パラメータ
elapsedTime long: デバイスで報告された経過時間（ミリ秒単位）
runMetrics : Metric を使用してテスト実行の最後にレポートされる Key-Value ペア。

testRunFailed

public void testRunFailed (String errorMessage)

致命的なエラーのため、テスト実行を完了できなかったことをレポートします。

パラメータ
errorMessage String: 実行失敗の理由を説明する String。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

テスト実行の開始を報告します。

パラメータ
runName String: テスト実行名
testCount int: テスト実行中のテストの合計数

testRunStopped

public void testRunStopped (long elapsedTime)

ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。

TODO: 現在は使用されていないため、削除を検討してください

パラメータ
elapsedTime long: デバイスで報告された経過時間（ミリ秒単位）

testStarted

public void testStarted (TestDescription test)

個々のテストケースの開始を報告します。古いインターフェースの場合は、可能な限り testStarted(com.android.tradefed.result.TestDescription) を使用してください。

パラメータ
test TestDescription: テストを識別します。