為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

已知間接子類別

AggregatePostProcessor、AndroidBuildResultReporter、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector 等 63 個。

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 窺探記錄，並收集各項測試的記錄。
BugreportzOnFailureCollector	測試案例失敗時，收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在執行測試案例時，如果發生失敗情形，請收集錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。
CollectingTestListener	`ITestInvocationListener`，用於收集所有測試結果。
ConsoleResultReporter	結果報告工具，可將測試結果列印到控制台。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
CoverageMetadataCollector	`ILogSaverListener`，可收集記錄的涵蓋範圍測量結果，並產生 CoverageMetadataProto，供 Android 程式碼涵蓋範圍服務處理。
DebugHostLogOnFailureCollector	收集器會在測試案例失敗時收集並記錄主機端記錄。
DeviceTraceCollector	這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。
EventsLoggerListener	這個監聽器會將收到的所有事件記錄到檔案中
FileProtoResultReporter	Proto 報告器，可將 `TestRecord` 傾印至檔案。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。
FilePullerLogCollector	記錄裝置端回報的檔案。
FormattedGeneratorReporter	可產生特定格式報表的 Reporter。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	這項工具會從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，然後將這些結果記錄為測試構件。`BaseDeviceMetricCollector`
GeminiDebuggingPostProcessor	後續處理器會建立提示查詢，以偵錯錯誤。
GranularRetriableTestWrapper.StartEndCollector	類別輔助程式，可擷取缺少的跑步開始和結束時間。
HostStatsdMetricCollector	`IMetricCollector`：使用 statsd 公用程式指令從主機端收集 statsd 指標。
IMetricCollector	回報測試結果時，這個介面會以裝飾器形式新增，以便收集相符的指標。
IPostProcessor	後續處理器是 Trade Federation 物件，用於在測試後和結果回報前處理指標和記錄。
InvocationProtoResultReporter	記者會儲存叫用層級的快取資訊和模組清單
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 涵蓋範圍測量結果，並將其記錄為測試構件。
JsonHttpTestResultReporter	結果回報工具，可將測試指標結果和分支、裝置資訊編碼為 JSON，並 POST 到 HTTP 服務端點
LUCIResultReporter	結果報表工具，可將 ResultDB 和 LUCI 測試結果儲存為 JSON 格式 (go/result-sink)，並在控制台中記錄檔案位置。
LegacySubprocessResultsReporter	子程序結果回報器的凍結實作項目，即使其超類別有所變更，仍應與舊版 TF/CTS (例如 8 以上) 相容。
LogSaverResultForwarder	`ResultForwarder`，用於透過全域檔案儲存工具儲存記錄。
LogcatOnFailureCollector	收集器：在測試案例或測試執行失敗時擷取並記錄 logcat。
LogcatTimingMetricCollector	指標收集器，可使用指定的 regex 模式剖析 logcat 行中的事件開始和結束信號，在一次或多次重複測試期間，從 logcat 收集時間資訊 (例如使用者切換時間)。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔。
MetricsXMLResultReporter	在測試的 invocationEnded 階段，MetricsXMLResultReporter 會將測試指標和執行指標寫入 metrics-folder 參數指定的資料夾中的 XML 檔案。
ModuleListener	附加至每個模組的每個 `IRemoteTest` 的監聽器，用於收集結果清單。
ModuleLogcatCollector	Logcat 收集器版本，但適用於模組。
ModulePerfettoCollector	這個收集器會在測試模組啟動/結束時和裝置重新啟動時，啟動 perfetto 追蹤。
ModuleProtoResultReporter	結果回報器，僅用於回報模組層級的結果。
ModuleResultsAndMetricsForwarder	`ResultAndLogForwarder` 的擴充功能，可將額外的模組相關指標新增至測試結果。
PerfettoFilePullerCollector	收集器會從裝置提取 Perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoGenericPostProcessor	後續處理器：遞迴展開具有字串值的 proto 訊息和欄位，直到遇到具有數值的欄位為止，將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。
ProtoResultReporter	結果回報器會建構 `TestRecord` protobuf，內含所有結果。
RebootReasonCollector	收集測試執行期間裝置重新啟動的次數，並依據原因和次數回報。
RemoteTestTimeOutEnforcer	這個監聽器可檢查特定測試設定的執行時間，如果超過指定逾時時間，就會導致測試失敗。
ReportPassedTests	在檔案中回報可能要排除通過測試的篩選器。
ResultAggregator	特殊轉送器，可根據採取的重試策略，在需要時彙整結果。
ResultAndLogForwarder	轉送結果和記錄事件。
ResultDBReporter	結果回報工具，可將測試結果上傳至 ResultDB。
ResultReporter
RetryLogSaverResultForwarder	轉送器，也會處理傳遞目前的嘗試次數。
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	收集整個套件調用的測試結果，並輸出最終結果。
TextResultReporter	測試結果回報工具，可將結果轉送至 JUnit 文字結果印表機。
TraceCmdCollector	`IMetricCollector`：使用 trace-cmd 在測試期間收集追蹤記錄，並將記錄寫入呼叫。
XmlFormattedGeneratorReporter	實作 `FormattedGeneratorReporter`，將套件結果格式化為 XML 格式。
XmlResultReporter	以符合 Ant 的 XMLJUnitResultFormatter 格式，將 JUnit 結果寫入 XML 檔案。

允許 ITestInvocationListener 監聽記錄檔的儲存時間。

這樣一來，多個 ITestInvocationListener 就能在產生報表時使用同一個已儲存的記錄檔，避免在呼叫 ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) 時，每個接聽程式都必須個別儲存檔案。

實作這個介面的類別應注意，每當呼叫 ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) 時，系統都會呼叫 testLogSaved(String,LogDataType,InputStreamSource,LogFile)。

這個類別也會傳遞全域 ILogSaver 例項，因此 ITestInvocationListener 可以將其他檔案儲存在相同位置。

摘要

公用方法
`default void`	`logAssociation(String dataName, LogFile logFile)` 在某些情況下，記錄必須與測試案例密切相關，但無法在直接 `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` 回呼中執行這項操作。
`default void`	`setLogSaver(ILogSaver logSaver)` 設定 `ILogSaver`，允許實作者儲存檔案。
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 測試記錄儲存完畢時呼叫。

公用方法

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情況下，記錄必須與測試案例密切相關，但無法在直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile) 回呼中執行此操作。因此，這個回呼可明確提供強關聯。

參數
`dataName`	`String`：資料名稱
`logFile`	`LogFile`：先前記錄的 `LogFile`，應與測試案例建立關聯。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

設定 ILogSaver，允許實作者儲存檔案。

參數
`logSaver`	`ILogSaver`：`ILogSaver`

testLogSaved

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`。