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.

Trình nghe 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 đơn vị tổng hợp chỉ số cung cấp các 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ố dạng số được thu thập trong quá trình chạy kiểm thử lặp lại nhiều lần, coi họ là đối tượng gấp đôi.
AtraceThu thập	`IMetricCollector` chạy dấu vết trong quá trình kiểm thử, đồng thời thu thập kết quả và ghi nhật ký chúng vào lệnh gọi.
AtraceRunMetricCollectionor	Thu thập dấu vết từ tất cả các thư mục kiểm thử trong thư mục cho sẵn từ thiết bị kiểm thử, ghi nhật ký thư mục kiểm thử và xử lý đăng các tệp theo dõi trong thư mục kiểm thử và tổng hợp các chỉ số.
Trung bìnhPostProcessor	Triển khai trình xử lý bài đăng để tính giá trị trung bình của danh sách các chỉ số.
BaseDeviceMetricCollectionor	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 cần mở rộng.
BluetoothConnectionLatencyCollector	Trình thu thập sẽ đẩy cấu hình chỉ số thời lượng của số liệu thống kê đượ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 trạng thái kết nối của mỗi hồ sơ.
BluetoothConnectionSuccessRatePostProcessor	Triển khai bộ xử lý hậu kỳ để tính tỷ lệ thành công cho cấu hình bluetooth Sử dụng "metric-key-match" (so khớp khoá chỉ số) để chỉ định các chỉ số chứa trạng thái kết nối Bluetooth ở dạng số mảng 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ý snoop Bluetooth HCI trên DUT và để thu thập nhật ký cho mỗi lần kiểm tra.
Báo cáo lỗi thu thập dữ liệu	Một `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 rồi gọi `ITestInvocationListener#testLog` trên các phần tử con sau mỗi lần báo cáo lỗi sẽ được thu thập.
BugreportzOnFailureCollector	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 báo cáo lỗi khi một trường hợp kiểm thử trong một lần chạy không thành công.
ClangCodeCoverageCollector	Một `BaseDeviceMetricCollector` sẽ kéo Clang các phép đo mức độ sử dụng thiết bị rồi 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.
Điều kiện theo dõi tình trạng lỗi	Theo dõi mọi lỗi của 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 phát hành thiết bị)	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 gốc mà(các) thiết bị sẽ phát hành.
DeviceTraceCollectionor	Trình thu thập sẽ bắt đầu theo dõi perfetto khi bắt đầu chạy kiểm thử và ghi tệp theo dõi ở cuối.
Thiết bị giám sát không có sẵn	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 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.
FilePullerDeviceMetricCollectionor	`BaseDeviceMetricCollector` theo dõi khoá chỉ số từ thiết bị và lấy 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 đưa `TestDescription` vào danh sách cho phép đã báo cáo.
FormattedGeneratorReporter	Trình báo cáo cho phép tạo báo cáo theo định dạng cụ thể.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo gcov các phép đo mức độ sử dụng thiết bị rồi ghi lại các phép đo đó dưới dạng cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy nhân hệ điều hành gcov các phép đo mức độ sử dụng ra khỏi debugfs và tắt thiết bị, sau đó ghi lại chúng dưới dạng kiểm thử cấu phần phần mềm.
GranularRetriableTestWrapper.StartEndCollector	Trình trợ giúp lớp để nắm bắt điểm bắt đầu và kết thúc lượt chạy bị thiếu.
HostStatsdMetricCollectionor	`IMetricCollector` thu thập các chỉ số đã thống kê từ phía máy chủ bằng phần mềm tiện ích có thống kê các lệnh.
ICommandScheduler.IScheduleInvocationListener	Trình nghe các sự kiện gọi khi lệnh gọi hoàn tất.
ILogSaverListener	Cho phép `ITestInvocationListener` nghe thời điểm tệp nhật ký được lưu.
IMetricCollectionor	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 chỉ số phù hợp.
IPostProcessor	Đơn vị xử lý bài đăng là một đối tượng Liên kết thương mại dùng để cho phép xử lý chỉ số và nhật ký SAU KHI thử nghiệm và TRƯỚC KHI báo cáo kết quả.
IShardableListener	`ITestInvocationListener` có thể được phân đoạn.
ISupportGranularKết quả	Giao diện chỉ định liệu `ITestInvocationListener` có hỗ trợ nhận thông tin chi tiết hay không kết quả hay không.
ITestsummaryListener	Giao diện cho phép `ITestInvocationListener` trao đổi một số thông tin hạn chế qua các bản tóm tắt.
InvocationToJUnitResultFronter	Một lớp theo dõi các sự kiện `ITestInvocationListener` và chuyển tiếp các sự kiện đó đến một `TestListener`
JarHostTest.HostTestListener	Trình nghe bao bọc sẽ chuyển tiếp tất cả các sự kiện ngoại trừ testRunStarted() và testRun ended() đến trình nghe được nhúng.
JavaCodeCoverageCollectionor	`BaseDeviceMetricCollector` sẽ kéo Java các phép đo mức độ sử dụng thiết bị rồi ghi lại các phép đo đó dưới dạng 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à nhánh, thông tin thiết bị thành JSON và POST vào điểm cuối của dịch vụ HTTP
LUCIResultReporter	Một trình báo cáo kết quả lưu kết quả thử nghiệm theo yêu cầu của ResultDB và LUCI sang định dạng JSON (go/result-sink) rồi 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ố tác vụ khi phân đoạn cuối cùng đạt đến `invocationEnded(long)`.
Cũ Subprocess ResultsReporter	Việc triển khai cố định của trình báo cáo kết quả quy trình phụ phải luôn tương thích với các phiên bản trước đó của TF/CTS (ví dụ: 8 trở lên), mặc dù có thay đổi trong lớp cấp cao.
LogSaverResultForwarder	`ResultForwarder` để lưu nhật ký bằng trình bảo vệ tệp chung.
LogcatCrashResultPreviewer	Trình nghe đặc biệt: đối với các lỗi (sự cố quy trình đo lường), trình nghe này sẽ cố gắng trích xuất từ Logcat xảy ra sự cố và thêm sự cố đó vào thông báo lỗi liên quan đến bài kiểm thử.
LogcatOnSuccessCollectionor	Trình thu thập sẽ thu thập và ghi nhật ký logcat khi trường hợp kiểm thử không thành công.
LogcatTimingMetricCollectionor	Một trình thu thập chỉ số thu thập thông tin thời gian (ví dụ: thời gian chuyển đổi người dùng) từ logcat trong quá trình một hoặc nhiều lần kiểm tra lặp lại bằng cách sử dụng các mẫu biểu thức chính quy nhất định để phân tích cú pháp tín hiệu bắt đầu và kết thúc của sự kiện từ các dòng logcat.
MetricFilePostProcessor	Dùng để tải lên tệp nhật ký chỉ số được thu thập trong cấp độ thử nghiệm và chạy.
MetricsXMLResultReporter	Đo lường XMLResultReporter ghi các chỉ số kiểm thử và chạy các chỉ số vào tệp XML trong thư mục được chỉ định theo tham số chỉ số-thư mục tại giai đoạn phương thức gọi đã kết thúc của thử nghiệm.
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.
NameMangleListener	Một trình nghe proxy để dịch phương pháp thử nghiệm, lớp và tên gói khi kết quả được báo cáo.
passTestFileReporter	`ITestInvocationListener` lưu danh sách các trường hợp kiểm thử đã vượt qua vào một tệp kiểm thử
PerfettoGenericPostProcessor	Trình xử lý bài đăng xử lý tệp proto văn bản/chỉ số nhị phân perfetto thành các cặp khoá-giá trị bằng cách mở rộng theo cách đệ quy các thông báo và trường proto bằng các giá trị chuỗi cho đến khi trường có gặp phải một giá trị số.
PerfettoPullerMetricCollectionor	Cách 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ị đó.
YourTestEventLogger	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ả sẽ thay thế tên lần chạy bằng tên nhị phân.
Khởi động lại lý do tập hợp	Trình thu thập thu thập dữ liệu về lần khởi động lại thiết bị trong quá trình chạy kiểm thử và báo cáo 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 thành công trong một khoảng thời gian chờ nhất định.
Báo cáo đã vượt qua bài kiểm thử	Báo cáo trong tệp các bộ lọc có thể dùng để loại trừ kiểm thử đã đạt.
Kết quả tổng hợp	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 đã 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 một 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 truyền lần thử hiện tại của chúng ta.
Thử lạiResultForwarder	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 khởi động lại thời gian chạy (sự cố máy chủ hệ thống) trong quá trình kiểm thử chạy, nếu có.
Chụp ảnh màn hìnhOnFailure Collector	Trình thu thập sẽ chụp và ghi nhật ký ả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 phân đoạn lệnh gọi (còn gọi là lệnh phân tách lệnh gọi để chạy trên nhiều tài nguyên song song) và chuyển tiếp chúng đến tài nguyên khác trình nghe.
ShardMainResultPreviewer	`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	Phương thức triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép kéo sơ đồ chương trình khỏi thiết bị rồi thu thập các chỉ số từ thiết bị đó.
StatsdtrướcSauGaugeMetricPostProcessor	Trình xử lý bài đăng sẽ xử lý các chỉ số được thu thập trong "trước/sau" tiếp cận, tức là
StatsdEventMetricPostProcessor	Trình xử lý bài đăng xử lý các chỉ số sự kiện trong các báo cáo thống kê thành các cặp khoá-giá trị, bằng cách sử dụng được chỉ định trên bộ xử lý.
StatsdGenericPostProcessor	Một trình xử lý bài xử lý các báo cáo thống kê 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`
SubprocessOutcomeReporter	Triển khai `ITestInvocationListener` được chỉ định dưới dạng một 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.
TestRunTimer (Trình kiểm thử Test hai)	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 đó xảy ra trong một khoảng thời gian chờ nhất định.
TextResultReporter	Một trình báo cáo kết quả kiểm thử sẽ chuyển tiếp kết quả đến máy in kết quả văn bản JUnit.
TraceCmdCollection	Một `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ời gọi.
TradefedSandboxRunner.Stub scheduledInvocationListener	Một mã giả lập `IScheduledInvocationListener` không thực hiện thao tác nào.
XmlFormattedGeneratorReporter	Việc triển khai `FormattedGeneratorReporter` định dạng bộ công cụ dẫn đến một xml .
Trình báo cáo XmlResultReport	Ghi kết quả JUnit vào 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ử.

Lệnh gọi kiểm thử có thể tự bao gồm nhiều lần chạy kiểm thử, do đó trình tự các lệnh gọi sẽ

gọiStarted(BuildInfo)
Đã bắt đầu kiểm thử
đã bắt đầu thử nghiệm
[kiểm thử không thành công]
thử nghiệm đã kết thúc
...
testRun kết thúc
...
Đã bắt đầu kiểm thử
...
testRun kết thúc
[yêu cầu không thành công]
[nhật ký kiểm thử+]
gọi đã kết thúc
getTóm tắt

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, dù thành công hay do một số lỗi .
`default void`	`invocationFailed(FailureDescription failure)` 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`	`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 trình lập lịch tắt, mang lại cho lệnh gọi cơ hội thực hiện việc gì đó trước khi chấm dứt.
`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

getTóm tắt

public TestSummary getSummary ()

Cho phép InvocationListener trả về 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, dù thành công hay do một số 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 lệnh gọi không 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 lỗi

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

public 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.

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

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

lời gọi bị gián đoạn

public void invocationInterrupted ()

Được gọi khi trình lập lịch tắt, mang lại cho lệnh gọi cơ hội thực hiện việc gì đó trước khi chấm dứt.

Đã bỏ qua lệnh gọi

public void invocationSkipped (SkipReason reason)

Báo cáo lệnh gọi là bị bỏ qua

Tham số
`reason`	`SkipReason`

đã gọi

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. Người báo cáo cần ghi đè phương pháp 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

thử nghiệmMô-đun đã kết thúc

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 việc bắt đầu một mô-đun đang chạy. 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ự. Chỉ được dùng trong lần chạy có sử dụng mô-đun: trình chạy dựa trên bộ sản phẩm.

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