ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

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	ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง
FilePullerLogCollector	โปรแกรมบันทึกไฟล์ที่รายงานโดยอุปกรณ์
PerfettoPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์

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)` เพิ่มคีย์รูปแบบเพิ่มเติมในการดึงข้อมูลจากอุปกรณ์
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` ดึงไฟล์จากเส้นทางที่ระบุในอุปกรณ์

ช่อง

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`: คีย์ตัวเลือกที่เชื่อมโยงกับไดเรกทอรีที่ดึง
`metricDirectory`	`File`: `ERROR(/File)` ที่ดึงมาจากอุปกรณ์ซึ่งตรงกับแป้นตัวเลือก
`data`	`DeviceMetricData`: `DeviceMetricData` ที่เก็บเมตริกได้

processMetricFile

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

การใช้เมธอดนี้ควรอนุญาตให้บันทึกไฟล์ แยกวิเคราะห์ไฟล์เพื่อใส่เมตริกใน DeviceMetricData

พารามิเตอร์
`key`	`String`: คีย์ตัวเลือกที่เชื่อมโยงกับไฟล์ที่ดึง
`metricFile`	`File`: `ERROR(/File)` ที่ดึงมาจากอุปกรณ์ซึ่งตรงกับแป้นตัวเลือก
`data`	`DeviceMetricData`: `DeviceMetricData` ที่เก็บเมตริกได้

วิธีการที่มีการป้องกัน

addKeys

protected void addKeys (String... keys)

เพิ่มคีย์รูปแบบเพิ่มเติมในการดึงข้อมูลจากอุปกรณ์

พารามิเตอร์
`keys`	`String`

retrieveFile

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

ดึงไฟล์จากเส้นทางที่ระบุในอุปกรณ์

พารามิเตอร์
`device`	`ITestDevice`: ซึ่งมีไฟล์
`remoteFilePath`	`String`: ตำแหน่งในอุปกรณ์
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล

คิกรีเทิร์น
`File`	ไฟล์ที่ดึงมาจากเส้นทางที่ระบุในอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`