Để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4 năm 2026. Để tạo và đóng góp cho AOSP, hãy sử dụng android-latest-release. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

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

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

AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector và 63 đối tượng 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à tuỳ chọn là các phân vị cho các chỉ số dạng số được thu thập trong các lần chạy thử nghiệm nhiều lần lặp lại, coi chúng là số thực có độ chính xác gấp đôi.
AndroidBuildResultReporter	Báo cáo kết quả kiểm thử cho Android Build API.
AtraceCollector	Một `IMetricCollector` chạy atrace trong quá trình kiểm thử, thu thập kết quả và ghi nhật ký vào lệnh gọi.
AtraceRunMetricCollector	Thu thập các dấu vết từ tất cả thư mục kiểm thử trong thư mục đã cho từ thiết bị thử nghiệm, ghi nhật ký thư mục kiểm thử và xử lý hậu kỳ các tệp dấu vết trong thư mục kiểm thử, đồng thời tổng hợp các chỉ số.
AveragePostProcessor	Triển khai trình 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ơ bản của `IMetricCollector` cho phép bắt đầu và dừng thu thập trên `onTestRunStart(DeviceMetricData)` và `onTestRunEnd(DeviceMetricData,Map)`.
BasePostProcessor	`IPostProcessor` cơ sở mà mọi phương thức triển khai đều phải mở rộng.
BluetoothConnectionLatencyCollector	Trình thu thập 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	Trình 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 từng hồ sơ.
BluetoothConnectionSuccessRatePostProcessor	Triển khai trình xử lý hậu kỳ để tính tỷ lệ thành công cho một 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	Trình 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 từng 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ẽ kéo các phép đo mức độ phù hợp của Clang ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
CodeCoverageCollector	Một `BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của Java và gốc ra khỏi thiết bị, đồng thời ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
CollectingTestListener	Một `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ử ra 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.
CoverageMetadataCollector	Một `ILogSaverListener` thu thập các phép đo mức độ sử dụng đã ghi nhật ký và tạo CoverageMetadataProto để Dịch vụ mức độ sử dụng mã Android xử lý.
DebugHostLogOnFailureCollector	Trình thu thập sẽ thu thập và ghi nhật ký phía máy chủ lưu trữ khi xảy ra lỗi trường hợp kiểm thử.
DeviceTraceCollector	Bộ thu thập sẽ bắt đầu dấu vết perfetto khi bắt đầu chạy kiểm thử và ghi tệp dấu vết vào cuối.
EventsLoggerListener	Trình nghe ghi tất cả cá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	Một `BaseDeviceMetricCollector` lắng nghe khoá chỉ số đến từ thiết bị và kéo chúng dưới dạng một 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	Một `BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp gcov ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của hạt nhân gcov ra khỏi debugfs và khỏi thiết bị, sau đó ghi nhật ký các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
GeminiDebuggingPostProcessor	Trình xử lý hậu kỳ tạo truy vấn nhanh để gỡ lỗi.
GranularRetriableTestWrapper.StartEndCollector	Trợ lý lớp học để phát hiện thời điểm bắt đầu và kết thúc chạy bị thiếu.
HostStatsdMetricCollector	Một `IMetricCollector` thu thập các chỉ số statsd từ phía máy chủ lưu trữ 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 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	Trình xử lý hậu kỳ là một đối tượng Trade Federation nhằm 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	Reporters để lưu trữ thông tin bộ nhớ đệm ở cấp độ lệnh gọi và danh sách các mô-đun của bộ nhớ đệm
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo mức độ phù hợp của Java khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
JsonHttpTestResultReporter	Một trình báo cáo kết quả mã hoá kết quả chỉ số kiểm thử và thông tin về nhánh, thiết bị thành JSON và POST vào một điểm cuối dịch vụ HTTP
LUCIResultReporter	Một trình báo cáo kết quả lưu các kết quả kiểm thử cần thiết của ResultDB và LUCI vào định dạng JSON (go/result-sink) và ghi nhật ký vị trí tệp trong bảng điều khiển.
LegacySubprocessResultsReporter	Một cách triển khai cố định của trình báo cáo kết quả quy trình con. Cách triển khai này 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ó những thay đổi trong siêu lớp của trình báo cáo.
LogSaverResultForwarder	Một `ResultForwarder` để lưu nhật ký bằng trình lưu tệp chung.
LogcatOnFailureCollector	Trình thu thập sẽ ghi lại và đăng nhập một logcat khi một trường hợp kiểm thử hoặc lần chạy kiểm thử không thành công.
LogcatTimingMetricCollector	Một trình 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 biểu thức chính quy đã cho để 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	Được dùng để tải tệp nhật ký chỉ số được thu thập trong quá trình kiểm thử và cấp độ chạy lên.
MetricsXMLResultReporter	MetricsXMLResultReporter ghi các chỉ số kiểm thử và chỉ số chạy vào một tệp XML trong thư mục do tham số metrics-folder chỉ định ở giai đoạn invocationEnded của quy trình 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.
ModulePerfettoCollector	Bộ thu thập sẽ bắt đầu theo dõi perfetto khi một mô-đun kiểm thử bắt đầu và kết thúc cũng như khi thiết bị khởi động lại.
ModuleProtoResultReporter	Một trình báo cáo kết quả chỉ dùng để báo cáo kết quả ở cấp mô-đun.
ModuleResultsAndMetricsForwarder	Một tiện ích của `ResultAndLogForwarder` giúp thêm các chỉ số bổ sung liên quan đến mô-đun vào kết quả kiểm thử.
PerfettoFilePullerCollector	Một trình thu thập dữ liệu kéo các tệp dấu vết Perfetto từ thiết bị, nén các tệp đó (nếu có) và thêm các tệp đó vào nhật ký kiểm thử.
PerfettoGenericPostProcessor	Một trình xử lý hậu kỳ xử lý tệp proto perfetto chỉ số văn bản/nhị phân thành các cặp khoá-giá trị bằng cách mở rộng đệ quy các thông báo và trường proto có giá trị chuỗi cho đến khi gặp trường có giá trị số.
PerfettoPullerMetricCollector	Lớp này không được dùng nữa. Thay vào đó, hãy sử dụng `PerfettoFilePullerCollector` và `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Một trình xử lý hậu kỳ truy xuất các tệp dấu vết Perfetto từ nhật ký kiểm thử và chạy trình xử lý dấu vết trên các tệp đó để tạo một proto chỉ số Perfetto.
ProtoResultReporter	Trình báo cáo kết quả tạo một protobuf `TestRecord` có chứa tất cả kết quả.
RebootReasonCollector	Trình thu thập thu thập dữ liệu về hoạt động khởi động lại thiết bị trong quá trình chạy thử và báo cáo dữ liệu đó theo lý do và số lượng.
RemoteTestTimeOutEnforcer	Trình nghe cho phép kiểm tra thời gian thực thi của một cấu hình kiểm thử nhất định và không thành công nếu thời gian này vượt quá một thời gian chờ nhất định.
ReportPassedTests	Báo cáo trong một tệp có thể lọc để loại trừ bài kiểm thử đã vượt qua.
ResultAggregator	Trình chuyển tiếp đặc biệt tổng hợp 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 các sự kiện kết quả và nhật ký.
ResultDBReporter	Trình báo cáo kết quả tải kết quả kiểm thử lên ResultDB.
ResultReporter
RetryLogSaverResultForwarder	Lớp chuyển tiếp kết quả cũng xử lý việc truyền lượt thử hiện tại mà chúng ta đang thực hiện.
RuntimeRestartCollector	Trình 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 (hệ thống gặp sự cố máy chủ) trong quá trình chạy thử nghiệm (nếu có).
ScreenRecordOnFailureCollector	Trình thu thập sẽ ghi lại và ghi nhật ký bản ghi màn hình khi một trường hợp kiểm thử không thành công.
ScreenshotOnFailureCollector	Trình 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	Một `ITestInvocationListener` thu thập kết quả từ một phân đoạn lệnh gọi (còn gọi là lệnh gọi được chia để 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	Một `ResultForwarder` kết hợp kết quả của các lệnh gọi kiểm thử phân mảnh.
ShowmapPullerMetricCollector	Triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép kéo các tệp showmap từ thiết bị và thu thập các chỉ số từ đó.
SimpleperfProfilePostProcessor	Một trình xử lý hậu kỳ tìm dữ liệu phân tích tài nguyên simpleperf và tạo một hồ sơ pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	Một trình 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 kỳ xử lý các chỉ số sự kiện trong báo cáo statsd thành các cặp khoá-giá trị, bằng cách sử dụng các trình định dạng được chỉ định trên trình xử lý.
StatsdGenericPostProcessor	Một trình xử lý hậu kỳ 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	Một cách triển khai `ProtoResultReporter`
SubprocessResultsReporter	Triển khai `ITestInvocationListener` để được chỉ định làm result_reporter và chuyển tiếp kết quả của các kiểm thử, lần chạy kiểm thử, lệnh gọi kiểm thử từ quy trình con.
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	Một 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	Một `IMetricCollector` thu thập các dấu vết trong quá trình kiểm thử bằng trace-cmd và ghi nhật ký 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ộ kiểm thử ở định dạng xml.
XmlResultReporter	Ghi kết quả JUnit vào các tệp XML theo định dạng nhất quán với XMLJUnitResultFormatter của Ant.

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

Đ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 trường hợp mỗi trình nghe lưu tệp riêng lẻ khi ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) được gọi.

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

Lớp này cũng truyền phiên bản ILogSaver chung để 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 các 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,LogDataType,InputStreamSource,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 các 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,LogDataType,InputStreamSource,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 rõ ràng một cách tường minh.

Tham số
`dataName`	`String`: Tên của dữ liệu
`logFile`	`LogFile`: `LogFile` đã được ghi nhật ký 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.

Bạn nên dùng thuộc tính này 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à người triển khai phải có thể 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 kết quả khi hoàn tất.
`logFile`	`LogFile`: `LogFile` chứa siêu dữ liệu của tệp đã lưu.