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.

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector

Các lớp con trực tiếp đã biết

AtraceRunMetricCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector

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ố.
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ử.
FilePullerLogCollector	Trình ghi nhật ký của tệp do phía thiết bị báo cáo.
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)`.
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ừ đó.

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ị. Có thể được mở rộng để xử lý thêm tệp.

Tóm tắt

Trường
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

Hàm khởi tạo công khai
`FilePullerDeviceMetricCollector()`

Phương thức công khai
`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.
`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`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` Việc triển khai phương thức này sẽ cho phép ghi nhật ký thư mục, phân tích cú pháp thư mục để đưa các chỉ số vào `DeviceMetricData`.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Việc triển khai phương thức này phải cho phép ghi nhật ký tệp, phân tích cú pháp tệp để đưa các chỉ số vào `DeviceMetricData`.

Phương thức được bảo vệ
`void`	`addKeys(String... keys)` Thêm các khoá mẫu bổ sung vào thao tác kéo từ thiết bị.
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Kéo tệp từ đường dẫn đã chỉ định trong thiết bị.

Trường

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

Hàm khởi tạo công khai

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

Phương thức công khai

onTestEnd

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

onTestRunEnd

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

processMetricDirectory

public abstract void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData data)

Việc triển khai phương thức này sẽ cho phép ghi nhật ký thư mục, phân tích cú pháp thư mục để đưa các chỉ số vào DeviceMetricData.

Tham số
`key`	`String`: khoá tuỳ chọn được liên kết với thư mục đã được kéo.
`metricDirectory`	`File`: `ERROR(/File)` được kéo từ thiết bị khớp với khoá tuỳ chọn.
`data`	`DeviceMetricData`: `DeviceMetricData` nơi có thể lưu trữ các chỉ số.

processMetricFile

public abstract void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData data)

Việc triển khai phương thức này phải cho phép ghi nhật ký tệp, phân tích cú pháp tệp để đưa các chỉ số vào DeviceMetricData.

Tham số
`key`	`String`: khoá tuỳ chọn được liên kết với tệp đã được kéo.
`metricFile`	`File`: `ERROR(/File)` được kéo từ thiết bị khớp với khoá tuỳ chọn.
`data`	`DeviceMetricData`: `DeviceMetricData` nơi có thể lưu trữ các chỉ số.

Phương thức được bảo vệ

addKeys

protected void addKeys (String... keys)

Thêm các khoá mẫu bổ sung vào thao tác kéo từ thiết bị.

Tham số
`keys`	`String`

retrieveFile

protected File retrieveFile (ITestDevice device, 
                String remoteFilePath, 
                int userId)

Kéo tệp từ đường dẫn đã chỉ định trong thiết bị.

Tham số
`device`	`ITestDevice`: có tệp đó.
`remoteFilePath`	`String`: vị trí trong thiết bị.
`userId`	`int`: mã người dùng cần lấy

Giá trị trả về
`File`	Tệp được truy xuất từ đường dẫn đã cho trong thiết bị.

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