ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener
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.