ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

已知間接子類別 AggregatePostProcessor 提供最小、最大值、平均值、變異數、標準差、總計、計數與 重複測試執行期間收集的數值指標選用百分位數 以雙倍您的應用程式  AtraceCollector 在測試期間執行追蹤記錄，並收集結果和記錄的 IMetricCollector 加到叫用中  AtraceRunMetricCollector 從指定目錄下的所有測試目錄收集追蹤記錄 從測試裝置記錄測試目錄，然後後處理追蹤檔 ，並匯總指標  AveragePostProcessor 實施可計算指標清單平均值的後置處理器。  BaseDeviceMetricCollector 允許在IMetricCollector onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)和ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))。  BasePostProcessor 每個實作項目都應擴充的基本 IPostProcessor。  BluetoothConnectionLatencyCollector， 收集器會將預先定義的統計資料時間長度指標設定推送到裝置上，並收集 每個設定檔的藍牙連線持續時間。  BluetoothConnectionStateCollector (藍牙連線狀態收集器) 這個收集器會收集 BluetoothConnectionStateChanged 指標並記錄連線狀態 號碼。  BluetoothConnectionSuccessRatePostProcessor 實作可計算藍牙設定檔的成功率的後製處理器 使用「metric-key-match」以數字指定包含藍牙連線狀態的指標 陣列範例 [0、1、2、3、0、1、2、3]。  BluetoothHciSnoopLogCollector 用於在 DUT 上啟用藍牙 HCI 窺探記錄，以及收集每項測試的記錄。  BugreportCollector 會在可設定事件時收集錯誤報告的傳遞 ITestInvocationListener 便會在每次發生後，對其子項呼叫 ITestInvocationListener#testLog 錯誤報告收集完成。  BugreportzOnFailureCollector 在測試案例失敗時收集錯誤報告。  BugreportzOnTestCaseFailureCollector 在執行中的測試案例失敗時，收集錯誤報告。  ClangCodeCoverageCollector 將提取 Clang 的 BaseDeviceMetricCollector 同時測量裝置間的涵蓋率，並記錄為測試成果  CollectingTestListener 會收集所有測試結果的 ITestInvocationListener。  CommandStatusHandler 協助監控及更新叫用狀態的處理常式。  ConditionFailureMonitor 監控叫用失敗的情形。  ConsoleResultReporter 用於將測試結果列印至控制台的結果回報器。  CountTestCasesCollector 計算及回報指定 IRemoteTest 的測試案例數量。  DebugHostLogOnFailureCollector 測試案例失敗時，會收集並記錄主機端記錄的收集器。  DeviceReleaseReporter 裝置發布回報工具可處理與家長程序之間的裝置通訊 已發布。  DeviceTraceCollector 會在測試開始時啟動 Perfetto 追蹤記錄的收集器，並在結束時記錄追蹤檔。  DeviceUnavailableMonitor 這個事件監聽器只會嘗試擷取測試案例層級的 DNAE。  EventsLoggerListener 會記錄其收到的所有事件到檔案的接聽程式 FileProtoResultReporter 可將 TestRecord 傾印至檔案的 Proto 回報程式。  FilePullerDeviceMetricCollector BaseDeviceMetricCollector，可監聽來自裝置的指標鍵， 以檔案的形式儲存在裝置中  FilePullerLogCollector 裝置端回報的檔案記錄器。  FilteredResultForwarder ResultForwarder 的變化版本只允許使用「TestDescription」的許可清單 。  FormattedGeneratorReporter 可產生特定格式的報表報表。  GcovCodeCoverageCollector 將會提取 gcov 的 BaseDeviceMetricCollector 同時測量裝置間的涵蓋率，並記錄為測試成果  GcovKernelCodeCoverageCollector 會提取 gcov 核心的 BaseDeviceMetricCollector 從偵錯和裝置外部測量涵蓋率，最後將測量結果記錄為測試 導致學習失真性  GranularRetriableTestWrapper.StartEndCollector 類別輔助程式可找出缺少的執行開始和結束時間。  HostStatsdMetricCollector 使用 Statsd 公用程式從主機端收集統計資料指標的 IMetricCollector 指令  ICommandScheduler.IScheduledInvocationListener 叫用完成後的叫用事件接聽程式。  ILogSaverListener 儲存記錄檔時，可允許 ITestInvocationListener 監聽。  IMetricCollector 回報測試結果時，這個介面將新增為裝飾器，以便收集 相符的指標  IPostProcessor 後期處理方是一種貿易聯盟物件，可用於處理指標和記錄檔 測試「之後」和「執行前」結果回報。  IShardableListener 可分割的 ITestInvocationListener。  ISupportGranularResults 指定 ITestInvocationListener 是否支援接收精細資訊的介面 比對結果  ITestSummaryListener 可讓 ITestInvocationListener 透過以下使用者交換部分有限資訊的介面 總結  InvocationToJUnitResultForwarder 這個類別可監聽 ITestInvocationListener 事件，並轉送至 TestListener。  JarHostTest.HostTestListener 會將 testRunStarted() 和 testRunEnded() 以外的所有事件轉送至 嵌入事件監聽器  JavaCodeCoverageCollector 可提取 Java 的 BaseDeviceMetricCollector 同時測量裝置間的涵蓋率，並記錄為測試成果  JsonHttpTestResultReporter 將測試指標結果和分支版本、裝置資訊編碼為 JSON 和 POST 的結果回報器 連線至 HTTP 服務端點 LUCIResultReporter 產生結果回報器，可儲存 ResultDB 和 LUCI 所需的測試結果 轉換為 JSON 格式 (go/result-sink)，並在控制台中記錄檔案位置。  LastShardDetector 執行本機資料分割時，有時我們只想在最後一個資料分割時執行某些動作 達到 invocationEnded(long)。  LegacySubprocessResultsReporter 子程序結果回報器的凍結實作，應繼續與 較舊版本的 TF/CTS (例如 8 以上版本)，但由於父類別有所變更。  LogSaverResultForwarder 用於透過全域檔案儲存工具儲存記錄的 ResultForwarder。  LogcatCrashResultForwarder 特殊事件監聽器：失敗時 (檢測程序異常終止)，它會嘗試從 logcat 會造成當機問題，並加入與測試相關的失敗訊息。  LogcatOnFailureCollector 測試案例失敗時，可擷取並記錄 Logcat 的收集器。  LogcatTimingMetricCollector 指標收集工具，會在以下期間從 Logcat 收集時間資訊 (例如使用者切換時間) 使用指定的規則運算式模式剖析 事件。  MetricFilePostProcessor 用於上傳在測試和執行層級收集的指標記錄檔。  MetricsXMLResultReporter MetricsXMLResultReporter 將測試指標寫入至指定資料夾中的 XML 檔案， 。  ModuleListener 附加至每個模組每個 IRemoteTest 的事件監聽器，藉此收集 也就是預測結果  ModuleLogcatCollector 是模組的 Logcat 收集器版本。  NameMangleListener 用於在回報結果時轉譯測試方法、類別和套件名稱的 Proxy 事件監聽器。  PassingTestFileReporter ITestInvocationListener，可將傳遞的測試案例清單儲存至測試檔案 PerfettoGenericPostProcessor 此後處理器會將文字/二進位指標 Perfetto proto 檔案處理成鍵/值組合， 以遞迴方式展開 proto 訊息和欄位，同時增加包含字串值的欄位，直到 數值。  PerfettoPullerMetricCollector 允許執行的 FilePullerDeviceMetricCollector 基礎實作 從裝置中提取 Perfetto 檔案，然後從裝置中收集指標  PrettyTestEventLogger 記錄事件並記錄事件，以便進行偵錯。  ProtoResultReporter 結果回報工具會建構 TestRecord protobuf，並提供所有結果。  PythonBinaryHostTest.PythonForwarder 將執行作業名稱替換為二進位檔名稱的結果轉發器。  RebootReasonCollector 收集器會在測試執行期間收集裝置重新啟動，並按原因和次數回報。  RemoteTestTimeOutEnforcer 接聽程式，可以檢查指定測試設定的執行時間，如果失敗則失敗 超過 30%  ReportPassedTests 在報表中加入可能的篩選器，以排除通過的測試。  ResultAggregator 特殊轉寄站，根據要求過的重試策略，在需要時匯總結果 。  ResultAndLogForwarder 結果和記錄事件的轉發器。  ResultForwarder 將叫用結果轉送至其他事件監聽器清單的 ITestInvocationListener。  重試 LogSaverResultForwarder 也負責通過目前嘗試的轉送器。  重試結果轉送器 ResultForwarder 的擴充功能，一律會推送至指定嘗試次數。  RuntimeRestartCollector 收集器，可在測試期間收集執行階段重新啟動時間戳記 (系統伺服器當機) 執行  ScreenshotOnFailureCollector 測試案例失敗時，用來擷取並記錄螢幕截圖的收集器。  ShardListener ITestInvocationListener收集叫用資料分割 (亦稱為 以便同時對多個資源執行)，然後再轉送至其他 接聽程式。  ShardMainResultForwarder 合併資料分割測試叫用結果的 ResultForwarder。  ShowmapPullerMetricCollector 允許提取顯示地圖的 FilePullerDeviceMetricCollector 基礎實作 然後從裝置中收集指標  StatsdBeforeAfterGaugeMetricPostProcessor 處理「之前/之後」收集指標的後製處理器 StatsdEventMetricPostProcessor 後處理器，使用 處理器上指定的格式化工具  StatsdGenericPostProcessor 一種後處理器，透過擴充 以樹狀結構的形式記錄  StreamProtoResultReporter ProtoResultReporter 的實作 SubprocessResultsReporter 實作 ITestInvocationListener 做為 result_reporter，並從此指令開始 測試執行作業、測試叫用的結果  SuiteResultReporter 收集整個套件叫用的測試結果，並輸出最終結果。  TestTimeoutEnforcer 可以檢查指定測試案例的執行時間的接聽程式，如果失敗就會失敗 超過 30%  TextResultReporter 將結果轉送至 JUnit 文字結果印表機的測試結果回報器。  TraceCmdCollector 使用 trace-cmd 收集在測試期間收集追蹤記錄的 IMetricCollector， 呼叫。  TradefedSandboxRunner.StubScheduledInvocationListener 沒有任何作用的虛設常式 IScheduledInvocationListener。  XmlFormattedGeneratorReporter 實作 FormattedGeneratorReporter，這會以 xml 格式呈現套件 格式。  XmlResultReporter 這個外掛程式能使用 Ant 的 XMLJUnitResultFormatter。

