A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

Sottoclassi dirette note

AtraceRunMetricCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector

AtraceRunMetricCollector	Raccoglie le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test ed elabora i file di traccia nella directory di test e aggrega le metriche.
BluetoothHciSnoopLogCollector	Collector per attivare la registrazione di esame HCI Bluetooth sul DUT e raccogliere il log per ogni test.
FilePullerLogCollector	Logger del file segnalato dal lato dispositivo.
PerfettoFilePullerCollector	Un raccoglitore che estrae i file di traccia Perfetto dal dispositivo, li comprime facoltativamente e li aggiunge ai log di test.
PerfettoPullerMetricCollector	Questa classe è obsoleta. Utilizza invece `PerfettoFilePullerCollector` e `ERROR(/PerfettoTracePostProcessor)`.
ShowmapPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche.

Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo e la estrae come file dal dispositivo. Può essere esteso per l'elaborazione aggiuntiva del file.

Riepilogo

Campi
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

Costruttori pubblici
`FilePullerDeviceMetricCollector()`

Metodi pubblici
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback al termine di uno scenario di test.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback quando un test viene terminato.
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` L'implementazione del metodo deve consentire di registrare la directory, analizzarla per le metriche da inserire in `DeviceMetricData`.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` L'implementazione del metodo deve consentire di registrare il file, analizzarlo per estrarre le metriche da inserire in `DeviceMetricData`.

Metodi protetti
`void`	`addKeys(String... keys)` Aggiunge chiavi di pattern aggiuntive al pull dal dispositivo.
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Estrai il file dal percorso specificato nel dispositivo.

Campi

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

Costruttori pubblici

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

Metodi pubblici

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento della pulizia.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test. Sarà lo stesso oggetto di `BaseDeviceMetricCollector.onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: la mappatura attuale delle metriche trasmesse a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Lanci
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback quando un test viene terminato. Questo dovrebbe essere il momento della pulizia.

Parametri
`runData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per l'esecuzione. Sarà lo stesso oggetto di `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: la mappatura attuale delle metriche trasmesse a `ERROR(/#testRunEnded(long,Map))`.

Lanci
`DeviceNotAvailableException`

processMetricDirectory

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

L'implementazione del metodo deve consentire di registrare la directory, analizzarla per le metriche da inserire in DeviceMetricData.

Parametri
`key`	`String`: la chiave dell'opzione associata alla directory estratta.
`metricDirectory`	`File`: il `ERROR(/File)` estratto dal dispositivo corrispondente alla chiave dell'opzione.
`data`	`DeviceMetricData`: il `DeviceMetricData` in cui possono essere archiviate le metriche.

processMetricFile

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

L'implementazione del metodo deve consentire di registrare il file, analizzarlo per estrarre le metriche da inserire in DeviceMetricData.

Parametri
`key`	`String`: la chiave di opzione associata al file estratto.
`metricFile`	`File`: il `ERROR(/File)` estratto dal dispositivo corrispondente alla chiave dell'opzione.
`data`	`DeviceMetricData`: il `DeviceMetricData` in cui possono essere archiviate le metriche.

Metodi protetti

addKeys

protected void addKeys (String... keys)

Aggiunge chiavi di pattern aggiuntive al pull dal dispositivo.

Parametri
`keys`	`String`

retrieveFile

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

Estrai il file dal percorso specificato nel dispositivo.

Parametri
`device`	`ITestDevice`: che contiene il file.
`remoteFilePath`	`String`: posizione nel dispositivo.
`userId`	`int`: l'ID utente da cui estrarre i dati

Ritorni
`File`	File recuperato dal percorso specificato nel dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`