Effective in 2026, to align with our trunk stable development model and ensure platform stability for the ecosystem, we will publish source code to AOSP in Q2 and Q4. For building and contributing to AOSP, we recommend utilizing android-latest-release instead of aosp-main. The android-latest-release manifest branch will always reference the most recent release pushed to AOSP. For more information, see Changes to 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

A collector which pulls perfetto trace files from the device, optionally compresses them, and adds them to the test logs.

Summary

Public constructors
`PerfettoFilePullerCollector()`

Public methods
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` Implementation of the method should allow to log the directory, parse it for metrics to be put in `DeviceMetricData`.
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Take the perfetto trace file pulled from the device, which can be either raw or compressed, and add it to the test logs.

Protected methods
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Pull the file from the specified path in the device.

Public constructors

PerfettoFilePullerCollector

public PerfettoFilePullerCollector ()

Public methods

processMetricDirectory

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

Implementation of the method should allow to log the directory, parse it for metrics to be put in DeviceMetricData.

Parameters
`key`	`String`: the option key associated to the directory that was pulled.
`metricDirectory`	`File`: the `ERROR(/File)` pulled from the device matching the option key.
`runData`	`DeviceMetricData`: the `DeviceMetricData` where metrics can be stored.

processMetricFile

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

Take the perfetto trace file pulled from the device, which can be either raw or compressed, and add it to the test logs.

Parameters
`key`	`String`: the option key associated to the file that was pulled.
`metricFile`	`File`: the `ERROR(/File)` pulled from the device matching the option key.
`data`	`DeviceMetricData`: the `DeviceMetricData` where metrics can be stored.

Protected methods

retrieveFile

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

Pull the file from the specified path in the device. Pull the compressed content of the perfetto file if the compress perfetto option is enabled.

Parameters
`device`	`ITestDevice`: which has the file.
`remoteFilePath`	`String`: location in the device.
`userId`	`int`: the user id to pull from

Returns
`File`	compressed or decompressed version of perfetto file based on mCompressPerfetto option is set or not.

Throws
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`