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

ITest呼叫監聽器

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInitationListener

已知的間接子類

AggregatePostProcessor 、 AtraceCollector 、 AtraceRunMetricCollector 、 AveragePostProcessor 、 BaseDeviceMetricCollector 、 BasePostProcessor 、 BluetoothConnectionLatencyColl ？ ureCollector 、 BugreportzOnTestCaseFailureCo llector 、 ClangCodeCoverageCollector 、 CollectingTestListener和其他 72 個。

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

測試所呼叫的測試結果的偵聽器。

測試呼叫本身可以包含多個測試運行，因此呼叫的順序將是

調用開始（建置資訊）
測試運行開始
測試開始
[測試失敗]
測試結束
…
測試運行結束
…
測試運行開始
…
測試運行結束
[呼叫失敗]
[測試日誌+]
呼叫結束
取得摘要

概括

公共方法
`default TestSummary`	`getSummary ()` 允許 IncationListener 傳回摘要。
`default void`	`invocationEnded (long elapsedTime)` 報告呼叫已終止，無論是成功還是由於某些錯誤情況。
`default void`	`invocationFailed ( FailureDescription failure)` 由於某些錯誤情況而報告不完整的呼叫。
`default void`	`invocationFailed (Throwable cause)` 由於某些錯誤情況而報告不完整的呼叫。
`default void`	`invocationInterrupted ()` 在調度程序關閉時調用，使調用有機會在終止之前執行某些操作。
`default void`	`invocationStarted ( IInvocationContext context)` 報告測試調用的開始。
`default void`	`testModuleEnded ()` 報告模組運作結束。
`default void`	`testModuleStarted ( IInvocationContext moduleContext)` 報告模組運作的開始。

公共方法

取得摘要

public TestSummary getSummary ()

允許 IncationListener 傳回摘要。

退貨
`TestSummary`	總結運行的`TestSummary` ，或 null

呼叫結束

public void invocationEnded (long elapsedTime)

報告呼叫已終止，無論是成功還是由於某些錯誤情況。

將由 TradeFederation 框架自動呼叫。

參數
`elapsedTime`	`long` ：呼叫所花費的時間（以毫秒為單位）

呼叫失敗

public void invocationFailed (FailureDescription failure)

由於某些錯誤情況而報告不完整的呼叫。

將由 TradeFederation 框架自動呼叫。

參數
`failure`	`FailureDescription` ：描述失敗原因的`FailureDescription`

呼叫失敗

public void invocationFailed (Throwable cause)

由於某些錯誤情況而報告不完整的呼叫。

將由 TradeFederation 框架自動呼叫。

參數
`cause`	`Throwable` ：失敗的`Throwable`原因

呼叫中斷

public void invocationInterrupted ()

在調度程序關閉時調用，使調用有機會在終止之前執行某些操作。

調用開始

public void invocationStarted (IInvocationContext context)

報告測試調用的開始。

將由 TradeFederation 框架自動呼叫。記者需要重寫此方法以支援多設備報告。

參數
`context`	`IInvocationContext` ：有關呼叫的信息

測試模組結束

public void testModuleEnded ()

報告模組運作結束。

測試模組啟動

public void testModuleStarted (IInvocationContext moduleContext)

報告模組運作的開始。此回調與testModuleEnded()關聯，並且在序列中是可選的。它僅在使用模組的運行期間使用：基於套件的運行器。

參數
`moduleContext`	`IInvocationContext` ：模組的`IInvocationContext` 。