Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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	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à phân vị (không bắt buộc) cho các chỉ số số được thu thập trong quá trình kiểm thử lặp lại nhiều lần, coi các chỉ số đó là số kép.
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.
AtraceRunMetricCollectionor	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 lại 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	Trình thu thập sẽ đẩy một cấu hình chỉ số thời lượng thống kê được xác định trước tới 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 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 các báo cáo lỗi khi xảy ra các sự kiện có thể định cấu hình, sau đó gọi `ITestInvocationListener#testLog` trên các phần tử con sau mỗi lần báo cáo lỗi được thu thập.
BugreportzOnFailureCollectionor	Thu thập báo cáo lỗi khi 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ử.
CollectioningTestListener	`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.
Điều kiện theo dõi tình trạng lỗi	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	Trình thu thập sẽ thu thập và ghi nhật ký phía máy chủ 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 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.
Thiết bị không có sẵn theo dõi	Trình nghe này chỉ cố gắng thu thập ADN ở 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ố từ thiết bị và kéo 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.
HostStatsdMetricCollectionor	`IMetricCollector` thu thập các chỉ số statsd từ phía máy chủ lưu trữ bằng các lệnh tiện ích statsd.
ICommandScheduler.IScheduledInvocationListener	Trình nghe 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 làm trình trang trí khi báo cáo kết quả thử nghiệm để thu thập các chỉ số phù hợp.
IPostProcessor	Bộ xử lý sau là một đối tượng của 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.
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 sẽ chuyển tiếp tất cả các sự kiện ngoại trừ testRunStarted() và testRunSigned() tới trình nghe được 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 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	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 bảo vệ tệp chung.
LogcatCrashResultPreviewer	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ả.
ModuleLogcatThu thập	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 nhật ký chúng để gỡ lỗi dễ dàng hơn.
ProtoResultReporter	Trình báo cáo kết quả sẽ tạo một protobuf `TestRecord` có 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.
khởi động lại lý tính sưu tập	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ực hiện được nếu 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ể 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 trong nhật ký.
Kết quả chuyển tiếp	`ITestInvocationListener` chuyển tiếp kết quả gọi đến danh sách các trình nghe khác.
Thử lạiLogSaverResultForwarder	Trình chuyển tiếp cũng xử lý việc chuyển tiếp lượt thử hiện tại.
Thử lạiResultForwarder	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 một lệnh gọi kiểm thử được phân đoạn.
ShowmapPullerMetricCollectionor	Cách triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép lấy các tệp sơ đồ chương trình từ thiết bị và thu thập các chỉ số từ thiết bị đó.
StatsdTrướcSauGaugeMetricPostProcessor	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	Một trình 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 dưới dạng results_reporter và chuyển tiếp từ quy trình phụ 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ộ và đưa ra 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.
TestRunTimer (Trình kiểm thử Test hai)	Trình nghe hỗ trợ 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ực hiện được nếu 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 một tệp XML ở định dạng phù hợp với XMLJUnitResultFormatter của Ant.

Trình nghe 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à

gọiStarted(BuildInfo)
Đã bắt đầu kiểm thử
đã bắt đầu thử nghiệm
[testFailed]
testEnded
...
testRunEnded
...
Đã bắt đầu kiểm thử
...
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ề 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 lệnh gọi không 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 lệnh gọi là bị 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 khi kết thúc chạy mô-đun.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Báo cáo việc bắt đầu một mô-đun đang chạy.

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

gọi đã kết thúc

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

kích hoạt không thành công

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 khi kết thúc 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.