ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

已知間接子類別 AggregatePostProcessor、AndroidBuildResultReporter、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector 等 87 個項目。 AggregatePostProcessor 指標匯總工具，可提供多次疊代測試執行期間收集的數值指標的最小值、最大值、平均值、變異數、標準差、總計、計數，以及 (選用) 百分位數，並將這些指標視為雙精度浮點數。  AndroidBuildResultReporter 向 Android Build API 報告測試結果。  AtraceCollector IMetricCollector：在測試期間執行追蹤，並收集結果和記錄到呼叫中。  AtraceRunMetricCollector 從測試裝置收集指定目錄下所有測試目錄的追蹤記錄、記錄測試目錄，並後續處理測試目錄下的追蹤記錄檔案，以及匯總指標。  AveragePostProcessor 實作後處理器，計算指標清單的平均值。  BaseDeviceMetricCollector IMetricCollector 的基本實作，可讓您在 onTestRunStart(DeviceMetricData) 和 onTestRunEnd(DeviceMetricData,Map) 上開始及停止收集資料。  BasePostProcessor 所有實作項目都應擴充的基礎 IPostProcessor。  BluetoothConnectionLatencyCollector 收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線持續時間。  BluetoothConnectionStateCollector 這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。  BluetoothConnectionSuccessRatePostProcessor 實作後處理器，計算藍牙設定檔的成功率 使用「metric-key-match」指定包含藍牙連線狀態的指標 (以數字陣列表示)，例如 [0, 1, 2, 3, 0, 1, 2, 3]。  BluetoothHciSnoopLogCollector 收集器，用於在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。  BugreportCollector 這個傳遞 ITestInvocationListener 會在可設定的事件發生時收集錯誤報告，然後在收集每份錯誤報告後，對子項呼叫 ITestInvocationListener.testLog。  BugreportzOnFailureCollector 測試案例失敗時，收集 bugreportz。  BugreportzOnTestCaseFailureCollector 在執行測試案例時，如果發生失敗情形，請收集錯誤報告。  ClangCodeCoverageCollector BaseDeviceMetricCollector，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。  CodeCoverageCollector BaseDeviceMetricCollector，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。  CollectingTestListener ITestInvocationListener，用於收集所有測試結果。  CommandStatusHandler 處理常式，可協助監控及更新叫用狀態。  ConditionFailureMonitor 監控是否有任何叫用失敗情形。  ConsoleResultReporter 結果報告工具，可將測試結果列印到控制台。  CountTestCasesCollector 計算並回報指定 IRemoteTest 的測試案例數量。  CoverageMetadataCollector ILogSaverListener，可收集記錄的涵蓋範圍測量結果，並產生 CoverageMetadataProto，供 Android 程式碼涵蓋範圍服務處理。  DebugHostLogOnFailureCollector 收集器會在測試案例失敗時收集並記錄主機端記錄。  DeviceReleaseReporter 裝置發布回報器，負責與父項程序通訊，以發布裝置。  DeviceTraceCollector 這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。  DeviceUnavailableMonitor 這個接聽程式只會嘗試擷取測試案例層級的 DNAE。  EventsLoggerListener 這個監聽器會將收到的所有事件記錄到檔案中  FileProtoResultReporter Proto 報告器，可將 TestRecord 傾印至檔案。  FilePullerDeviceMetricCollector BaseDeviceMetricCollector，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。  FilePullerLogCollector 記錄裝置端回報的檔案。  FilteredResultForwarder ResultForwarder 的變體，只允許回報許可清單中的 TestDescription。  FormattedGeneratorReporter 可產生特定格式報表的 Reporter。  GcovCodeCoverageCollector BaseDeviceMetricCollector，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。  GcovKernelCodeCoverageCollector 這項工具會從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，然後將這些結果記錄為測試構件。BaseDeviceMetricCollector  GeminiDebuggingPostProcessor 後續處理器會建立提示查詢，以偵錯錯誤。  GranularRetriableTestWrapper.StartEndCollector 類別輔助程式，可擷取缺少的跑步開始和結束時間。  HostStatsdMetricCollector IMetricCollector：使用 statsd 公用程式指令從主機端收集 statsd 指標。  ICommandScheduler.IScheduledInvocationListener 當叫用完成時，叫用事件的監聽器。  ILogSaverListener 允許 ITestInvocationListener 監聽記錄檔的儲存時間。  IMetricCollector 回報測試結果時，這個介面會以裝飾器形式新增，以便收集相符的指標。  IPostProcessor 後續處理器是 Trade Federation 物件，用於在測試後和結果回報前處理指標和記錄。  IShardableListener 可分片的 ITestInvocationListener。  ISupportGranularResults 介面，用於指定 ITestInvocationListener 是否支援接收精細結果。  ITestSummaryListener ITestInvocationListener可透過摘要交換部分有限資訊的介面。  InvocationProtoResultReporter 記者會儲存叫用層級的快取資訊和模組清單  InvocationToJUnitResultForwarder 這個類別會監聽 ITestInvocationListener 事件，並將事件轉送至 TestListener。  JarHostTest.HostTestListener 包裝函式監聽器，會將 testRunStarted() 和 testRunEnded() 以外的所有事件轉送至內嵌監聽器。  JavaCodeCoverageCollector BaseDeviceMetricCollector，可從裝置中提取 Java 涵蓋範圍測量結果，並將其記錄為測試構件。  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 指標收集器，可使用指定的 regex 模式剖析 logcat 行中的事件開始和結束信號，在一次或多次重複測試期間，從 logcat 收集時間資訊 (例如使用者切換時間)。  MetricFilePostProcessor 用於上傳在測試和執行層級收集的指標記錄檔。  MetricsXMLResultReporter 在測試的 invocationEnded 階段，MetricsXMLResultReporter 會將測試指標和執行指標寫入 metrics-folder 參數指定的資料夾中的 XML 檔案。  ModuleListener 附加至每個模組的每個 IRemoteTest 的監聽器，用於收集結果清單。  ModuleLogcatCollector Logcat 收集器版本，但適用於模組。  ModulePerfettoCollector 這個收集器會在測試模組啟動/結束時和裝置重新啟動時，啟動 perfetto 追蹤。  ModuleProtoResultReporter 結果回報器，僅用於回報模組層級的結果。  ModuleResultsAndMetricsForwarder ResultAndLogForwarder 的擴充功能，可將額外的模組相關指標新增至測試結果。  NameMangleListener Proxy 監聽器，可在回報結果時翻譯測試方法、類別和套件名稱。  PassingTestFileReporter ITestInvocationListener，可將通過的測試案例清單儲存至測試檔案  PerfettoFilePullerCollector 收集器會從裝置提取 Perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。  PerfettoGenericPostProcessor 後續處理器：遞迴展開具有字串值的 proto 訊息和欄位，直到遇到具有數值的欄位為止，將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合。  PerfettoPullerMetricCollector 這個類別已淘汰。 請改用 PerfettoFilePullerCollector 和 ERROR(/PerfettoTracePostProcessor)。  PerfettoTracePostProcessor 後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。  PrettyTestEventLogger 記錄器會比對事件並記錄，方便您進行偵錯。  ProtoResultReporter 結果回報器會建構 TestRecord protobuf，內含所有結果。  PythonBinaryHostTest.PythonForwarder 結果轉送站，可將執行名稱替換為二進位檔名稱。  RebootReasonCollector 收集測試執行期間裝置重新啟動的次數，並依據原因和次數回報。  RemoteTestTimeOutEnforcer 這個監聽器可檢查特定測試設定的執行時間，如果超過指定逾時時間，就會導致測試失敗。  ReportPassedTests 在檔案中回報可能要排除通過測試的篩選器。  ResultAggregator 特殊轉送器，可根據採取的重試策略，在需要時彙整結果。  ResultAndLogForwarder 轉送結果和記錄事件。  ResultDBReporter 結果回報工具，可將測試結果上傳至 ResultDB。  ResultForwarder ITestInvocationListener，可將叫用結果轉送至其他接聽程式清單。  ResultReporter   RetryLogSaverResultForwarder 轉送器，也會處理傳遞目前的嘗試次數。  RetryResultForwarder ResultForwarder 的擴充功能，一律會推送至指定的嘗試次數。  RuntimeRestartCollector 收集器，用於收集測試執行期間的執行階段重新啟動時間戳記 (系統伺服器當機)，如有。  ScreenRecordOnFailureCollector 收集器會在測試案例失敗時擷取並記錄螢幕錄影。  ScreenshotOnFailureCollector 收集器，會在測試案例失敗時擷取並記錄螢幕截圖。  ShardListener 這個類別會從呼叫分片收集結果 (也就是呼叫分割，以便在多個資源上平行執行)，並將結果轉送至另一個接聽程式。ITestInvocationListener  ShardMainResultForwarder ResultForwarder，可合併分片測試調用的結果。  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector 的基本實作，可從裝置中提取 showmap 檔案，並從中收集指標。  SimpleperfProfilePostProcessor 後續處理器，可找出 simpleperf 分析資料並產生 pprof 設定檔。  StatsdBeforeAfterGaugeMetricPostProcessor 後續處理器，會以「前後」方法處理收集到的計量表指標，也就是： StatsdEventMetricPostProcessor 後置處理器：使用處理器上指定的格式化工具，將 statsd 報表中的事件指標處理為鍵/值組合。  StatsdGenericPostProcessor 後續處理器：將二進位 proto statsd 報表處理為鍵/值組合，方法是將報表展開為樹狀結構。  StreamProtoResultReporter ProtoResultReporter 的實作方式  SubprocessResultsReporter 實作 ITestInvocationListener，指定為 result_reporter，並從子程序轉送測試、測試執行、測試調用的結果。  SuiteResultReporter 收集整個套件調用的測試結果，並輸出最終結果。  TestRunResultListener 可讀取最終測試執行狀態的接聽程式。  TestTimeoutEnforcer 這個監聽器可檢查特定測試案例的執行時間，如果超過指定逾時時間，就會導致測試案例失敗。  TextResultReporter 測試結果回報工具，可將結果轉送至 JUnit 文字結果印表機。  TraceCmdCollector IMetricCollector：使用 trace-cmd 在測試期間收集追蹤記錄，並將記錄寫入呼叫。  TradefedSandboxRunner.StubScheduledInvocationListener 不會執行任何動作的虛設常式 IScheduledInvocationListener。  XmlFormattedGeneratorReporter 實作 FormattedGeneratorReporter，將套件結果格式化為 XML 格式。  XmlResultReporter 以符合 Ant 的 XMLJUnitResultFormatter 格式，將 JUnit 結果寫入 XML 檔案。

