ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

已知的間接子類 AggregatePostProcessor 、 AtraceCollector 、 AtraceRunMetricCollector 、 AveragePostProcessor 、 BaseDeviceMetricCollector 、 BasePostProcessor 、 BluetoothConnectionLatencyCollector 、 BluetoothConnectionStateCollector 、 BluetoothConnectionSuccessRatePostProcessor 、 BluetoothHciSnoopLogCollector 、 BugreportCollector 、 BugreportzOnFailureCollector 、 BugreportzOnTestCaseFailureCo llector 、 ClangCodeCoverageCollector 、 CollectingTestListener和其他 75 個。 聚合後處理器 一個度量聚合器，提供多次迭代測試運行期間收集的數字度量的最小值、最大值、平均值、方差、標準差、總計、計數和可選的百分位數，並將它們視為雙精度。 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測試用例數量。 計數測試結果監聽器 一個TestResultListener ，通過TestStatus跟踪測試總數 調試主機登錄失敗收集器 當測試用例發生故障時，收集器將收集並記錄主機端日誌。 設備發布報告器 設備釋放報告器，用於處理與要釋放的設備的父進程的通信。 設備跟踪收集器 收集器將在測試運行開始時啟動 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是否支持接收粒度結果的接口。 ITest調用監聽器 測試調用的測試結果的偵聽器。 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 收集。 測試結果監聽器 ITestLifecycleListener 的簡化，適用於只關心單個測試結果的實施者。 測試超時執行器 允許檢查給定測試用例的執行時間的偵聽器，如果超過給定的超時則失敗。 文本結果報告器 將結果轉發到 JUnit 文本結果打印機的測試結果報告器。 跟踪命令收集器 IMetricCollector在測試期間使用trace-cmd 收集跟踪，並將其記錄到調用中。 TradefedSandboxRunner.StubScheduledInitationListener 一個不執行任何操作的存根IScheduledInvocationListener 。 XmlFormattedGeneratorReporter FormattedGeneratorReporter的實現將套件格式化為 xml 格式。 Xml結果報告器 以與 Ant 的 XMLJUnitResultFormatter 一致的格式將 JUnit 結果寫入 XML 文件。

---

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

模仿 org.junit.runner.notification.RunListener

調用的順序將是：

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

概括

公共方法
default void	testAssumptionFailure ( TestDescription test, String trace) 當原子測試標記其假定條件為 false 時調用
default void	testAssumptionFailure ( TestDescription test, FailureDescription failure) 當原子測試標記其假定條件為 false 時調用
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)

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

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

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

參數
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 ：測試結束的時間，通過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 ：描述運行失敗原因的String 。

測試運行開始

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

報告測試運行的開始。

參數
runName	String : 測試運行名稱
testCount	int : 測試運行中的測試總數
attemptNumber	int ：訂單號，標識同一 runName 多次運行的不同嘗試。 attemptsNumber 是從 0 開始索引的，並且每次新的運行發生時都應該遞增。例如，一個測試被粒度重試 3 次，它應該在同一 runName 下總共運行 4 次，並且 attemptsNumber 從 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 ：訂單號，標識同一 runName 多次運行的不同嘗試。 attemptsNumber 是從 0 開始索引的，並且每次新的運行發生時都應該遞增。例如，一個測試被粒度重試 3 次，它應該在同一 runName 下總共運行 4 次，並且 attemptsNumber 從 0 到 3。
startTime	long ：運行開始的時間，通過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 ：測試開始的時間，通過System.currentTimeMillis()測量

測試開始

public void testStarted (TestDescription test)

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

參數
test	TestDescription ：標識測試