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

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

已知的間接子類

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 75 others.

聚合後處理器	一個度量聚合器，它為在多次迭代測試運行期間收集的數字度量提供最小值、最大值、平均值、方差、標準差、總數、計數和可選的百分位數，將它們視為雙精度數。
跟踪收集器	在測試期間運行 atrace 並收集結果並將其記錄到調用中的`IMetricCollector` 。
AtraceRunMetricCollector	從測試設備的給定目錄下的所有測試目錄中收集跟踪，記錄測試目錄併後處理測試目錄下的跟踪文件並聚合指標。
平均後處理器	計算指標列表平均值的後處理器的實現。
BaseDeviceMetricCollector	`IMetricCollector`的基本實現，允許在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上開始和停止收集。
基礎後處理器	每個實現都應該擴展的基礎`IPostProcessor` 。
BluetoothConnectionLatencyCollector	收集器會將預定義的 statsd 持續時間指標配置推送到設備，並收集每個配置文件的藍牙連接持續時間。
藍牙連接狀態收集器	此收集器將收集 BluetoothConnectionStateChanged 指標並記錄每個配置文件的連接狀態數。
藍牙連接成功率後處理器	計算藍牙配置文件成功率的後處理器的實現使用“metric-key-match”指定包含數字數組示例 [0, 1, 2, 3, 0, 1, 2, 3] 中的藍牙連接狀態的指標。
藍牙HciSnoopLog收集器	收集器，用於在 DUT 上啟用藍牙 HCI 偵聽日誌記錄並收集每個測試的日誌。
錯誤報告收集器	一個傳遞`ITestInvocationListener` ，它在發生可配置事件時收集錯誤報告，然後在收集每個錯誤報告後對其子項調用`ITestInvocationListener#testLog` 。
BugreportzOnFailureCollector	當測試用例失敗時收集錯誤報告。
錯誤報告 zOnTestCaseFailureCollector	當運行中的測試用例失敗時收集錯誤報告。
ClangCodeCoverageCollector	一個`BaseDeviceMetricCollector` ，它將從設備中提取 Clang 覆蓋測量並將它們記錄為測試工件。
收集測試監聽器	將收集所有測試結果的`ITestInvocationListener` 。
命令狀態處理器	幫助監視和更新調用狀態的處理程序。
條件故障監視器	監視調用是否有任何失敗。
控制台結果報告器	結果報告器將測試結果打印到控制台。
計數測試用例收集器	計算並報告給定`IRemoteTest`測試用例數。
計數測試結果監聽器	通過`TestStatus`跟踪測試總數的`TestResultListener`
DebugHostLogOnFailureCollector	發生測試用例失敗時收集並記錄主機端日誌的收集器。
DeviceReleaseReporter	處理與父進程通信的設備發布報告器處理要發布的設備。
設備跟踪收集器	收集器將在測試運行開始時啟動 perfetto trace 並在結束時記錄跟踪文件。
設備不可用監視器	此偵聽器僅嘗試捕獲測試用例級別的 DNAE。
事件記錄器監聽器	將接收到的所有事件記錄到文件中的偵聽器
FileProtoResultReporter	將`TestRecord`轉儲到文件中的原型記者。
FilePullerDeviceMetricCollector	一個`BaseDeviceMetricCollector` ，它偵聽來自設備的指標鍵並將它們作為文件從設備中提取。
FilePuller日誌收集器	設備端上報文件的Logger。
FilteredResultForwarder	`ResultForwarder`的變體，它只允許報告`TestDescription`的白名單。
FormattedGeneratorReporter	允許以特定格式生成報告的記者。
GcovCodeCoverageCollector	一個`BaseDeviceMetricCollector` ，它將從設備中提取 gcov 覆蓋測量並將它們記錄為測試工件。
GcovKernelCodeCoverageCollector	一個`BaseDeviceMetricCollector` ，它將 gcov 內核覆蓋測量從 debugfs 和設備中拉出，然後最終將它們記錄為測試工件。
GranularRetriableTestWrapper.StartEndCollector	捕捉缺失的運行開始和結束的類助手。
HostStatsdMetricCollector	一個`IMetricCollector` ，它使用 statsd 實用程序命令從主機端收集 statsd 指標。
ICommandScheduler.IScheduledInvocationListener	調用完成時調用事件的偵聽器。
ILogSaverListener	允許`ITestInvocationListener`監聽何時保存日誌文件。
指標收集器	當報告測試結果以收集匹配指標時，此接口將作為裝飾器添加。
後處理器	後處理器是一個 Trade Federation 對象，旨在允許在測試之後和結果報告之前處理指標和日誌。
IShardableListener	可以分片的`ITestInvocationListener` 。
ISupportGranularResults	指定`ITestInvocationListener`是否支持接收粒度結果的接口。
ITestInvocationListener	來自測試調用的測試結果的偵聽器。
ITestSummaryListener	允許`ITestInvocationListener`通過摘要交換一些有限信息的接口。
InvocationToJUnitResultForwarder	偵聽`ITestInvocationListener`事件並將它們轉發到`TestListener`類。
JarHostTest.HostTestListener	將除 testRunStarted() 和 testRunEnded() 之外的所有事件轉發到嵌入式偵聽器的包裝偵聽器。
JavaCodeCoverageCollector	一個`BaseDeviceMetricCollector` ，它將從設備中提取 Java 覆蓋率測量並將它們記錄為測試工件。
JsonHttpTestResultReporter	將測試指標結果和分支、設備信息編碼為 JSON 並 POST 到 HTTP 服務端點的結果報告器
最後碎片檢測器	在運行本地分片時，有時我們只想在最後一個分片到達`invocationEnded(long)`時執行一些操作。
LegacySubprocessResultsReporter	子流程結果報告器的凍結實現，儘管其超類發生了變化，但仍應與早期版本的 TF/CTS（例如 8+）兼容。
LogSaverResultForwarder	用於使用全局文件保護程序保存日誌的`ResultForwarder` 。
LogcatCrashResultForwarder	特殊偵聽器：在失敗（檢測進程崩潰）時，它將嘗試從 logcat 中提取崩潰並將其添加到與測試相關的失敗消息中。
LogcatOnFailure 收集器	當測試用例失敗時將捕獲並記錄 logcat 的收集器。
LogcatTimingMetricCollector	一種度量收集器，通過使用給定的正則表達式模式從 logcat 行解析事件的開始和結束信號，在一次或多次重複測試期間從 logcat 收集計時信息（例如用戶切換時間）。
公製文件後處理器	用於上傳在測試和運行級別收集的指標日誌文件。
指標 XMLResultReporter	MetricsXMLResultReporter 在測試的 invocationEnded 階段將測試指標和運行指標寫入 metrics-folder 參數指定的文件夾中的 XML 文件。
模塊監聽器	附加到每個模塊的每個`IRemoteTest`偵聽器，以收集結果列表。
模塊LogcatCollector	logcat 收集器的版本，但用於模塊。
名稱MangleListener	在報告結果時翻譯測試方法、類和包名稱的代理偵聽器。
通過測試文件報告程序	將通過的測試用例列表保存到測試文件的`ITestInvocationListener`
PerfettoGeneric後處理器	一個後處理器，通過遞歸地擴展原始消息和具有字符串值的字段，直到遇到具有數值的字段，將文本/二進制度量 perfetto proto 文件處理成鍵值對。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector`的基本實現，允許從設備中拉取 perfetto 文件並從中收集指標。
PrettyTestEventLogger	記錄器匹配事件並記錄它們，以便更容易調試。
ProtoResultReporter	結果報告器構建一個包含所有結果的`TestRecord` protobuf。
PythonBinaryHostTest.PythonForwarder	結果轉發器用二進制名稱替換運行名稱。
重啟原因收集器	在測試運行期間收集設備重啟並按原因和計數報告的收集器。
RemoteTestTimeOutEnforcer	允許檢查給定測試配置的執行時間並在超過給定超時時失敗的偵聽器。
報告通過測試	在文件中報告可能的過濾器以排除通過的測試。
結果聚合器	根據所採用的重試策略，在需要時聚合結果的特殊轉發器。
結果和日誌轉發器	結果和日誌事件的轉發器。
結果轉發器	將調用結果轉發到其他偵聽器列表的`ITestInvocationListener` 。
RetryLogSaverResultForwarder	還處理傳遞我們當前嘗試的轉發器。
重試結果轉發器	`ResultForwarder`的擴展，總是推送到給定的嘗試次數。
運行時重啟收集器	收集測試運行期間運行時重啟（系統服務器崩潰）時間戳的收集器（如果有）。
ScreenshotOnFailure收集器	當測試用例失敗時將捕獲並記錄屏幕截圖的收集器。
分片監聽器	一個`ITestInvocationListener` ，它從調用分片（又名調用拆分以並行運行在多個資源上）收集結果，並將它們轉發給另一個偵聽器。
ShardMainResultForwarder	一個`ResultForwarder` ，它結合了分片測試調用的結果。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector`的基本實現，它允許從設備中拉取顯示地圖文件並從中收集指標。
StatsdBeforeAfterGaugeMetricPostProcessor	一個後處理器，它處理以“之前/之後”的方式收集的測量指標，即
StatsdEventMetric後處理器	使用處理器上指定的格式化程序將 statsd 報告中的事件指標處理為鍵值對的後處理器。
Statsd通用後處理器	通過將報告擴展為樹結構，將二進制原型 statsd 報告處理為鍵值對的後處理器。
StreamProtoResultReporter	`ProtoResultReporter`的實現
子進程結果報告器	實現`ITestInvocationListener`以指定為 result_reporter 並從子進程轉發測試、測試運行、測試調用的結果。
套件結果報告器	收集整個套件調用的測試結果並輸出最終結果。
測試失敗監聽器	偵聽器過去常常在請求時在測試失敗時採取屏幕截圖、錯誤報告、logcat 收集等操作。
測試結果監聽器	為只關心單個測試結果的實施者簡化 ITestLifecycleListener。
測試超時執行器	允許檢查給定測試用例的執行時間並在超過給定超時時失敗的偵聽器。
文本結果報告器	將結果轉發到 JUnit 文本結果打印機的測試結果報告程序。
跟踪命令收集器	一個`IMetricCollector` ，它在測試期間使用 trace-cmd 收集跟踪，並將它們記錄到調用中。
TradefedSandboxRunner.StubScheduledInvocationListener	什麼都不做的存根`IScheduledInvocationListener` 。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`的實現將套件格式化為 xml 格式。
XmlResultReporter	以與 Ant 的 XMLJUnitResultFormatter 一致的格式將 JUnit 結果寫入 XML 文件。

在儀器測試運行期間接收事件通知。

模仿 org.junit.runner.notification.RunListener

調用順序將是：

測試運行開始
測試開始
[測試失敗]
[測試假設失敗]
[測試忽略]
測試結束
....
[測試運行失敗]
測試運行結束

概括

公共方法
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` 當原子測試標記它假定條件為假時調用
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` 當原子測試標記它假定條件為假時調用
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`的替代方法，我們可以在其中直接指定結束時間。
`default void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` 報告單個測試用例的執行結束。
`default void`	`testFailed ( TestDescription test, FailureDescription failure)` 報告單個測試用例的失敗。
`default void`	`testFailed ( TestDescription test, String trace)` 報告單個測試用例的失敗。
`default void`	`testIgnored ( TestDescription test)` 當測試不會運行時調用，通常是因為測試方法用 org.junit.Ignore 註釋。
`default void`	`testRunEnded (long elapsedTimeMillis, runMetrics)` `testRunEnded (long elapsedTimeMillis, runMetrics)` 報告測試運行結束。
`default void`	`testRunFailed ( FailureDescription failure)` 由於`FailureDescription`描述的故障，報告測試運行未能完成。
`default void`	`testRunFailed (String errorMessage)` 報告測試運行由於致命錯誤而未能完成。
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` 報告測試運行的開始。
`default void`	`testRunStarted (String runName, int testCount)` 報告測試運行的開始。
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` 報告測試運行的開始。
`default void`	`testRunStopped (long elapsedTime)` 由於用戶請求，報告測試運行在完成之前停止。
`default void`	`testStarted ( TestDescription test, long startTime)` `testStarted(com.android.tradefed.result.TestDescription)`的替代方法，我們還指定測試何時開始，並結合`ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))`進行準確測量.
`default void`	`testStarted ( TestDescription test)` 報告單個測試用例的開始。