---

測試呼叫的測試結果監聽器。

測試呼叫本身可以包含多個測試執行作業，因此呼叫順序會是

• invocationStarted(BuildInfo)
• testRunStarted
• testStarted
• [testFailed]
• testEnded
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [invocationFailed]
• [testLog+]
• invocationEnded
• getSummary

摘要

公用方法
default TestSummary	getSummary() 允許 InvocationListener 傳回摘要。
default void	invocationEnded(long elapsedTime) 回報是否因某種錯誤狀況而終止呼叫 (無論是否成功)。
default void	invocationFailed(FailureDescription failure) Reports an incomplete invocation due to some error condition.
default void	invocationFailed(Throwable cause) Reports an incomplete invocation due to some error condition.
default void	invocationInterrupted() 在排程器關閉時呼叫，讓呼叫有機會在終止前執行某些動作。
default void	invocationSkipped(SkipReason reason) 回報已略過的叫用
default void	invocationStarted(IInvocationContext context) Reports the start of the test invocation.
default void	testModuleEnded() 回報模組執行作業的結束時間。
default void	testModuleStarted(IInvocationContext moduleContext) 回報模組的執行開始時間。

公用方法

getSummary

public TestSummary getSummary ()

允許 InvocationListener 傳回摘要。

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

invocationEnded

public void invocationEnded (long elapsedTime)

回報是否因某種錯誤情況而終止呼叫 (無論是否成功)。

TradeFederation 架構會自動呼叫。

參數
elapsedTime	long：以毫秒為單位的呼叫經過時間

invocationFailed

public void invocationFailed (FailureDescription failure)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
failure	FailureDescription：說明失敗原因的 FailureDescription

invocationFailed

public void invocationFailed (Throwable cause)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
cause	Throwable：Throwable 失敗的原因

invocationInterrupted

public void invocationInterrupted ()

在排程器關閉時呼叫，讓呼叫有機會在終止前執行某些動作。

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用回報為已略過

參數
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

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

TradeFederation 架構會自動呼叫這個方法。檢舉者需要覆寫這個方法，才能支援多部裝置回報。

參數
context	IInvocationContext：叫用相關資訊

testModuleEnded

public void testModuleEnded ()

回報模組執行作業的結束時間。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報模組的執行開始時間。這個回呼與 testModuleEnded() 相關聯，且在序列中為選用項目。只有在使用模組的執行期間，才會使用這個標記：以套件為基礎的執行器。

參數
moduleContext	IInvocationContext：模組的 IInvocationContext。