Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável 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, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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 registrar o diretório e analisá-lo para que as métricas sejam colocadas em `DeviceMetricData`.
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Extraia o arquivo de rastreamento do Perfetto 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 registrar o 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 `File` extraído do dispositivo que corresponde à chave de opção.
`runData`	`DeviceMetricData`: o `DeviceMetricData` em que as métricas podem ser armazenadas.

processMetricFile

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

Extraia o arquivo de rastreamento do Perfetto 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 `File` extraído do dispositivo que corresponde à chave de opção.
`data`	`DeviceMetricData`: o `DeviceMetricData` em que 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 de compactação estiver ativada.

Parâmetros
`device`	`ITestDevice`: que tem o arquivo.
`remoteFilePath`	`String`: local no dispositivo.
`userId`	`int`: o ID do usuário de quem extrair

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

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