ILogSaver監聽器

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

---

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

這允許多個ITestInvocationListener在生成報告時使用相同的已保存日誌文件，並避免在ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)時每個偵聽器單獨保存文件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 ：數據的String描述性名稱。例如“device_logcat”。注意 每次調用時 dataName 可能不是唯一的。即實現者必須能夠處理具有相同 dataName 的多個調用
dataType	LogDataType ：數據的LogDataType
dataStream	InputStreamSource ：數據的InputStreamSource 。實現者應該調用 createInputStream 來開始讀取數據，並確保完成後關閉生成的 InputStream。
logFile	LogFile ：包含已保存文件的元數據的LogFile 。