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.

PerfettoFilePullerCollector

public class PerfettoFilePullerCollector
extends FilePullerDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector
		↳	com.android.tradefed.device.metric.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ử.

Tóm tắt

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

Phương thức công khai
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` 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`.
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Lấy tệp dấu vết Perfetto được kéo từ thiết bị (có thể là tệp thô hoặc tệp nén) rồi thêm tệp đó vào nhật ký kiểm thử.

Phương thức được bảo vệ
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Kéo tệp từ đường dẫn đã chỉ định trong thiết bị.

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

PerfettoFilePullerCollector

public PerfettoFilePullerCollector ()

Phương thức công khai

processMetricDirectory

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

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.
`runData`	`DeviceMetricData`: `DeviceMetricData` nơi có thể lưu trữ các chỉ số.

processMetricFile

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

Lấy tệp dấu vết Perfetto được kéo từ thiết bị (có thể là tệp thô hoặc tệp nén) rồi thêm tệp đó vào nhật ký kiểm thử.

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ệ

retrieveFile

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

Kéo tệp từ đường dẫn đã chỉ định trong thiết bị. Kéo nội dung đã nén của tệp perfetto nếu bạn bật tuỳ chọn nén perfetto.

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`	phiên bản nén hoặc giải nén của tệp perfetto dựa trên lựa chọn mCompressPerfetto được đặt hay không.

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