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