自 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 和其他 53 個。

AggregatePostProcessor	指標匯總工具，可針對在多次迭代測試執行期間收集到的數值指標，提供最小值、最大值、平均值、變異數、標準差、總數、計數，以及選用的百分位數，並將這些指標視為雙精度值。
AtraceCollector	在測試期間執行 atrace，並收集結果並記錄至叫用作業的 `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	收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。
BugreportzOnFailureCollector	在測試案例失敗時收集 Bugreportz。
BugreportzOnTestCaseFailureCollector	在執行期間測試案例失敗時，收集 bugreportz。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Clang 涵蓋率測量資料，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 和原生涵蓋率評估資料，並將其記錄為測試構件。
收集 TestListener	用於收集所有測試結果的 `ITestInvocationListener`。
ConsoleResultReporter	結果回報器，可將測試結果列印到控制台。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	收集器，可在發生測試案例失敗時，收集及記錄主機端記錄檔。
DeviceTraceCollector	在測試開始執行時啟動 Perfetto 追蹤，並在結束時記錄追蹤檔案的收集器。
EventsLoggerListener	事件監聽器，可將收到的所有事件記錄到檔案中
FileProtoResultReporter	將 `TestRecord` 轉儲至檔案的 Proto 報表工具。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` 會監聽來自裝置的評估指標鍵，並將這些指標從裝置中擷取為檔案。
FilePullerLogCollector	裝置端回報的檔案記錄器。
FormattedGeneratorReporter	可讓您以特定格式產生報表的報表產生器。
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	指標收集器，可在一次或多次重複測試期間，使用指定的規則運算式，從 logcat 行剖析事件的開始和結束信號，收集時間資訊 (例如使用者切換時間)。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔案。
MetricsXMLResultReporter	MetricsXMLResultReporter 會在測試的 invocationEnded 階段，將測試指標和執行指標寫入由 metrics-folder 參數指定的資料夾中 XML 檔案。
ModuleListener	監聽器會附加至每個模組的每個 `IRemoteTest`，以便收集結果清單。
ModuleLogcatCollector	Logcat 收集器的版本，但適用於模組。
ModuleProtoResultReporter	結果回報器，用於僅回報模組層級結果。
ModuleResultsAndMetricsForwarder	`ResultAndLogForwarder` 的擴充功能，可在測試結果中加入額外的模組相關指標。
PerfettoGenericPostProcessor	後置處理器會以遞迴方式展開 proto 訊息和字串值欄位，直到遇到數值欄位為止，藉此將文字/二進位指標 perfetto proto 檔案處理成鍵/值組合。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 Perfetto 檔案，並收集相關指標。
ProtoResultReporter	結果回報器會建構 `TestRecord` protobuf，其中包含所有結果。
RebootReasonCollector	收集器會在測試執行期間收集裝置重新啟動情形，並依據原因和計數回報。
ReportPassedTests	在檔案中回報可能的篩選器，以便排除已通過測試的項目。
ResultAggregator	特殊轉送器，可根據採用的重試策略，在需要時匯總結果。
ResultAndLogForwarder	結果和記錄事件的轉送器。
ResultDBReporter
RetryLogSaverResultForwarder	轉送器，同時會處理傳遞目前嘗試的內容。
RuntimeRestartCollector	收集器會在測試執行期間收集執行階段重新啟動 (系統伺服器當機) 的時間戳記 (如有)。
ScreenshotOnFailureCollector	在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。
ShardListener	`ITestInvocationListener` 會收集呼叫分割作業 (也就是在多個資源上並行執行的呼叫分割作業) 的結果，並將結果轉送至其他事件監聽器。
ShardMainResultForwarder	結合分割測試叫用結果的 `ResultForwarder`。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 showmap 檔案，並收集相關指標。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器會處理以「前後」方式收集的評估指標，也就是
StatsdEventMetricPostProcessor	後置處理器，可使用處理器上指定的格式化工具，將 statsd 報表中的事件指標轉換為鍵/值組合。
StatsdGenericPostProcessor	後置處理器，可將二進位值 Proto 統計資料報表處理為鍵/值組合，方法是將報表展開為樹狀結構。
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 例項，讓 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)` 儲存測試記錄時呼叫。

公用方法

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