---

測試叫用測試結果的接聽程式。

測試叫用本身可以包含多次測試執行作業，因此呼叫序列會

• responseStarted(BuildInfo)
• testRunStarted
• testStarted
• [測試失敗]
• 測試結束
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [叫用失敗]
• [測試記錄+]
• 已叫用
• 取得摘要

摘要

公用方法
default TestSummary	getSummary() 允許 InvocationListener 傳回摘要。
default void	invocationEnded(long elapsedTime) 回報叫用已終止 (無論成功或因某些錯誤而終止) 值。
default void	invocationFailed(FailureDescription failure) 回報因某些錯誤條件而不完整的叫用。
default void	invocationFailed(Throwable cause) 回報因某些錯誤條件而不完整的叫用。
default void	invocationInterrupted() 在排程器關閉時呼叫，讓叫用有機會在排程器之前執行特定操作 終止。
default void	invocationSkipped(SkipReason reason) 將叫用回報為略過
default void	invocationStarted(IInvocationContext context) 回報測試叫用開始的時間。
default void	testModuleEnded() 回報模組的執行完畢。
default void	testModuleStarted(IInvocationContext moduleContext) 回報執行模組的開始。

公用方法

取得摘要

public TestSummary getSummary ()

允許 InvocationListener 傳回摘要。

傳回
TestSummary	匯總執行作業的 TestSummary，或空值

已叫用

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 invocationSkipped (SkipReason reason)

將叫用回報為略過

參數
reason	SkipReason

叫用

public void invocationStarted (IInvocationContext context)

回報測試叫用開始的時間。

將由 TradeFederation 架構自動呼叫。回報者需要覆寫 此方法就能支援多部裝置回報。

參數
context	IInvocationContext：叫用的相關資訊

testModuleEnded

public void testModuleEnded ()

回報模組的執行完畢。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報執行模組的開始。這個回呼與 testModuleEnded() 相關聯，在序列中是選用選項。只會在使用 模組：套件型執行器

參數
moduleContext	IInvocationContext：模組的 IInvocationContext。