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.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

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à 77 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ử.
BugreportCollector	`ITestInvocationListener` truyền qua 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 khi thu thập mỗi 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ẽ 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ử.
CommandStatusHandler	Trình xử lý giúp theo dõi và cập nhật trạng thái của lệnh gọi.
ConditionFailureMonitor	Theo dõi mọi lỗi xảy ra trong lệnh gọi.
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ử.
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 mẹ (parent process) về (các) thiết bị sẽ được phát hành.
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.
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 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.
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	`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.
ICommandScheduler.IScheduledInvocationListener	Trình nghe cho các sự kiện gọi khi lệnh gọi hoàn tất.
ILogSaverListener	Cho phép `ITestInvocationListener` lắng nghe thời điểm lưu tệp nhật ký.
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ả.
IShardableListener	`ITestInvocationListener` có thể được phân đoạn.
ISupportGranularResults	Giao diện chỉ định xem `ITestInvocationListener` có hỗ trợ nhận kết quả chi tiết hay không.
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 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 đó
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 trình bao bọc chuyển tiếp tất cả sự kiện ngoại trừ testRunStarted() và testRunEnded() đến trình nghe nhúng.
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.
LastShardDetector	Khi chạy tính năng phân đoạn cục bộ, đôi khi chúng ta chỉ muốn thực thi một số hành động khi phân đoạn cuối cùng đạt đến `invocationEnded(long)`.
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.
LogcatCrashResultForwarder	Trình nghe đặc biệt: khi xảy ra 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 sự cố từ logcat và thêm sự cố đó vào thông báo lỗi liên kết với kiểm thử.
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.
NameMangleListener	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	`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ử
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ị đó.
PrettyTestEventLogger	Trình ghi nhật ký so khớp các sự kiện và ghi lại các sự kiện đó để dễ dàng gỡ lỗi hơn.
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.
PythonBinaryHostTest.PythonForwarder	Trình chuyển tiếp kết quả để thay thế tên chạy bằng tên tệp nhị phân.
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.
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 vượt quá thời gian chờ nhất định.
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.
ResultForwarder	`ITestInvocationListener` chuyển tiếp kết quả gọi đến danh sách các trình nghe khác.
RetryLogSaverResultForwarder	Trình chuyển tiếp cũng xử lý việc chuyển tiếp lượt thử hiện tại.
RetryResultForwarder	Một phần mở rộng của `ResultForwarder` luôn đẩy đến một số lần thử nhất định.
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.
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à không thành công nếu trường hợp kiểm thử đó vượt quá thời gian chờ nhất định.
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.
TradefedSandboxRunner.StubScheduledInvocationListener	Một `IScheduledInvocationListener` giả không làm gì cả.
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.

Trình nghe cho kết quả kiểm thử từ lệnh gọi kiểm thử.

Một lệnh gọi kiểm thử có thể bao gồm nhiều lần chạy kiểm thử, vì vậy, trình tự lệnh gọi sẽ là

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

Tóm tắt

Phương thức công khai
`default TestSummary`	`getSummary()` Cho phép InvocationListener trả về một bản tóm tắt.
`default void`	`invocationEnded(long elapsedTime)` Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.
`default void`	`invocationFailed(FailureDescription failure)` Báo cáo một lệnh gọi chưa hoàn tất do một số điều kiện lỗi.
`default void`	`invocationFailed(Throwable cause)` Báo cáo một lệnh gọi chưa hoàn tất do một số điều kiện lỗi.
`default void`	`invocationInterrupted()` Được gọi khi tắt trình lập lịch biểu, cho phép lệnh gọi thực hiện một việc gì đó trước khi kết thúc.
`default void`	`invocationSkipped(SkipReason reason)` Báo cáo một lệnh gọi là đã bỏ qua
`default void`	`invocationStarted(IInvocationContext context)` Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.
`default void`	`testModuleEnded()` Báo cáo kết thúc quá trình chạy mô-đun.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Báo cáo thời điểm bắt đầu chạy một mô-đun.

Phương thức công khai

getSummary

public TestSummary getSummary ()

Cho phép InvocationListener trả về một bản tóm tắt.

Giá trị trả về
`TestSummary`	`TestSummary` tóm tắt quá trình chạy hoặc giá trị rỗng

invocationEnded

public void invocationEnded (long elapsedTime)

Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua của lệnh gọi tính bằng mili giây

invocationFailed

public void invocationFailed (FailureDescription failure)

Báo cáo một lệnh gọi chưa hoàn tất do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`failure`	`FailureDescription`: `FailureDescription` mô tả nguyên nhân gây ra lỗi

invocationFailed

public void invocationFailed (Throwable cause)

Báo cáo một lệnh gọi chưa hoàn tất do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`cause`	`Throwable`: nguyên nhân `Throwable` gây ra lỗi

invocationInterrupted

public void invocationInterrupted ()

Được gọi khi tắt trình lập lịch biểu, cho phép lệnh gọi thực hiện một việc gì đó trước khi kết thúc.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Báo cáo một lệnh gọi là đã bỏ qua

Tham số
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.

Sẽ được khung TradeFederation tự động gọi. Trình báo cáo cần ghi đè phương thức này để hỗ trợ báo cáo nhiều thiết bị.

Tham số
`context`	`IInvocationContext`: thông tin về lệnh gọi

testModuleEnded

public void testModuleEnded ()

Báo cáo kết thúc quá trình chạy mô-đun.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Báo cáo thời điểm bắt đầu chạy một mô-đun. Lệnh gọi lại này được liên kết với testModuleEnded() và không bắt buộc trong trình tự. Tệp này chỉ được dùng trong quá trình chạy sử dụng các mô-đun: trình chạy dựa trên bộ.

Tham số
`moduleContext`	`IInvocationContext`: `IInvocationContext` của mô-đun.