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

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

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

คลาสย่อยโดยอ้อมที่ทราบ

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector และอื่นๆ 13 รายการ

AtraceCollector	`IMetricCollector` ที่เรียกใช้การติดตามระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกลงในการเรียกใช้
AtraceRunMetricCollector	รวบรวมการติดตามจากไดเรกทอรีทดสอบทั้งหมดในไดเรกทอรีที่ระบุจากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีทดสอบ และประมวลผลไฟล์การติดตามในไดเรกทอรีทดสอบในภายหลัง รวมถึงรวบรวมเมตริก
BaseDeviceMetricCollector	การใช้งานพื้นฐานของ `IMetricCollector` ที่อนุญาตให้เริ่มและหยุดการเก็บรวบรวมใน `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` และ `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BluetoothConnectionLatencyCollector	ตัวรวบรวมจะพุชการกําหนดค่าเมตริกระยะเวลา statsd ที่กําหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อบลูทูธสําหรับแต่ละโปรไฟล์
BluetoothConnectionStateCollector	เครื่องมือรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกจํานวนสถานะการเชื่อมต่อสําหรับแต่ละโปรไฟล์
BluetoothHciSnoopLogCollector	ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง
BugreportzOnFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเฟรมทดสอบไม่ผ่าน
BugreportzOnTestCaseFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเทสเคสในการเรียกใช้ไม่สําเร็จ
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Clang จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java และแบบเนทีฟออกจากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CountTestCasesCollector	นับและรายงานจํานวนกรณีทดสอบสําหรับ `IRemoteTest` ที่ระบุ
DebugHostLogOnFailureCollector	ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในชุดทดสอบ
DeviceTraceCollector	เครื่องมือรวบรวมข้อมูลที่จะเริ่มการติดตามด้วย Perfetto เมื่อการทดสอบเริ่มขึ้นและบันทึกไฟล์การติดตามเมื่อสิ้นสุด
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` ที่คอยฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูลเหล่านั้นเป็นไฟล์จากอุปกรณ์
FilePullerLogCollector	โปรแกรมบันทึกไฟล์ที่รายงานโดยอุปกรณ์
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุม gcov จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจาก debugfs และออกจากอุปกรณ์ จากนั้นบันทึกเป็นอาร์ติแฟกต์การทดสอบ
HostStatsdMetricCollector	`IMetricCollector` ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คําสั่งยูทิลิตี statsd
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
LogcatOnFailureCollector	ตัวรวบรวมที่จะบันทึกและบันทึก Logcat เมื่อเฟรมทดสอบไม่ผ่าน
LogcatTimingMetricCollector	ตัวรวบรวมเมตริกที่รวบรวมข้อมูลการกําหนดเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำ 1 ครั้งหรือหลายครั้งโดยใช้รูปแบบนิพจน์ทั่วไปที่ระบุเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat
ModuleLogcatCollector	เวอร์ชันของเครื่องมือรวบรวม Logcat สำหรับโมดูล
PerfettoPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
RebootReasonCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน
RuntimeRestartCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการประทับเวลาของการเริ่มทํางานอีกครั้ง (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี
ScreenshotOnFailureCollector	ตัวรวบรวมที่จะจับภาพและบันทึกภาพหน้าจอเมื่อกรอบการทดสอบไม่ผ่าน
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
TraceCmdCollector	`IMetricCollector` ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกร่องรอยเหล่านั้นลงในการเรียกใช้

ระบบจะเพิ่มอินเทอร์เฟซนี้เป็นตัวตกแต่งเมื่อรายงานผลการทดสอบเพื่อรวบรวมเมตริกที่ตรงกัน

อินเทอร์เฟซนี้ใช้ไม่ได้เป็น แม้ว่าจะขยาย ITestInvocationListener ก็ตาม การตรวจสอบการกําหนดค่าจะปฏิเสธ และต้องใช้เป็น "metrics_collector"

เราไม่คาดหวังให้ตัวรวบรวมเก็บสถานะภายในไว้ เนื่องจากอาจมีการนําไปใช้ซ้ำในหลายที่ หากจำเป็นต้องใช้สถานะภายในจริงๆ ก็ควรล้างสถานะใน init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener)

สรุป

