ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

รู้จักคลาสย่อยทางอ้อม AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOn TestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , ConsoleResultReporter และอีก 47 คน AggregatePostProcessor ตัวรวบรวมเมตริกที่ให้ค่าต่ำสุด สูงสุด ค่าเฉลี่ย ความแปรปรวน ค่าเบี่ยงเบนมาตรฐาน ผลรวม จำนวน และเปอร์เซ็นต์ไทล์ที่เลือกได้สำหรับเมตริกตัวเลขที่รวบรวมระหว่างการทดสอบการวนซ้ำหลายครั้ง โดยถือว่าเป็นสองเท่า AtraceCollector IMetricCollector ที่เรียกใช้ atrace ระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกไปยังการเรียกใช้ AtraceRunMetricCollector รวบรวมการติดตามจากไดเร็กทอรีทดสอบทั้งหมดภายใต้ไดเร็กทอรีที่กำหนดจากอุปกรณ์ทดสอบ บันทึกไดเร็กทอรีทดสอบและประมวลผลไฟล์การติดตามภายหลังภายใต้ไดเร็กทอรีทดสอบและรวมเมตริก โปรเซสเซอร์โพสต์เฉลี่ย การดำเนินการของโพสต์โปรเซสเซอร์ที่คำนวณค่าเฉลี่ยของรายการเมตริก BaseDeviceMetricCollector การใช้งานพื้นฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการรวบรวมบน onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) และ ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) โปรเซสเซอร์ BasePost IPostProcessor พื้นฐานที่ทุกการใช้งานควรขยาย BluetoothConnectionLatencyCollector ตัวรวบรวมจะส่งการกำหนดค่าเมตริกระยะเวลา statsd ที่กำหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อ Bluetooth สำหรับแต่ละโปรไฟล์ BluetoothConnectionStateCollector ตัวรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกหมายเลขสถานะการเชื่อมต่อสำหรับแต่ละโปรไฟล์ BluetoothConnectionSuccessRatePostProcessor การใช้งานตัวประมวลผลภายหลังซึ่งคำนวณอัตราความสำเร็จสำหรับโปรไฟล์บลูทูธ ใช้ "การจับคู่คีย์เมตริก" เพื่อระบุเมตริกที่มีสถานะการเชื่อมต่อบลูทูธในอาร์เรย์ตัวเลข ตัวอย่าง [0, 1, 2, 3, 0, 1, 2, 3] BluetoothHciSnoopLogCollector Collector เพื่อเปิดใช้งานการบันทึกการสอดแนม Bluetooth HCI บน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง BugreportzOnFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบล้มเหลว BugreportzOnTestCaseFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบในการเรียกใช้ล้มเหลว ClangCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุมของเสียงดังกราวออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ การรวบรวม TestListener ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด ConsoleResultReporter ผู้รายงานผลลัพธ์เพื่อพิมพ์ผลการทดสอบไปยังคอนโซล CountTestCaseCollector นับและรายงานจำนวนกรณีทดสอบสำหรับ IRemoteTest ที่กำหนด DebugHostLogOnFailureCollector ตัวรวบรวมที่จะรวบรวมและบันทึกล็อกฝั่งโฮสต์เมื่อเกิดกรณีทดสอบล้มเหลว DeviceTraceCollector ตัวรวบรวมที่จะเริ่มติดตาม perfetto เมื่อการทดสอบเริ่มต้นและบันทึกไฟล์การติดตามในตอนท้าย EventsLoggerListener Listener ที่บันทึกเหตุการณ์ทั้งหมดที่ได้รับลงในไฟล์ FileProtoResultReporter โปรแกรมรายงาน Proto ที่ทิ้ง TestRecord ลงในไฟล์ FilePullerDeviceMetricCollector BaseDeviceMetricCollector ที่ฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงออกมาเป็นไฟล์จากอุปกรณ์ FilePullerLogCollector ตัวบันทึกไฟล์ที่รายงานโดยฝั่งอุปกรณ์ FormattedGeneratorReporter Reporter ที่อนุญาตให้สร้างรายงานในรูปแบบเฉพาะ GcovCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุม gcov ออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ GcovKernelCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจากการดีบักและออกจากอุปกรณ์ จากนั้นบันทึกเป็นสิ่งประดิษฐ์ทดสอบในที่สุด GranularRetriableTestWrapper.StartEndCollector ผู้ช่วยชั้นเรียนเพื่อติดตามการเริ่มต้นและสิ้นสุดการวิ่งที่ขาดหายไป HostStatsdMetricCollector IMetricCollector ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คำสั่งยูทิลิตี้ statsd IMetricCollector อินเทอร์เฟซนี้จะถูกเพิ่มเป็นมัณฑนากรเมื่อรายงานผลการทดสอบเพื่อรวบรวมเมตริกที่ตรงกัน ไอโพสต์โปรเซสเซอร์ โพสต์โปรเซสเซอร์เป็นอ็อบเจกต์ของสหพันธ์การค้าที่อนุญาตให้มีการประมวลผลเมตริกและบันทึกหลังการทดสอบและก่อนการรายงานผล JavaCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดความครอบคลุมของ Java ออกจากอุปกรณ์และบันทึกเป็นสิ่งประดิษฐ์ทดสอบ JsonHttpTestResultReporter ผู้รายงานผลลัพธ์ที่เข้ารหัสผลลัพธ์เมตริกการทดสอบและสาขา ข้อมูลอุปกรณ์ลงใน JSON และ POST ลงในปลายทางบริการ HTTP LegacySubprocessResultsReporter การใช้งานตัวรายงานผลลัพธ์ของกระบวนการย่อยที่หยุดนิ่งซึ่งควรยังคงเข้ากันได้กับ TF/CTS เวอร์ชันก่อนหน้า (เช่น 8+) แม้จะมีการเปลี่ยนแปลงในซูเปอร์คลาสก็ตาม LogSaverResultForwarder ResultForwarder สำหรับบันทึกบันทึกด้วยโปรแกรมรักษาไฟล์ส่วนกลาง LogcatOnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึก logcat เมื่อกรณีทดสอบล้มเหลว LogcatTimingMetricCollector ตัวรวบรวมเมตริกที่รวบรวมข้อมูลเวลา (เช่น เวลาเปลี่ยนของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำหนึ่งครั้งหรือหลายครั้งโดยใช้รูปแบบ regex ที่กำหนดเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat MetricFilePostProcessor ใช้สำหรับการอัปโหลดไฟล์บันทึกเมตริกที่รวบรวมระหว่างระดับการทดสอบและเรียกใช้ เมตริก XMLResultReporter MetricsXMLResultReporter เขียนเมตริกทดสอบและเรียกใช้เมตริกไปยังไฟล์ XML ในโฟลเดอร์ที่ระบุโดยพารามิเตอร์โฟลเดอร์เมตริกที่ระยะการเรียกใช้สิ้นสุดของการทดสอบ โมดูลฟัง Listener ที่แนบมากับแต่ละ IRemoteTest ของแต่ละโมดูลเพื่อรวบรวมรายการผลลัพธ์ โมดูล LogcatCollector เวอร์ชันของตัวรวบรวม logcat แต่สำหรับโมดูล PerfettoGenericPostProcessor ตัวประมวลผลภายหลังที่ประมวลผลไฟล์โปรโตเมตริก perfetto แบบข้อความ/ไบนารีเป็นคู่คีย์-ค่าโดยการขยายข้อความโปรโตและฟิลด์แบบวนซ้ำด้วยค่าสตริงจนกระทั่งพบฟิลด์ที่มีค่าตัวเลข PerfettoPullerMetricCollector การใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ perfetto จากอุปกรณ์และรวบรวมเมตริกจากมัน ProtoResultReporter ผู้รายงานผลลัพธ์สร้างโปรโตบัฟ TestRecord พร้อมผลลัพธ์ทั้งหมดภายใน รีบูตเครื่องรวบรวมเหตุผล ตัวรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและการนับ รายงานผ่านการทดสอบ รายงานตัวกรองที่เป็นไปได้ในไฟล์เพื่อแยกการทดสอบที่ผ่าน ตัวรวบรวมผลลัพธ์ ตัวส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจำเป็น โดยอิงตามกลยุทธ์การลองใหม่ที่ใช้ ผลลัพธ์และ LogForwarder ตัวส่งต่อสำหรับผลลัพธ์และบันทึกเหตุการณ์ ลองอีกครั้ง LogSaverResultForwarder ผู้ส่งต่อที่จัดการกับความพยายามปัจจุบันที่เราทำอยู่ RuntimeRestartCollector ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบการทำงาน หากมี ภาพหน้าจอ OnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึกหน้าจอเมื่อกรณีทดสอบล้มเหลว ShardListener ITestInvocationListener ที่รวบรวมผลลัพธ์จากส่วนแบ่งการร้องขอ (หรือที่เรียกว่าการแบ่งการร้องขอเพื่อเรียกใช้บนทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยังผู้ฟังรายอื่น ShardMainResultForwarder ResultForwarder ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบแบบแบ่งย่อย แสดงแผนที่PullerMetricCollector การใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์แผนที่แสดงจากอุปกรณ์และรวบรวมเมตริกจากอุปกรณ์ StatsdBefore AfterGaugeMetricPostProcessor โพสต์โปรเซสเซอร์ที่ประมวลผลมาตรวัดเกจที่รวบรวมในลักษณะ "ก่อน/หลัง" เช่น StatsdEventMetricPostProcessor ตัวประมวลผลภายหลังที่ประมวลผลเมตริกเหตุการณ์ในรายงาน statsd เป็นคู่คีย์-ค่า โดยใช้ตัวจัดรูปแบบที่ระบุบนตัวประมวลผล StatsdGenericPostProcessor ตัวประมวลผลภายหลังที่ประมวลผลรายงาน binary proto statsd เป็นคู่คีย์-ค่าโดยขยายรายงานเป็นโครงสร้างแบบต้นไม้ StreamProtoResultReporter การใช้งาน ProtoResultReporter SubprocessResultsReporter ใช้ ITestInvocationListener เพื่อระบุเป็น result_reporter และส่งต่อผลลัพธ์ของการทดสอบ การทดสอบรัน การทดสอบการเรียกใช้จากการประมวลผลย่อย SuiteResultReporter รวบรวมผลการทดสอบสำหรับการเรียกใช้ทั้งชุดและแสดงผลสุดท้าย โปรแกรมรายงานผลข้อความ โปรแกรมรายงานผลการทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit TraceCmdCollector IMetricCollector ที่รวบรวมการติดตามระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกไปยังการเรียกใช้ XmlFormattedGeneratorReporter การใช้งาน FormattedGeneratorReporter ซึ่งจัดรูปแบบชุดผลลัพธ์ในรูปแบบ xml XmlResultReporter เขียนผลลัพธ์ JUnit ไปยังไฟล์ XML ในรูปแบบที่สอดคล้องกับ XMLJUnitResultFormatter ของ Ant

---

อนุญาตให้ ITestInvocationListener ฟังเมื่อบันทึกไฟล์บันทึก

ซึ่งช่วยให้ ITestInvocationListener หลายรายการใช้ไฟล์บันทึกที่บันทึกไว้เดียวกันเมื่อสร้างรายงาน และหลีกเลี่ยงการให้แต่ละ Listener บันทึกไฟล์แยกกันเมื่อ ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) เรียกว่า

คลาสที่ใช้อินเทอร์เฟซนี้ควรทราบว่า testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) จะถูกเรียกเมื่อใดก็ตามที่ ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) เรียก ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)

