TestFailureListener
public
class
TestFailureListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.TestFailureListener |
測試失敗時用來採取行動的監聽器,例如螢幕截圖、錯誤報告、Logcat 收集 系統要求。
摘要
公用建構函式 | |
---|---|
TestFailureListener(
|
公用方法 | |
---|---|
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。 |
加入
public void join ()
加入所有 logcat 擷取執行緒,確保這些執行緒終止。
測試失敗
public void testFailed (TestDescription test, String trace)
回報個別測試案例的失敗情形。
會在 testStarted 和 testEnded 之間呼叫。
參數 | |
---|---|
test |
TestDescription :識別測試 |
trace |
String :失敗的堆疊追蹤 |
測試記錄
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 testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream)
將記錄轉送到記錄器,不要像 #testLog 回呼一樣透過此方式進行 TestFailureListener 是鏈結的一部分,將會產生無限迴圈。
參數 | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |