ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาที่เสถียรของ Trunk และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main ในการสร้างและมีส่วนร่วมใน AOSP android-latest-release สาขาไฟล์ Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

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, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector

AtraceRunMetricCollector	รวบรวมการติดตามจากไดเรกทอรีการทดสอบทั้งหมดภายใต้ไดเรกทอรีที่ระบุ จากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีการทดสอบ และประมวลผลภายหลังไฟล์การติดตาม ภายใต้ไดเรกทอรีการทดสอบ และรวบรวมเมตริก
BluetoothHciSnoopLogCollector	Collector เพื่อเปิดใช้การบันทึกการสอดแนม HCI ของบลูทูธใน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง
FilePullerLogCollector	เครื่องบันทึกของไฟล์ที่รายงานโดยฝั่งอุปกรณ์
PerfettoFilePullerCollector	เครื่องมือรวบรวมที่ดึงไฟล์การติดตามของ Perfetto จากอุปกรณ์ บีบอัดไฟล์ (ไม่บังคับ) และ เพิ่มไฟล์ลงในบันทึกการทดสอบ
PerfettoPullerMetricCollector	คลาสนี้เลิกใช้งานแล้ว โปรดใช้ `PerfettoFilePullerCollector` และ `ERROR(/PerfettoTracePostProcessor)` แทน
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`