ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

已知的間接子類 AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , ConsoleResultReporter , and 47 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 偵聽日誌記錄並收集每個測試的日誌。 BugreportzOnFailureCollector 當測試用例失敗時收集錯誤報告。 錯誤報告 zOnTestCaseFailureCollector 當運行中的測試用例失敗時收集錯誤報告。 ClangCodeCoverageCollector 一個BaseDeviceMetricCollector ，它將從設備中提取 Clang 覆蓋測量並將它們記錄為測試工件。 收集測試監聽器 將收集所有測試結果的ITestInvocationListener 。 控制台結果報告器 結果報告器將測試結果打印到控制台。 計數測試用例收集器 計算並報告給定IRemoteTest測試用例數。 DebugHostLogOnFailureCollector 發生測試用例失敗時收集並記錄主機端日誌的收集器。 設備跟踪收集器 收集器將在測試運行開始時啟動 perfetto trace 並在結束時記錄跟踪文件。 事件記錄器監聽器 將接收到的所有事件記錄到文件中的偵聽器 FileProtoResultReporter 將TestRecord轉儲到文件中的原型記者。 FilePullerDeviceMetricCollector 一個BaseDeviceMetricCollector ，它偵聽來自設備的指標鍵並將它們作為文件從設備中提取。 FilePuller日誌收集器 設備端上報文件的Logger。 FormattedGeneratorReporter 允許以特定格式生成報告的記者。 GcovCodeCoverageCollector 一個BaseDeviceMetricCollector ，它將從設備中提取 gcov 覆蓋測量並將它們記錄為測試工件。 GcovKernelCodeCoverageCollector 一個BaseDeviceMetricCollector ，它將 gcov 內核覆蓋測量從 debugfs 和設備中拉出，然後最終將它們記錄為測試工件。 GranularRetriableTestWrapper.StartEndCollector 捕捉缺失的運行開始和結束的類助手。 HostStatsdMetricCollector 一個IMetricCollector ，它使用 statsd 實用程序命令從主機端收集 statsd 指標。 指標收集器 當報告測試結果以收集匹配指標時，此接口將作為裝飾器添加。 後處理器 後處理器是一個 Trade Federation 對象，旨在允許在測試之後和結果報告之前處理指標和日誌。 JavaCodeCoverageCollector 一個BaseDeviceMetricCollector ，它將從設備中提取 Java 覆蓋率測量並將它們記錄為測試工件。 JsonHttpTestResultReporter 將測試指標結果和分支、設備信息編碼為 JSON 並 POST 到 HTTP 服務端點的結果報告器 LegacySubprocessResultsReporter 子流程結果報告器的凍結實現，儘管其超類發生了變化，但仍應與早期版本的 TF/CTS（例如 8+）兼容。 LogSaverResultForwarder 用於使用全局文件保護程序保存日誌的ResultForwarder 。 LogcatOnFailure 收集器 當測試用例失敗時將捕獲並記錄 logcat 的收集器。 LogcatTimingMetricCollector 一種度量收集器，通過使用給定的正則表達式模式從 logcat 行解析事件的開始和結束信號，在一次或多次重複測試期間從 logcat 收集計時信息（例如用戶切換時間）。 公製文件後處理器 用於上傳在測試和運行級別收集的指標日誌文件。 指標 XMLResultReporter MetricsXMLResultReporter 在測試的 invocationEnded 階段將測試指標和運行指標寫入 metrics-folder 參數指定的文件夾中的 XML 文件。 模塊監聽器 附加到每個模塊的每個IRemoteTest偵聽器，以收集結果列表。 模塊LogcatCollector logcat 收集器的版本，但用於模塊。 PerfettoGeneric後處理器 一個後處理器，通過遞歸地擴展原始消息和具有字符串值的字段，直到遇到具有數值的字段，將文本/二進制度量 perfetto proto 文件處理成鍵值對。 PerfettoPullerMetricCollector FilePullerDeviceMetricCollector的基本實現，允許從設備中拉取 perfetto 文件並從中收集指標。 ProtoResultReporter 結果報告器構建一個包含所有結果的TestRecord protobuf。 重啟原因收集器 在測試運行期間收集設備重啟並按原因和計數報告的收集器。 報告通過測試 在文件中報告可能的過濾器以排除通過的測試。 結果聚合器 根據所採用的重試策略，在需要時聚合結果的特殊轉發器。 結果和日誌轉發器 結果和日誌事件的轉發器。 RetryLogSaverResultForwarder 還處理傳遞我們當前嘗試的轉發器。 運行時重啟收集器 收集測試運行期間運行時重啟（系統服務器崩潰）時間戳的收集器（如果有）。 ScreenshotOnFailure收集器 當測試用例失敗時將捕獲並記錄屏幕截圖的收集器。 分片監聽器 一個ITestInvocationListener ，它從調用分片（又名調用拆分以並行運行在多個資源上）收集結果，並將它們轉發給另一個偵聽器。 ShardMainResultForwarder 一個ResultForwarder ，它結合了分片測試調用的結果。 ShowmapPullerMetricCollector FilePullerDeviceMetricCollector的基本實現，它允許從設備中拉取顯示地圖文件並從中收集指標。 StatsdBeforeAfterGaugeMetricPostProcessor 一個後處理器，它處理以“之前/之後”的方式收集的測量指標，即 StatsdEventMetric後處理器 使用處理器上指定的格式化程序將 statsd 報告中的事件指標處理為鍵值對的後處理器。 Statsd通用後處理器 通過將報告擴展為樹結構，將二進制原型 statsd 報告處理為鍵值對的後處理器。 StreamProtoResultReporter ProtoResultReporter的實現 子進程結果報告器 實現ITestInvocationListener以指定為 result_reporter 並從子進程轉發測試、測試運行、測試調用的結果。 套件結果報告器 收集整個套件調用的測試結果並輸出最終結果。 文本結果報告器 將結果轉發到 JUnit 文本結果打印機的測試結果報告程序。 跟踪命令收集器 一個IMetricCollector ，它在測試期間使用 trace-cmd 收集跟踪，並將它們記錄到調用中。 XmlFormattedGeneratorReporter FormattedGeneratorReporter的實現將套件格式化為 xml 格式。 XmlResultReporter 以與 Ant 的 XMLJUnitResultFormatter 一致的格式將 JUnit 結果寫入 XML 文件。

