Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Các lớp con gián tiếp đã biết

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CollectingTestListener, và 52 phần khác.

AggregatePostProcessor	Một trình tổng hợp chỉ số cung cấp giá trị tối thiểu, tối đa, trung bình, phương sai, độ lệch chuẩn, tổng, số lượng và tùy chọn phần trăm cho các chỉ số dạng số được thu thập trong quá trình chạy kiểm thử nhiều lần lặp lại, coi các chỉ số này là số thực.
AtraceCollector	`IMetricCollector` chạy atrace trong quá trình kiểm thử, thu thập kết quả và ghi lại các kết quả đó vào lệnh gọi.
AtraceRunMetricCollector	Thu thập dấu vết từ tất cả thư mục kiểm thử trong thư mục đã cho từ thiết bị kiểm thử, ghi nhật ký thư mục kiểm thử và xử lý sau các tệp theo dõi trong thư mục kiểm thử, đồng thời tổng hợp các chỉ số.
AveragePostProcessor	Triển khai bộ xử lý hậu kỳ để tính giá trị trung bình của danh sách chỉ số.
BaseDeviceMetricCollector	Cách triển khai cơ sở của `IMetricCollector` cho phép bắt đầu và dừng thu thập trên `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` và `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	`IPostProcessor` cơ sở mà mọi hoạt động triển khai đều phải mở rộng.
BluetoothConnectionLatencyCollector	Bộ thu thập dữ liệu sẽ đẩy cấu hình chỉ số thời lượng statsd được xác định trước đến các thiết bị và thu thập thời lượng kết nối Bluetooth cho từng hồ sơ.
BluetoothConnectionStateCollector	Bộ thu thập này sẽ thu thập các chỉ số BluetoothConnectionStateChanged và ghi lại số trạng thái kết nối cho mỗi hồ sơ.
BluetoothConnectionSuccessRatePostProcessor	Triển khai bộ xử lý hậu kỳ để tính tỷ lệ thành công cho hồ sơ Bluetooth Sử dụng "metric-key-match" để chỉ định các chỉ số chứa trạng thái kết nối Bluetooth trong mảng số. Ví dụ: [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Bộ thu thập để bật tính năng ghi nhật ký theo dõi HCI Bluetooth trên DUT và thu thập nhật ký cho mỗi lần kiểm thử.
BugreportzOnFailureCollector	Thu thập bugreportz khi một trường hợp kiểm thử không thành công.
BugreportzOnTestCaseFailureCollector	Thu thập bugreportz khi một trường hợp kiểm thử trong một lần chạy không thành công.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo mức độ sử dụng Clang trên thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
CodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo phạm vi sử dụng Java và mã gốc trên thiết bị và ghi lại các phép đo đó dưới dạng cấu phần phần mềm kiểm thử.
CollectingTestListener	`ITestInvocationListener` sẽ thu thập tất cả kết quả kiểm thử.
ConsoleResultReporter	Trình báo cáo kết quả để in kết quả kiểm thử lên bảng điều khiển.
CountTestCasesCollector	Đếm và báo cáo số lượng trường hợp kiểm thử cho một `IRemoteTest` nhất định.
DebugHostLogOnFailureCollector	Bộ thu thập sẽ thu thập và ghi nhật ký phía máy chủ khi xảy ra lỗi kiểm thử.
DeviceTraceCollector	Bộ thu thập sẽ bắt đầu theo dõi perfetto khi một lần chạy kiểm thử bắt đầu và ghi nhật ký tệp theo dõi ở cuối.
EventsLoggerListener	Trình nghe ghi lại tất cả sự kiện mà trình nghe nhận được vào một tệp
FileProtoResultReporter	Trình báo cáo Proto kết xuất `TestRecord` vào một tệp.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` theo dõi khoá chỉ số đến từ thiết bị và lấy các khoá đó dưới dạng tệp từ thiết bị.
FilePullerLogCollector	Trình ghi nhật ký của tệp do phía thiết bị báo cáo.
FormattedGeneratorReporter	Trình báo cáo cho phép tạo báo cáo ở một định dạng cụ thể.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo mức độ sử dụng gcov từ thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo phạm vi sử dụng hạt nhân gcov từ debugfs và ngoài thiết bị, sau đó ghi lại các phép đo này dưới dạng cấu phần phần mềm kiểm thử.
GranularRetriableTestWrapper.StartEndCollector	Lớp trợ giúp để phát hiện thời điểm bắt đầu và kết thúc chạy bị thiếu.
HostStatsdMetricCollector	`IMetricCollector` thu thập các chỉ số statsd từ phía máy chủ bằng cách sử dụng các lệnh tiện ích statsd.
IMetricCollector	Giao diện này sẽ được thêm vào dưới dạng một trình trang trí khi báo cáo kết quả kiểm thử để thu thập các chỉ số phù hợp.
IPostProcessor	Bộ xử lý sau là một đối tượng Liên minh thương mại dùng để cho phép xử lý các chỉ số và nhật ký sau khi kiểm thử và trước khi báo cáo kết quả.
InvocationProtoResultReporter	Trình báo cáo để lưu trữ thông tin lưu vào bộ nhớ đệm ở cấp lệnh gọi và danh sách mô-đun của lệnh gọi đó
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo phạm vi sử dụng Java từ thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
JsonHttpTestResultReporter	Trình báo cáo kết quả mã hoá kết quả chỉ số kiểm thử và nhánh, thông tin thiết bị thành JSON và POST vào điểm cuối dịch vụ HTTP
LUCIResultReporter	Trình báo cáo kết quả lưu kết quả kiểm thử mà ResultDB và LUCI cần vào định dạng JSON (go/result-sink) và ghi lại vị trí tệp trong bảng điều khiển.
LegacySubprocessResultsReporter	Việc triển khai báo cáo kết quả quy trình con bị đóng băng sẽ vẫn tương thích với các phiên bản TF/CTS trước đó (ví dụ: 8 trở lên), mặc dù có thay đổi trong siêu lớp của báo cáo.
LogSaverResultForwarder	`ResultForwarder` để lưu nhật ký bằng trình lưu tệp toàn cục.
LogcatOnFailureCollector	Bộ thu thập sẽ ghi lại và ghi nhật ký logcat khi một trường hợp kiểm thử không thành công.
LogcatTimingMetricCollector	Bộ thu thập chỉ số thu thập thông tin về thời gian (ví dụ: thời gian chuyển đổi người dùng) từ logcat trong một hoặc nhiều lần kiểm thử lặp lại bằng cách sử dụng các mẫu regex nhất định để phân tích cú pháp tín hiệu bắt đầu và kết thúc của một sự kiện từ các dòng logcat.
MetricFilePostProcessor	Dùng để tải tệp nhật ký chỉ số được thu thập trong quá trình kiểm thử và chạy cấp.
MetricsXMLResultReporter	MetricsXMLResultReporter ghi các chỉ số kiểm thử và chạy các chỉ số vào một tệp XML trong thư mục do tham số metrics-folder chỉ định ở giai đoạn invocationEnded của kiểm thử.
ModuleListener	Trình nghe được đính kèm vào mỗi `IRemoteTest` của mỗi mô-đun để thu thập danh sách kết quả.
ModuleLogcatCollector	Phiên bản của trình thu thập logcat nhưng dành cho mô-đun.
ModuleProtoResultReporter	Trình báo cáo kết quả chỉ nhằm báo cáo kết quả ở cấp mô-đun.
PerfettoGenericPostProcessor	Trình xử lý hậu kỳ xử lý tệp proto chỉ số văn bản/tệp nhị phân perfetto thành các cặp khoá-giá trị bằng cách mở rộng đệ quy các thông điệp proto và các trường có giá trị chuỗi cho đến khi gặp trường có giá trị số.
PerfettoPullerMetricCollector	Phương thức triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép lấy các tệp perfetto từ thiết bị và thu thập các chỉ số từ thiết bị đó.
ProtoResultReporter	Trình báo cáo kết quả tạo một protobuf `TestRecord` với tất cả kết quả bên trong.
RebootReasonCollector	Bộ thu thập dữ liệu thu thập quá trình khởi động lại thiết bị trong quá trình chạy kiểm thử và báo cáo các lần khởi động lại theo lý do và số lượng.
ReportPassedTests	Báo cáo trong một tệp các bộ lọc có thể dùng để loại trừ kiểm thử đã vượt qua.
ResultAggregator	Trình chuyển tiếp đặc biệt tổng hợp các kết quả khi cần, dựa trên chiến lược thử lại đã được thực hiện.
ResultAndLogForwarder	Trình chuyển tiếp cho kết quả và sự kiện nhật ký.
ResultDBReporter	Trình báo cáo kết quả tải kết quả kiểm thử lên ResultDB.
RetryLogSaverResultForwarder	Trình chuyển tiếp cũng xử lý việc chuyển tiếp lượt thử hiện tại.
RuntimeRestartCollector	Bộ thu thập dữ liệu thu thập dấu thời gian của các lần khởi động lại thời gian chạy (sự cố máy chủ hệ thống) trong quá trình chạy kiểm thử, nếu có.
ScreenshotOnFailureCollector	Bộ thu thập sẽ chụp và ghi lại ảnh chụp màn hình khi một trường hợp kiểm thử không thành công.
ShardListener	`ITestInvocationListener` thu thập kết quả từ một mảnh lệnh gọi (còn gọi là một lệnh gọi phân tách để chạy song song trên nhiều tài nguyên) và chuyển tiếp các kết quả đó đến một trình nghe khác.
ShardMainResultForwarder	`ResultForwarder` kết hợp kết quả của các lệnh gọi kiểm thử được phân đoạn.
ShowmapPullerMetricCollector	Cách triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép lấy các tệp bản đồ hiển thị từ thiết bị và thu thập các chỉ số từ tệp đó.
StatsdBeforeAfterGaugeMetricPostProcessor	Bộ xử lý hậu kỳ xử lý các chỉ số đo lường được thu thập theo phương pháp "trước/sau", tức là:
StatsdEventMetricPostProcessor	Một trình xử lý hậu xử lý xử lý các chỉ số sự kiện trong báo cáo statsd thành các cặp khoá-giá trị, sử dụng các trình định dạng được chỉ định trên trình xử lý.
StatsdGenericPostProcessor	Bộ xử lý hậu xử lý xử lý các báo cáo statsd proto nhị phân thành các cặp khoá-giá trị bằng cách mở rộng báo cáo dưới dạng cấu trúc cây.
StreamProtoResultReporter	Cách triển khai `ProtoResultReporter`
SubprocessResultsReporter	Triển khai `ITestInvocationListener` được chỉ định là trình báo cáo kết quả và chuyển tiếp từ quy trình con kết quả kiểm thử, lần chạy kiểm thử, lệnh gọi kiểm thử.
SuiteResultReporter	Thu thập kết quả kiểm thử cho toàn bộ lệnh gọi bộ kiểm thử và xuất kết quả cuối cùng.
TextResultReporter	Trình báo cáo kết quả kiểm thử chuyển tiếp kết quả đến trình in kết quả văn bản JUnit.
TraceCmdCollector	`IMetricCollector` thu thập dấu vết trong quá trình kiểm thử bằng trace-cmd và ghi lại các dấu vết đó vào lệnh gọi.
XmlFormattedGeneratorReporter	Triển khai `FormattedGeneratorReporter` để định dạng kết quả của bộ công cụ ở định dạng xml.
XmlResultReporter	Ghi kết quả JUnit vào tệp XML ở định dạng nhất quán với XMLJUnitResultFormatter của Ant.

