TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.testtype.suite.TestFailureListener

---

テストが失敗したときに、リクエストに応じてスクリーンショット、バグレポート、logcat の収集などのアクションを実行するために使用されるリスナー。

概要

パブリック コンストラクタ
TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)

パブリック メソッド
void	applyModuleConfiguration(boolean bugreportOnFailure) モジュール固有の構成で、エラー発生時のキャプチャの呼び出し設定をオーバーライドできます。
void	join() すべての logcat キャプチャ スレッドに結合して、確実に終了します。
void	setLogger(ITestLogger logger) ログを保存する場所を設定します。
void	testFailed(TestDescription test, String trace) 個々のテストケースの失敗を報告します。
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) テスト呼び出しから関連するログデータまたはデバッグデータを提供します。
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) ログをロガーに転送します。#testLog コールバック内から行わないでください。TestFailureListener がチェーンの一部であるかのように行うと、無限ループが発生します。

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

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

パラメータ
devices
bugReportOnFailure	boolean
rebootOnFailure	boolean

パブリック メソッド

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

モジュール固有の構成で、失敗時の回収の呼び出し設定をオーバーライドできます。

パラメータ
bugreportOnFailure	boolean: テスト失敗時にバグレポートをキャプチャする場合は true にします。それ以外の場合は false。

join

public void join ()

すべての logcat キャプチャ スレッドに join して、確実に終了するようにします。

setLogger

public void setLogger (ITestLogger logger)

ログの保存場所を設定します。

パラメータ
logger	ITestLogger

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

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

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

testLog

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

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

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) または ERROR(/ITestInvocationListener#invocationEnded(long)) の前に呼び出す必要があります。

TradeFederation フレームワークは、このメソッドを自動的に呼び出し、ホストログと、必要に応じてデバイスの logcat を提供します。

パラメータ
dataName	String: データのわかりやすい名前（例: device_logcat）。String注: dataName は呼び出しごとに一意ではない場合があります。つまり、実装者は同じ dataName で複数の呼び出しを処理できる必要があります。
dataType	LogDataType: データの LogDataType
dataStream	InputStreamSource: データの InputStreamSource。実装者は createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の InputStream を必ず閉じるようにする必要があります。呼び出し元は、testLog メソッドが完了するまで、データソースが存在し、アクセス可能であることを確認する必要があります。

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

ログをロガーに転送します。#testLog コールバック内から行わないでください。TestFailureListener がチェーンの一部であるかのように行うと、無限ループが発生します。

パラメータ
dataName	String
dataType	LogDataType
dataStream	InputStreamSource