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。

加入

public void join ()

加入所有 logcat 擷取執行緒,確保這些執行緒終止。

setLogger

public void setLogger (ITestLogger logger)

設定記錄檔的儲存位置。

參數
logger ITestLogger

測試失敗

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