คลาสนี้ยังผ่านอินสแตนซ์ ILogSaver ส่วนกลาง ดังนั้น ITestInvocationListener จึงสามารถบันทึกไฟล์เพิ่มเติมในตำแหน่งเดียวกันได้

สรุป

วิธีการสาธารณะ
default void	logAssociation (String dataName, LogFile logFile) ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้
default void	setLogSaver ( ILogSaver logSaver) ตั้งค่า ILogSaver เพื่ออนุญาตให้ผู้ดำเนินการบันทึกไฟล์
default void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) เรียกใช้เมื่อมีการบันทึกบันทึกการทดสอบ

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

เข้าสู่ระบบสมาคม

public void logAssociation (String dataName, 
                LogFile logFile)

ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้น การเรียกกลับนี้ช่วยให้สามารถเชื่อมโยงอย่างชัดเจนได้

พารามิเตอร์
dataName	String : ชื่อของข้อมูล
logFile	LogFile : LogFile ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

setLogSaver

public void setLogSaver (ILogSaver logSaver)

ตั้งค่า ILogSaver เพื่ออนุญาตให้ผู้ดำเนินการบันทึกไฟล์

พารามิเตอร์
logSaver	ILogSaver : โปรแกรม ILogSaver

บันทึกการทดสอบที่บันทึกไว้

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

เรียกใช้เมื่อมีการบันทึกบันทึกการทดสอบ

ควรใช้แทน ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)

พารามิเตอร์
dataName	String : ชื่ออธิบาย String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ คือผู้ดำเนินการต้องสามารถจัดการการโทรหลายรายการด้วย dataName เดียวกันได้
dataType	LogDataType : LogDataType ของข้อมูล
dataStream	InputStreamSource : InputStreamSource ของข้อมูล Implementers ควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น
logFile	LogFile : LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้