本頁面由 Cloud Translation API 翻譯而成。

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 是鏈結的一部分，將會產生無限迴圈。

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

public void applyModuleConfiguration (boolean bugreportOnFailure)

允許在特定模組失敗時覆寫擷取的叫用設定儲存空間設定

參數
`bugreportOnFailure`	`boolean`：true，用於擷取測試失敗的錯誤報告。否則傳回「否」。

public void join ()

彙整所有 logcat 擷取執行緒，確保執行緒終止。

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)

提供來自測試叫用的相關聯記錄或偵錯資料。

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 是鏈結的一部分，將會產生無限迴圈。