---

允許ITestInvocationListener監聽何時保存日誌文件。

這允許多個ITestInvocationListener在生成報告時使用相同的保存日誌文件，並避免在ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)被調用。

實現此接口的類應注意，每當testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)被調用。

此類還傳遞全局ILogSaver實例，因此ITestInvocationListener可以在同一位置保存其他文件。

概括

公共方法
default void	logAssociation (String dataName, LogFile logFile) 在某些情況下，日誌必須與測試用例強關聯，但有機會這樣做就直接testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)回調是不可能的。
default void	setLogSaver ( ILogSaver logSaver) 設置ILogSaver以允許實施者保存文件。
default void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) 保存測試日誌時調用。

公共方法

日誌關聯

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情況下，日誌必須與測試用例強關聯，但有機會這樣做就直接testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)回調是不可能的。因此，此回調允許顯式提供強關聯。

參數
dataName	String ：數據的名稱
logFile	LogFile ：之前記錄的LogFile ，應該與測試用例相關聯。

設置日誌保存器

public void setLogSaver (ILogSaver logSaver)

設置ILogSaver以允許實施者保存文件。

參數
logSaver	ILogSaver ： ILogSaver

測試日誌已保存

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

保存測試日誌時調用。

應該用來代替ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) 。

參數
dataName	String ：數據的ERROR(/String)描述性名稱。例如“device_logcat”。注意 dataName 每次調用可能不是唯一的。即實現者必須能夠處理具有相同數據名的多個調用
dataType	LogDataType ：數據的LogDataType
dataStream	InputStreamSource ：數據的InputStreamSource 。實施者應調用 createInputStream 開始讀取數據，並確保在完成後關閉生成的 InputStream。
logFile	LogFile ：包含已保存文件的元數據的LogFile 。