Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

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à 14 trình thu thập khác.

AtraceCollector	Một `IMetricCollector` chạy atrace trong quá trình kiểm thử, thu thập kết quả và ghi nhật ký kết quả vào lệnh gọi.
AtraceRunMetricCollector	Thu thập các 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ý hậu kỳ các tệp dấu vết 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ơ bản 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	Trình thu thập 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	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ơ.
BluetoothHciSnoopLogCollector	Trình 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 từng 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	Một `BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của Clang ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
CodeCoverageCollector	Một `BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của Java và gốc ra khỏi thiết bị, đồng thời ghi lại các phép đo đó dưới dạng các 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	Trình thu thập sẽ thu thập và ghi nhật ký phía máy chủ lưu trữ khi xảy ra lỗi trường hợp kiểm thử.
DeviceTraceCollector	Bộ thu thập sẽ bắt đầu dấu vết perfetto khi bắt đầu chạy kiểm thử và ghi tệp dấu vết vào cuối.
FilePullerDeviceMetricCollector	Một `BaseDeviceMetricCollector` lắng nghe khoá chỉ số đến từ thiết bị và kéo 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.
GcovCodeCoverageCollector	Một `BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp gcov ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của hạt nhân gcov ra khỏi debugfs và khỏi thiết bị, sau đó ghi nhật ký các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
HostStatsdMetricCollector	Một `IMetricCollector` thu thập các chỉ số statsd từ phía máy chủ lưu trữ bằng cách sử dụng các lệnh tiện ích statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo các phép đo mức độ phù hợp của Java ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.
LogcatOnFailureCollector	Trình thu thập sẽ ghi lại và đăng nhập một logcat khi một trường hợp kiểm thử không thành công.
LogcatTimingMetricCollector	Một trình 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 biểu thức chính quy đã cho để 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.
PerfettoFilePullerCollector	Một trình thu thập kéo các tệp dấu vết perfetto từ thiết bị, nén các tệp đó (nếu có) và thêm các tệp đó vào nhật ký kiểm thử.
PerfettoPullerMetricCollector	Lớp này không được dùng nữa. Thay vào đó, hãy sử dụng `PerfettoFilePullerCollector` và `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Trình thu thập dữ liệu thu thập thông tin về quá trình khởi động lại thiết bị trong quá trình chạy thử và báo cáo thông tin đó theo lý do và số lượng.
RuntimeRestartCollector	Trình thu thập thu thập dấu thời gian của các lần khởi động lại thời gian chạy (hệ thống gặp sự cố máy chủ) trong quá trình chạy thử nghiệm (nếu có).
ScreenshotOnFailureCollector	Trình 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	Triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép kéo các tệp showmap từ thiết bị và thu thập các chỉ số từ đó.
TraceCmdCollector	Một `IMetricCollector` thu thập các dấu vết trong quá trình kiểm thử bằng trace-cmd và ghi nhật ký các dấu vết đó vào lệnh gọi.

Giao diện này sẽ được thêm 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.

Không thể 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 yêu cầu này. Bạn phải dùng tham số này làm "metrics_collector".

Trình thu thập không được phép giữ trạng thái nội bộ vì chúng có thể được dùng lại ở nhiều nơi. Nếu bạn thực sự phải dùng trạng thái nội bộ, thì bạn nên dọn dẹp 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()` Liệu trình thu thập có áp dụng cho tính năng chụp ở cấp độ mô-đun hay không và có nên khởi động hay không.
`abstract`	`getBuildInfos()` Trả về danh sách thông tin bản dựng có trong lệnh gọi.
`abstract`	`getDevices()` Trả về danh sách các thiết bị có trong lệnh gọi.
`abstract ITestInvocationListener`	`getInvocationListener()` Trả về `ITestInvocationListener` gốc nơi chúng tôi chuyển tiếp kết quả.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Khởi chạy trình thu thập 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 mô-đun đã bắt đầu.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Lệnh gọi lại khi một lần chạy thử kết thúc.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Lệnh gọi lại khi một lần chạy thử nghiệm bắt đầu.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Lệnh gọi lại khi một lần chạy thử nghiệm bắt đầu.
`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 ()

Liệu trình thu thập có áp dụng cho tính năng chụp ở cấp độ mô-đun hay không và có nên khởi động 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ó trong lệnh gọi.

Giá trị trả về

getDevices

public abstract  getDevices ()

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

Giá trị trả về

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Trả về ITestInvocationListener gốc nơi chúng tôi chuyển tiếp kết quả.

Giá trị trả về
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

Đừ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` chứa 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à thời điểm dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượ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à thời điểm dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượ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` chứa 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 mô-đun đã bắt đầu.

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 thử kết thúc. Đây là thời điểm dọn dẹp.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho lần chạy. Sẽ là cùng một đối tượ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 một lần chạy thử nghiệm bắt đầu.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa 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 một lần chạy thử nghiệm bắt đầu.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa 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` chứa dữ liệu cho trường hợp kiểm thử.

Gửi
`DeviceNotAvailableException`