公共方法

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記它假定條件為假時調用

參數
`test`	`TestDescription` ：標識測試
`trace`	`String` ：失敗的堆棧跟踪

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

當原子測試標記它假定條件為假時調用

參數
`test`	`TestDescription` ：標識測試
`failure`	`FailureDescription` ：描述故障及其上下文的`FailureDescription` 。

測試結束

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))的替代方法，我們可以在其中直接指定結束時間。結合testStarted(com.android.tradefed.result.TestDescription, long)進行準確測量。

參數
`test`	`TestDescription` ：標識測試
`endTime`	`long` ：測試結束的時間，通過`ERROR(/System#currentTimeMillis())`測量
`testMetrics`	: 發出的指標的`ERROR(/Map)`

測試結束

public void testEnded (TestDescription test, 
                 testMetrics)

報告單個測試用例的執行結束。

如果未調用testFailed(TestDescription, FailureDescription) ，則此測試通過。還返回在測試用例執行期間可能發出的任何鍵/值指標。

參數
`test`	`TestDescription` ：標識測試
`testMetrics`	: 發出的指標的`ERROR(/Map)`

測試失敗

public void testFailed (TestDescription test, 
                FailureDescription failure)

報告單個測試用例的失敗。

將在 testStarted 和 testEnded 之間調用。