เมธอดสาธารณะ
`default boolean`	`captureModuleLevel()` เครื่องมือรวบรวมข้อมูลใช้ได้กับการบันทึกระดับโมดูลหรือไม่ และควรเริ่มต้นหรือไม่
`abstract`	`getBuildInfos()` แสดงรายการข้อมูลบิลด์ที่มีในการเรียกใช้
`abstract`	`getDevices()` แสดงรายการอุปกรณ์ที่ใช้ได้ในการเรียกใช้
`abstract ITestInvocationListener`	`getInvocationListener()` แสดงผล `ITestInvocationListener` เดิมที่เราส่งต่อผลลัพธ์
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` เริ่มต้นใช้งานเครื่องมือรวบรวมข้อมูลด้วยบริบทปัจจุบันและปลายทางที่จะส่งต่อผลลัพธ์
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` เรียกกลับเมื่อกรอบการทดสอบไม่ผ่านเนื่องจากความคาดหวังไม่สำเร็จ
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` การติดต่อกลับเมื่อกรณีทดสอบสิ้นสุดลง
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` การติดต่อกลับเมื่อกรณีทดสอบสิ้นสุดลง
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` การเรียกกลับเมื่อกรอบการทดสอบไม่ผ่าน
`default void`	`onTestModuleEnded()` อนุญาตให้บันทึกเหตุการณ์ที่โมดูลสิ้นสุด
`default void`	`onTestModuleStarted()` อนุญาตให้บันทึกเหตุการณ์ที่โมดูลเริ่มต้น
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` การโทรกลับเมื่อการทดสอบสิ้นสุดลง
`abstract void`	`onTestRunStart(DeviceMetricData runData)` การเรียกกลับเมื่อเริ่มการทดสอบ
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` การเรียกกลับเมื่อเริ่มการทดสอบ
`abstract void`	`onTestStart(DeviceMetricData testData)` การเรียกกลับเมื่อเริ่มการทดสอบเคส

เมธอดสาธารณะ

captureModuleLevel

public boolean captureModuleLevel ()

เครื่องมือรวบรวมข้อมูลใช้ได้กับการบันทึกระดับโมดูลหรือไม่ และควรเริ่มต้นหรือไม่

คิกรีเทิร์น
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

แสดงรายการข้อมูลบิลด์ที่มีในการเรียกใช้

คิกรีเทิร์น

getDevices

public abstract  getDevices ()

แสดงรายการอุปกรณ์ที่ใช้ได้ในการเรียกใช้

คิกรีเทิร์น

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

แสดงผล ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์

คิกรีเทิร์น
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

เริ่มต้นใช้งานเครื่องมือรวบรวมข้อมูลด้วยบริบทปัจจุบันและปลายทางที่จะส่งต่อผลลัพธ์ ระบบจะเรียกใช้เพียงครั้งเดียวต่ออินสแตนซ์ และคาดว่าเครื่องมือรวบรวมข้อมูลจะอัปเดตบริบทและตัวรับฟังภายใน ก่อนหน้านี้จะไม่มีการเปิดใช้งาน Init ในระหว่างการทดสอบ

อย่าลบล้างเว้นแต่คุณจะรู้สิ่งที่ทํา

พารามิเตอร์
`context`	`IInvocationContext`: `IInvocationContext` ของการเรียกใช้ที่อยู่ระหว่างดำเนินการ
`listener`	`ITestInvocationListener`: `ITestInvocationListener` สำหรับวางผลลัพธ์

คิกรีเทิร์น
`ITestInvocationListener`	โปรแกรมฟังเสียงใหม่จะรวมโปรแกรมฟังเสียงเดิม

โยน
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

เรียกกลับเมื่อกรอบการทดสอบไม่ผ่านเนื่องจากความคาดหวังไม่สำเร็จ

พารามิเตอร์
`testData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสำหรับกรณีทดสอบ
`test`	`TestDescription`: `TestDescription` ของกรอบการทดสอบที่อยู่ระหว่างดำเนินการ

โยน
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

การติดต่อกลับเมื่อกรณีทดสอบสิ้นสุดลง ขั้นตอนนี้ควรเป็นขั้นตอนการล้าง

พารามิเตอร์
`testData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับใน `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`
`currentTestCaseMetrics`	: แผนที่เมตริกปัจจุบันที่ส่งไปยัง `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`
`test`	`TestDescription`: `TestDescription` ของกรอบการทดสอบที่อยู่ระหว่างดำเนินการ

โยน
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

พารามิเตอร์
`testData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับใน `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`
`currentTestCaseMetrics`	: แผนที่เมตริกปัจจุบันที่ส่งไปยัง `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`

โยน
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

การเรียกกลับเมื่อกรอบการทดสอบไม่ผ่าน

พารามิเตอร์
`testData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสำหรับกรณีทดสอบ
`test`	`TestDescription`: `TestDescription` ของกรอบการทดสอบที่อยู่ระหว่างดำเนินการ

โยน
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

อนุญาตให้บันทึกเหตุการณ์ที่โมดูลสิ้นสุด

โยน
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

อนุญาตให้บันทึกเหตุการณ์ที่โมดูลเริ่มต้น

โยน
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

การโทรกลับเมื่อการทดสอบสิ้นสุดลง ขั้นตอนนี้ควรเป็นขั้นตอนการล้าง

พารามิเตอร์
`runData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสําหรับการเรียกใช้ จะเป็นออบเจ็กต์เดียวกันกับระหว่าง `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`
`currentRunMetrics`	: แผนที่เมตริกปัจจุบันที่ส่งไปยัง `ERROR(/#testRunEnded(long,Map))`

โยน
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

การเรียกกลับเมื่อเริ่มการทดสอบ

พารามิเตอร์
`runData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสําหรับการเรียกใช้

โยน
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

การเรียกกลับเมื่อเริ่มการทดสอบ

พารามิเตอร์
`runData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสําหรับการเรียกใช้
`testCount`	`int`: จํานวนกรณีทดสอบในการเรียกใช้การทดสอบนี้

โยน
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

การเรียกกลับเมื่อเริ่มการทดสอบเคส

พารามิเตอร์
`testData`	`DeviceMetricData`: `DeviceMetricData` ที่มีข้อมูลสำหรับกรณีทดสอบ

โยน
`DeviceNotAvailableException`