A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no 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

Um coletor que extrai arquivos de rastreamento do Perfetto do dispositivo, compacta-os (opcionalmente) e os adiciona aos registros de teste.

Resumo

Construtores públicos
`PerfettoFilePullerCollector()`

Métodos públicos
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` A implementação do método precisa permitir o registro do diretório e analisá-lo para que as métricas sejam colocadas em `DeviceMetricData`.
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Pegue o arquivo de rastreamento do Perfetto extraído do dispositivo, que pode ser bruto ou compactado, e adicione-o aos registros de teste.

Métodos protegidos
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Extraia o arquivo do caminho especificado no dispositivo.

Construtores públicos

PerfettoFilePullerCollector

public PerfettoFilePullerCollector ()

Métodos públicos

processMetricDirectory

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

A implementação do método precisa permitir o registro do diretório e analisá-lo para que as métricas sejam colocadas em DeviceMetricData.

Parâmetros
`key`	`String`: a chave de opção associada ao diretório extraído.
`metricDirectory`	`File`: o `ERROR(/File)` extraído do dispositivo que corresponde à tecla de opção.
`runData`	`DeviceMetricData`: o `DeviceMetricData` onde as métricas podem ser armazenadas.

processMetricFile

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

Pegue o arquivo de rastreamento do Perfetto extraído do dispositivo, que pode ser bruto ou compactado, e adicione-o aos registros de teste.

Parâmetros
`key`	`String`: a chave de opção associada ao arquivo extraído.
`metricFile`	`File`: o `ERROR(/File)` extraído do dispositivo que corresponde à tecla de opção.
`data`	`DeviceMetricData`: o `DeviceMetricData` onde as métricas podem ser armazenadas.

Métodos protegidos

retrieveFile

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

Extraia o arquivo do caminho especificado no dispositivo. Extraia o conteúdo compactado do arquivo do Perfetto se a opção "Compactar Perfetto" estiver ativada.

Parâmetros
`device`	`ITestDevice`: que tem o arquivo.
`remoteFilePath`	`String`: local no dispositivo.
`userId`	`int`: o ID do usuário a ser extraído

Retorna
`File`	versão compactada ou descompactada do arquivo perfetto com base na opção mCompressPerfetto definida ou não.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`