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.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

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

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, và 13 loại khá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ố.
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))`.
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ơ.
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ử.
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ử.
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ử.
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.
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.
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ử.
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.
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ử.
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.
ModuleLogcatCollector	Phiên bản của trình thu thập logcat nhưng dành cho mô-đun.
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ị đó.
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.
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.
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 đó.
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.

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.

Bạn không thể sử dụng giao diện này làm ngay cả khi giao diện này mở rộng ITestInvocationListener. Quy trình kiểm tra cấu hình sẽ từ chối cấu hình đó. Bạn phải sử dụng lớp này làm "metrics_collector".

Bộ thu thập dữ liệu không được giữ trạng thái nội bộ vì có thể được sử dụng lại ở một số nơi. Nếu thực sự phải sử dụng trạng thái nội bộ, thì bạn nên xoá trạng thái đó trên init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Tóm tắt

Phương thức công khai
`default boolean`	`captureModuleLevel()` Bộ thu có áp dụng cho tính năng thu thập ở cấp mô-đun hay không và có cần khởi tạo hay không.
`abstract`	`getBuildInfos()` Trả về danh sách thông tin bản dựng có sẵn trong lệnh gọi.
`abstract`	`getDevices()` Trả về danh sách các thiết bị có sẵn trong lệnh gọi.
`abstract ITestInvocationListener`	`getInvocationListener()` Trả về `ITestInvocationListener` ban đầu mà chúng ta đang chuyển tiếp kết quả.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Khởi chạy trình thu thập dữ liệu bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử không thành công.
`default void`	`onTestModuleEnded()` Cho phép ghi lại sự kiện kết thúc mô-đun.
`default void`	`onTestModuleStarted()` Cho phép ghi lại sự kiện bắt đầu mô-đun.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Lệnh gọi lại khi một lần chạy kiểm thử kết thúc.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Lệnh gọi lại khi bắt đầu chạy kiểm thử.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Lệnh gọi lại khi bắt đầu chạy kiểm thử.
`abstract void`	`onTestStart(DeviceMetricData testData)` Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

Phương thức công khai

captureModuleLevel

public boolean captureModuleLevel ()

Bộ thu có áp dụng cho tính năng thu thập ở cấp mô-đun hay không và có cần khởi tạo hay không.

Giá trị trả về
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Trả về danh sách thông tin bản dựng có sẵn trong lệnh gọi.

Giá trị trả về

getDevices

public abstract  getDevices ()

Trả về danh sách các thiết bị có sẵn trong lệnh gọi.

Giá trị trả về

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Trả về ITestInvocationListener ban đầu mà chúng ta đang chuyển tiếp kết quả.

Giá trị trả về
`ITestInvocationListener`

khởi tạo

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Khởi chạy trình thu thập dữ liệu bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả. Sẽ chỉ được gọi một lần cho mỗi thực thể và trình thu thập dữ liệu dự kiến sẽ cập nhật ngữ cảnh và trình nghe nội bộ. Init sẽ không bao giờ được gọi trong quá trình chạy kiểm thử.

Đừng ghi đè trừ phi bạn biết mình đang làm gì.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` cho lệnh gọi đang diễn ra.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` nơi đặt kết quả.

Giá trị trả về
`ITestInvocationListener`	trình nghe mới bao bọc trình nghe ban đầu.

Gửi
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là lúc dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử. Sẽ là đối tượng giống như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là lúc dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử. Sẽ là đối tượng giống như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Gửi
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Cho phép ghi lại sự kiện kết thúc mô-đun.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Cho phép ghi lại sự kiện bắt đầu mô-đun.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Lệnh gọi lại khi một lần chạy kiểm thử kết thúc. Đây là lúc dọn dẹp.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho lần chạy. Sẽ là đối tượng giống như trong `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testRunEnded(long,Map))`.

Gửi
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Lệnh gọi lại khi bắt đầu chạy kiểm thử.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho lần chạy.

Gửi
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Lệnh gọi lại khi bắt đầu chạy kiểm thử.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho lần chạy.
`testCount`	`int`: số lượng trường hợp kiểm thử trong lần chạy kiểm thử này.

Gửi
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.

Gửi
`DeviceNotAvailableException`