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.

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

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

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector và 83 đố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à 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.
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ý kết quả 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ị kiểm thử, 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(com.android.tradefed.device.metric.DeviceMetricData)` và `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.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ử.
BugreportCollector	Một `ITestInvocationListener` truyền dữ liệu thu thập báo cáo lỗi khi các sự kiện có thể định cấu hình xảy ra, sau đó gọi `ITestInvocationListener.testLog` trên các thành phần con sau mỗi lần thu thập báo cáo lỗi.
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ử.
CommandStatusHandler	Trình xử lý giúp theo dõi và cập nhật trạng thái của một lệnh gọi.
ConditionFailureMonitor	Theo dõi mọi lỗi từ lệnh gọi.
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.
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ử.
DeviceReleaseReporter	Trình báo cáo bản phát hành thiết bị xử lý việc giao tiếp với quy trình chính của(các) thiết bị sẽ được phát hành.
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.
DeviceUnavailableMonitor	Trình nghe này chỉ cố gắng ghi lại DNAE ở cấp trường hợp kiểm thử.
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 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.
FilteredResultForwarder	Biến thể của `ResultForwarder` chỉ cho phép báo cáo danh sách cho phép của `TestDescription`.
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	Một `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à ra 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ử.
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.
ICommandScheduler.IScheduledInvocationListener	Trình nghe cho các sự kiện gọi khi quá trình gọi hoàn tất.
ILogSaverListener	Cho phép `ITestInvocationListener` lắng nghe thời điểm các tệp nhật ký được lưu.
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ả.
IShardableListener	`ITestInvocationListener` có thể được phân đoạn.
ISupportGranularResults	Giao diện chỉ định liệu `ITestInvocationListener` có hỗ trợ nhận kết quả chi tiết hay không.
ITestInvocationListener	Trình nghe kết quả kiểm thử từ lệnh gọi kiểm thử.
ITestSummaryListener	Giao diện cho phép `ITestInvocationListener` trao đổi một số thông tin hạn chế thông qua bản tóm tắt.
InvocationProtoResultReporter	Trình báo cáo lưu trữ thông tin về bộ nhớ đệm ở cấp độ lệnh gọi và danh sách các mô-đun của bộ nhớ đệm
InvocationToJUnitResultForwarder	Một lớp theo dõi các sự kiện `ITestInvocationListener` và chuyển tiếp các sự kiện đó đến `TestListener`.
JarHostTest.HostTestListener	Trình nghe bao bọc chuyển tiếp tất cả sự kiện, ngoại trừ testRunStarted() và testRunEnded() đến trình nghe được nhúng.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của Java 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ử.
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ử 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.
LastShardDetector	Khi chạy phân đoạn cục bộ, đôi khi chúng ta chỉ muốn thực thi một số thao tác khi phân đoạn cuối cùng đạt đến `invocationEnded(long)`.
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 đây (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 toàn cục.
LogcatCrashResultForwarder	Trình nghe đặc biệt: khi có lỗi (quá trình đo lường gặp sự cố), trình nghe này sẽ cố gắng trích xuất thông tin về sự cố từ logcat và thêm thông tin đó vào thông báo lỗi liên kết với kiểm thử.
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ử 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 từng 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	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ử.
NameMangleListener	Một trình nghe proxy để dịch tên phương thức, lớp và gói kiểm thử khi kết quả được báo cáo.
PassingTestFileReporter	Một `ITestInvocationListener` lưu danh sách các trường hợp kiểm thử thành công vào một tệp kiểm thử
PerfettoFilePullerCollector	Một trình thu thập 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.
PrettyTestEventLogger	Trình ghi nhật ký khớp với các sự kiện và ghi nhật ký các sự kiện đó để gỡ lỗi dễ dàng hơn.
ProtoResultReporter	Trình báo cáo kết quả tạo một protobuf `TestRecord` chứa tất cả kết quả bên trong.
PtsBotTest	Chạy các kiểm thử PTS-bot.
PythonBinaryHostTest.PythonForwarder	Result forwarder (Trình chuyển tiếp kết quả) để thay thế tên chạy bằng tên nhị phân.
RebootReasonCollector	Trình thu thập dữ liệu thu thập thông tin về quá trình khởi động lại thiết bị trong quá trình chạy thử và báo cáo thông tin đó 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ác bộ lọc có thể 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.
ResultForwarder	Một `ITestInvocationListener` chuyển tiếp kết quả gọi đến danh sách những trình nghe khác.
ResultReporter
RetryLogSaverResultForwarder	Chuyển tiếp cũng xử lý việc truyền lượt thử hiện tại mà chúng ta đang thực hiện.
RetryResultForwarder	Một tiện ích của `ResultForwarder` luôn đẩy đến một số lần thử nhất định.
RuntimeRestartCollector	Trình thu thập 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ó).
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ử được phân đoạn.
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ừ đó.
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 phương thức 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.
TestRunResultListener	Trình nghe cho phép đọc trạng thái chạy kiểm thử cuối cùng.
TestTimeoutEnforcer	Trình nghe cho phép kiểm tra thời gian thực thi của một trường hợp kiểm thử nhất định và khiến trường hợp đó không thành công nếu vượt quá thời gian chờ nhất định.
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.
TradefedSandboxRunner.StubScheduledInvocationListener	Một phần phụ trợ `IScheduledInvocationListener` không làm gì cả.
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.

Một thực thể có thể thực hiện việc ghi nhật ký luồng dữ liệu thuộc nhiều loại.

Tóm tắt

Phương thức công khai
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Cung cấp nhật ký hoặc dữ liệu gỡ lỗi được liên kết từ lệnh gọi kiểm thử.

Phương thức công khai

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Cung cấp nhật ký hoặc dữ liệu gỡ lỗi được liên kết từ lệnh gọi kiểm thử.

Phải được gọi trước ERROR(/ITestInvocationListener#invocationFailed(Throwable)) hoặc ERROR(/ITestInvocationListener#invocationEnded(long))

Khung TradeFederation sẽ tự động gọi phương thức này, cung cấp nhật ký máy chủ lưu trữ và nhật ký cat của thiết bị (nếu có).

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ó 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 kết quả khi hoàn tất. Người gọi phải đảm bảo nguồn dữ liệu vẫn hiện diện và có thể truy cập cho đến khi phương thức testLog hoàn tất.