Cho phép ITestInvocationListener lắng nghe thời điểm lưu tệp nhật ký.

Điều này cho phép nhiều ITestInvocationListener sử dụng cùng một tệp nhật ký đã lưu khi tạo báo cáo và tránh việc mỗi trình nghe lưu tệp riêng lẻ khi ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) được gọi.

Các lớp triển khai giao diện này cần lưu ý rằng testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) sẽ được gọi bất cứ khi nào ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) được gọi.

Lớp này cũng truyền thực thể ILogSaver toàn cục để ITestInvocationListener có thể lưu các tệp bổ sung ở cùng một vị trí.

Tóm tắt

Phương thức công khai
`default void`	`logAssociation(String dataName, LogFile logFile)` Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` trực tiếp.
`default void`	`setLogSaver(ILogSaver logSaver)` Đặt `ILogSaver` để cho phép người triển khai lưu tệp.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Được gọi khi nhật ký kiểm thử được lưu.

Phương thức công khai

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) trực tiếp. Do đó, lệnh gọi lại này cho phép cung cấp một mối liên kết mạnh mẽ một cách rõ ràng.

Tham số
`dataName`	`String`: Tên của dữ liệu
`logFile`	`LogFile`: `LogFile` đã được ghi lại trước đó và phải được liên kết với trường hợp kiểm thử.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Đặt ILogSaver để cho phép người triển khai lưu tệp.

Tham số
`logSaver`	`ILogSaver`: `ILogSaver`

testLogSaved

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

Được gọi khi nhật ký kiểm thử được lưu.

Nên được sử dụng thay cho ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. Tức là trình triển khai phải có khả năng xử lý nhiều lệnh gọi có cùng dataName
`dataType`	`LogDataType`: `LogDataType` của dữ liệu
`dataStream`	`InputStreamSource`: `InputStreamSource` của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream thu được khi hoàn tất.
`logFile`	`LogFile`: `LogFile` chứa siêu dữ liệu của tệp đã lưu.