參數
`test`	`TestDescription` ：標識測試
`failure`	`FailureDescription` ：描述故障及其上下文的`FailureDescription` 。

測試失敗

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 testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

報告測試運行結束。 FIXME: 我們不能有兩個不同類型的 Map<> 接口，所以我們必須在這裡使用 HashMap。

參數
`elapsedTimeMillis`	`long` ：設備報告經過的時間，以毫秒為單位
`runMetrics`	：在測試運行結束時使用`Metric`報告的鍵值對。

測試運行失敗

public void testRunFailed (FailureDescription failure)

由於FailureDescription描述的故障，報告測試運行未能完成。

參數
`failure`	`FailureDescription` ：描述故障及其上下文的`FailureDescription` 。

測試運行失敗

public void testRunFailed (String errorMessage)

報告測試運行由於致命錯誤而未能完成。

參數
`errorMessage`	`String` : `ERROR(/String)`描述運行失敗的原因。

測試運行開始

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

報告測試運行的開始。

參數
`runName`	`String` : 測試運行名稱
`testCount`	`int` : 測試運行中的測試總數
`attemptNumber`	`int` : order number，標識同一 runName 多次運行的不同嘗試。 attemptNumber 是從 0 開始索引的，每次發生新的運行時都應該遞增。例如，一個測試被精細地重試了 3 次，它應該在同一個 runName 下總共運行 4 次，並且 attemptNumber 是從 0 到 3。

