IMetricCollector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

รู้จักคลาสย่อยทางอ้อม AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , and 12 others. AtraceCollector IMetricCollector ที่เรียกใช้ atrace ระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกไปยังการเรียกใช้ AtraceRunMetricCollector รวบรวมการติดตามจากไดเร็กทอรีทดสอบทั้งหมดภายใต้ไดเร็กทอรีที่กำหนดจากอุปกรณ์ทดสอบ บันทึกไดเร็กทอรีทดสอบและประมวลผลไฟล์การติดตามภายหลังภายใต้ไดเร็กทอรีทดสอบและรวมเมตริก BaseDeviceMetricCollector การใช้งานพื้นฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการรวบรวมบน onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) และ ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) BluetoothConnectionLatencyCollector ตัวรวบรวมจะส่งการกำหนดค่าเมตริกระยะเวลา statsd ที่กำหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อ Bluetooth สำหรับแต่ละโปรไฟล์ BluetoothConnectionStateCollector ตัวรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกหมายเลขสถานะการเชื่อมต่อสำหรับแต่ละโปรไฟล์ BluetoothHciSnoopLogCollector Collector เพื่อเปิดใช้งานการบันทึกการสอดแนม Bluetooth HCI บน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง BugreportzOnFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบล้มเหลว BugreportzOnTestCaseFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบในการเรียกใช้ล้มเหลว ClangCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุมของเสียงดังกราวออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ CountTestCaseCollector นับและรายงานจำนวนกรณีทดสอบสำหรับ IRemoteTest ที่กำหนด DebugHostLogOnFailureCollector ตัวรวบรวมที่จะรวบรวมและบันทึกล็อกฝั่งโฮสต์เมื่อเกิดกรณีทดสอบล้มเหลว DeviceTraceCollector ตัวรวบรวมที่จะเริ่มติดตาม perfetto เมื่อการทดสอบเริ่มต้นและบันทึกไฟล์การติดตามในตอนท้าย FilePullerDeviceMetricCollector BaseDeviceMetricCollector ที่ฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงออกมาเป็นไฟล์จากอุปกรณ์ FilePullerLogCollector ตัวบันทึกไฟล์ที่รายงานโดยฝั่งอุปกรณ์ GcovCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุม gcov ออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ GcovKernelCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจากการดีบักและออกจากอุปกรณ์ จากนั้นบันทึกเป็นสิ่งประดิษฐ์ทดสอบในที่สุด HostStatsdMetricCollector IMetricCollector ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คำสั่งยูทิลิตี้ statsd JavaCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุมของ Java ออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ LogcatOnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึก logcat เมื่อกรณีทดสอบล้มเหลว LogcatTimingMetricCollector ตัวรวบรวมเมตริกที่รวบรวมข้อมูลเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำหนึ่งครั้งหรือหลายครั้งโดยใช้รูปแบบ regex ที่กำหนดเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat โมดูล LogcatCollector เวอร์ชันของตัวรวบรวม logcat แต่สำหรับโมดูล PerfettoPullerMetricCollector การใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ perfetto จากอุปกรณ์และรวบรวมเมตริกจากมัน รีบูตเครื่องรวบรวมเหตุผล ตัวรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและการนับ RuntimeRestartCollector ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบการทำงาน ถ้ามี ภาพหน้าจอ OnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึกหน้าจอเมื่อกรณีทดสอบล้มเหลว แสดงแผนที่PullerMetricCollector การใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์แผนที่แสดงจากอุปกรณ์และรวบรวมเมตริกจากอุปกรณ์ 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) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) โทรกลับเมื่อกรณีทดสอบสิ้นสุดลง
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) โทรกลับเมื่อกรณีทดสอบสิ้นสุดลง
abstract void	onTestFail ( DeviceMetricData testData, TestDescription test) โทรกลับเมื่อกรณีทดสอบล้มเหลว
default void	onTestModuleEnded () อนุญาตให้จับภาพเหตุการณ์ที่สิ้นสุดของโมดูล
default void	onTestModuleStarted () อนุญาตให้จับภาพเหตุการณ์ที่โมดูลเริ่มต้น
abstract void	onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) โทรกลับเมื่อการทดสอบการทำงานสิ้นสุดลง
abstract void	onTestRunStart ( DeviceMetricData runData) โทรกลับเมื่อเริ่มการทดสอบ
default void	onTestRunStart ( DeviceMetricData runData, int testCount) โทรกลับเมื่อเริ่มการทดสอบ
abstract void	onTestStart ( DeviceMetricData testData) โทรกลับเมื่อกรณีทดสอบเริ่มต้นขึ้น

วิธีการสาธารณะ

จับโมดูลระดับ

public boolean captureModuleLevel ()

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

ส่งคืน
boolean

getBuildInfos

public abstract  getBuildInfos ()

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

ส่งคืน

รับอุปกรณ์

public abstract  getDevices ()

ส่งกลับรายการอุปกรณ์ที่มีอยู่ในการร้องขอ

ส่งคืน

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

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

ส่งคืน
ITestInvocationListener

ในนั้น

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

อย่าลบล้างเว้นแต่คุณจะรู้ว่าคุณกำลังทำอะไรอยู่

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

ส่งคืน
ITestInvocationListener	ผู้ฟังใหม่ที่ห่อตัวเดิม

พ่น
DeviceNotAvailableException

บนการทดสอบสมมติฐานความล้มเหลว

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

โทรกลับเมื่อกรณีทดสอบล้มเหลวโดยมีข้อสันนิษฐานที่ล้มเหลว

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

พ่น
DeviceNotAvailableException

ในการทดสอบสิ้นสุด

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

ในการทดสอบสิ้นสุด

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

ในการทดสอบล้มเหลว

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

โทรกลับเมื่อกรณีทดสอบล้มเหลว

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

พ่น
DeviceNotAvailableException

เมื่อทดสอบโมดูลสิ้นสุดแล้ว

public void onTestModuleEnded ()

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

พ่น
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

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

พ่น
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ในการทดสอบรันสิ้นสุด

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

พ่น
DeviceNotAvailableException

บนTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

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

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

พ่น
DeviceNotAvailableException

บนTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

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

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

พ่น
DeviceNotAvailableException

ในการทดสอบเริ่มต้น

public abstract void onTestStart (DeviceMetricData testData)

โทรกลับเมื่อกรณีทดสอบเริ่มต้นขึ้น

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

พ่น
DeviceNotAvailableException