バグレポートコレクター

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.オブジェクト
↳	com.android.tradefed.result.BugreportCollector

---

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

動作: (FIXME: これを終了します)

• テストケースが失敗した場合は、毎回キャプチャします
• 各テストケースの後にキャプチャする
• 失敗したテストケースごとにキャプチャする
• 捕獲

まとめ

入れ子になったクラス
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) 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) 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

パブリックメソッド

述語の追加

public void addPredicate (BugreportCollector.Predicate p)

パラメーター
p	BugreportCollector.Predicate

アイドルになるまでブロック

public void blockUntilIdle ()

コレクターがバグレポートを収集しなくなるまでブロックします。コレクターがバグレポートを積極的に収集していない場合は、すぐに戻ります

get概要

public TestSummary getSummary ()

InvocationListener が概要を返すことを許可します。

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

呼び出し終了

public void invocationEnded (long elapsedTime)

正常に終了したか、何らかのエラー条件により呼び出しが終了したことを報告します。

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

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

呼び出し失敗

public void invocationFailed (Throwable cause)

何らかのエラー状態が原因で不完全な呼び出しを報告します。

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

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

呼び出し開始

public void invocationStarted (IInvocationContext context)

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

TradeFederation フレームワークによって自動的に呼び出されます。複数のデバイスのレポートをサポートするには、レポーターはこのメソッドをオーバーライドする必要があります。

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

set非同期

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

テスト仮定失敗

public void testAssumptionFailure (TestDescription test, 
                String trace)

アトミック テストが条件が false であると仮定することを示すフラグを立てたときに呼び出されます。

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

テスト終了

public void testEnded (TestDescription test, 
                 testMetrics)

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

testFailed(TestDescription, FailureDescription)呼び出されなかった場合、このテストは合格です。また、テスト ケースの実行中に出力された可能性のあるキー/値メトリクスも返します。

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

テスト失敗

public void testFailed (TestDescription test, 
                String trace)

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

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

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

テスト無視されました

public void testIgnored (TestDescription test)

通常、テスト メソッドに org.junit.Ignore アノテーションが付けられているため、テストが実行されないときに呼び出されます。

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

テストログ

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 メソッドが完了するまで、データのソースが存在し、アクセス可能な状態にあることを確認する必要があります。

テスト実行終了

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

パラメーター
elapsedTime	long : デバイスが報告した経過時間 (ミリ秒単位)
runMetrics	: Metricを使用したテスト実行の終了時に報告されたキーと値のペア。

テスト実行失敗

public void testRunFailed (String errorMessage)

レポートのテスト実行は、致命的なエラーのため完了できませんでした。

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

テスト実行開始しました

public void testRunStarted (String runName, 
                int testCount)

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

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

テスト実行停止

public void testRunStopped (long elapsedTime)

ユーザーの要求により、テスト実行が完了前に停止したことをレポートします。

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

パラメーター
elapsedTime	long : デバイスが報告した経過時間 (ミリ秒単位)

テスト開始

public void testStarted (TestDescription test)

個々のテスト ケースの開始を報告します。古いインターフェイスでは、可能な限りtestStarted(com.android.tradefed.result.TestDescription)を使用する必要があります。

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