測試運行開始

public void testRunStarted (String runName, 
                int testCount)

報告測試運行的開始。

參數
`runName`	`String` : 測試運行名稱
`testCount`	`int` : 測試運行中的測試總數

測試運行開始

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

報告測試運行的開始。

參數
`runName`	`String` : 測試運行名稱
`testCount`	`int` : 測試運行中的測試總數
`attemptNumber`	`int` : order number，標識同一 runName 多次運行的不同嘗試。 attemptNumber 是從 0 開始索引的，每次發生新的運行時都應該遞增。例如，一個測試被精細地重試了 3 次，它應該在同一個 runName 下總共運行 4 次，並且 attemptNumber 是從 0 到 3。
`startTime`	`long` ：運行開始的時間，通過`ERROR(/System#currentTimeMillis())`測量

測試運行已停止

public void testRunStopped (long elapsedTime)

由於用戶請求，報告測試運行在完成之前停止。

TODO：目前未使用，考慮刪除

參數
`elapsedTime`	`long` ：設備報告經過的時間，以毫秒為單位

測試開始

public void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription)的替代方法，我們還指定測試何時開始，並結合ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))進行準確測量.

參數
`test`	`TestDescription` ：標識測試
`startTime`	`long` ：測試開始的時間，通過`ERROR(/System#currentTimeMillis())`測量

測試開始

public void testStarted (TestDescription test)

報告單個測試用例的開始。較舊的界面，應盡可能使用testStarted(com.android.tradefed.result.TestDescription) 。

參數
`test`	`TestDescription` ：標識測試