自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

已知間接子類別

AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector、CollectingTestListener 等 57 個項目。

AggregatePostProcessor	指標匯總工具，可提供多次疊代測試執行期間收集的數值指標的最小值、最大值、平均值、變異數、標準差、總計、計數，以及選用的百分位數，並將這些指標視為雙精度浮點數。
AtraceCollector	`IMetricCollector`：在測試期間執行追蹤，並收集結果和記錄到呼叫中。
AtraceRunMetricCollector	從測試裝置收集指定目錄下所有測試目錄的追蹤記錄、記錄測試目錄，並後續處理測試目錄下的追蹤記錄檔案，以及匯總指標。
AveragePostProcessor	實作後處理器，計算指標清單的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本實作，可讓您在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上開始及停止收集資料。
BasePostProcessor	所有實作項目都應擴充的基礎 `IPostProcessor`。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線持續時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態數。
BluetoothConnectionSuccessRatePostProcessor	實作後處理器，計算藍牙設定檔的成功率使用「metric-key-match」指定包含藍牙連線狀態的指標 (以數字陣列表示)，例如 [0, 1, 2, 3, 0, 1, 2, 3]。
BluetoothHciSnoopLogCollector	Collector 可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。
BugreportzOnFailureCollector	測試案例失敗時，收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在執行測試案例時，如果發生失敗情形，請收集錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。
CollectingTestListener	`ITestInvocationListener`，用於收集所有測試結果。
ConsoleResultReporter	結果報告工具，可將測試結果列印到控制台。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	收集器會在測試案例失敗時收集並記錄主機端記錄。
DeviceTraceCollector	這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。
EventsLoggerListener	這個監聽器會將收到的所有事件記錄到檔案中
FileProtoResultReporter	Proto 報告器，可將 `TestRecord` 傾印至檔案。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。
FilePullerLogCollector	記錄裝置端回報的檔案。
FormattedGeneratorReporter	可產生特定格式報表的 Reporter。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector`，可從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，最後將這些結果記錄為測試構件。
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	記錄收集器版本，但適用於模組。
ModuleProtoResultReporter	結果回報器，僅用於回報模組層級的結果。
ModuleResultsAndMetricsForwarder	`ResultAndLogForwarder` 的擴充功能，可將額外的模組相關指標新增至測試結果。
PerfettoFilePullerCollector	收集器會從裝置中提取 perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoGenericPostProcessor	後續處理器：將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合，方法是遞迴展開 proto 訊息和含有字串值的欄位，直到遇到含有數值的欄位為止。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。
ProtoResultReporter	結果回報器會建構 `TestRecord` protobuf，內含所有結果。
RebootReasonCollector	收集測試執行期間的裝置重新啟動次數，並依據原因和次數回報。
RemoteTestTimeOutEnforcer	這個監聽器可檢查特定測試設定的執行時間，並在超過指定逾時時間時導致測試失敗。
ReportPassedTests	在檔案中回報可排除通過測試的篩選器。
ResultAggregator	特殊轉送器，可根據採取的重試策略，在需要時彙整結果。
ResultAndLogForwarder	轉送結果和記錄事件。
ResultDBReporter	結果回報工具，可將測試結果上傳至 ResultDB。
ResultReporter
RetryLogSaverResultForwarder	轉送器，也會處理傳遞目前的嘗試次數。
RuntimeRestartCollector	收集測試執行期間執行階段重新啟動 (系統伺服器當機) 時間戳記的收集器 (如有)。
ScreenshotOnFailureCollector	收集器，會在測試案例失敗時擷取並記錄螢幕截圖。
ShardListener	`ITestInvocationListener`：從叫用分片收集結果 (又稱「叫用分割」，可在多個資源上平行執行)，並將結果轉送至其他接聽程式。
ShardMainResultForwarder	`ResultForwarder`，可合併分片測試調用的結果。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作，可從裝置中提取 showmap 檔案，並從中收集指標。
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 就能在產生報表時使用同一個已儲存的記錄檔，避免在呼叫 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)。

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

摘要

公用方法
`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)` 測試記錄儲存完畢時呼叫。

公用方法

logAssociation

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`，應與測試案例建立關聯。

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