FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

既知の直接サブクラス AtraceRunMetricCollector、BluetoothHciSnoopLogCollector、FilePullerLogCollector、PerfettoPullerMetricCollector、ShowmapPullerMetricCollector AtraceRunMetricCollector 指定されたディレクトリのすべてのテスト ディレクトリからテストデバイスのトレースを収集し、テスト ディレクトリをログに記録して、テスト ディレクトリのトレースをポスト処理し、指標を集計します。  BluetoothHciSnoopLogCollector DUT で Bluetooth HCI スヌープ ロギングを有効にし、各テストのログを収集するコレクタ。  FilePullerLogCollector デバイス側から報告されたファイルのロガー。  PerfettoPullerMetricCollector デバイスから perfetto ファイルを取得して指標を収集できる FilePullerDeviceMetricCollector の基本実装。  ShowmapPullerMetricCollector デバイスから showmap ファイルを取得し、そこから指標を収集できる FilePullerDeviceMetricCollector の基本実装。

---

デバイスから送信される指標キーをリッスンし、デバイスからファイルとして pull する BaseDeviceMetricCollector。ファイルをさらに処理するために拡張できます。

概要

フィールド
protected	mDirectoryKeys
public	mTestCaseMetrics

パブリック コンストラクタ
FilePullerDeviceMetricCollector()

パブリック メソッド
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) テストケースが終了したときのコーリングバック。
void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) テスト実行が終了したときのコーリングバック。
abstract void	processMetricDirectory(String key, File metricDirectory, DeviceMetricData data) このメソッドの実装では、ディレクトリをログに記録し、DeviceMetricData に配置する指標を解析できるようにする必要があります。
abstract void	processMetricFile(String key, File metricFile, DeviceMetricData data) メソッドの実装では、ファイルをログに記録し、解析して DeviceMetricData に指標を配置できるようにする必要があります。

保護されたメソッド
void	addKeys(String... keys) デバイスからの pull に追加のパターンキーを追加します。
File	retrieveFile(ITestDevice device, String remoteFilePath, int userId) デバイスの指定されたパスからファイルを pull します。

フィールド

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

パブリック コンストラクタ

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

パブリック メソッド

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

テストケースが終了したときに呼び出されるコールバック。この時点でクリーンアップを行います。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。BaseDeviceMetricCollector.onTestStart(com.android.tradefed.device.metric.DeviceMetricData) 時と同じオブジェクトになります。
currentTestCaseMetrics	: ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) に渡された指標の現在のマップ。

例外
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

テスト実行が終了したときのコーリングバック。この時点でクリーンアップを行います。

パラメータ
runData	DeviceMetricData: 実行のデータを保持する DeviceMetricData。BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) のときと同じオブジェクトになります。
currentRunMetrics	: ERROR(/#testRunEnded(long,Map)) に渡された指標の現在のマップ。

例外
DeviceNotAvailableException

processMetricDirectory

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

このメソッドの実装では、ディレクトリをログに記録し、DeviceMetricData に格納する指標を解析できるようにする必要があります。

パラメータ
key	String: pull されたディレクトリに関連付けられたオプションキー。
metricDirectory	File: オプションキーに一致するデバイスから取得された ERROR(/File)。
data	DeviceMetricData: 指標を保存できる DeviceMetricData。

processMetricFile

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

メソッドの実装では、ファイルをログに記録し、DeviceMetricData に格納する指標を解析できるようにする必要があります。

パラメータ
key	String: pull されたファイルに関連付けられたオプションキー。
metricFile	File: オプションキーに一致するデバイスから取得された ERROR(/File)。
data	DeviceMetricData: 指標を保存できる DeviceMetricData。

保護されたメソッド

addKeys

protected void addKeys (String... keys)

デバイスからの pull に追加のパターンキーを追加します。

パラメータ
keys	String

retrieveFile

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

デバイスの指定されたパスからファイルを pull します。

パラメータ
device	ITestDevice: ファイルがあるディレクトリ。
remoteFilePath	String: デバイス内の場所。
userId	int: プル元のユーザー ID

戻り値
File	デバイス内の指定されたパスから取得されたファイル。

例外
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException