ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

คลาสย่อยโดยอ้อมที่ทราบ AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CollectingTestListener และอื่นๆ 52 รายการ AggregatePostProcessor ผู้รวบรวมเมตริกที่ให้ค่าต่ำสุด สูงสุด ค่าเฉลี่ย ความแปรปรวน ค่าเบี่ยงเบนมาตรฐาน ผลรวม จํานวน และเปอร์เซ็นต์ไทล์ (ไม่บังคับ) สําหรับเมตริกตัวเลขที่รวบรวมระหว่างการทดสอบหลายรอบ โดยถือว่าเมตริกเป็นตัวเลขทศนิยม  AtraceCollector IMetricCollector ที่เรียกใช้การติดตามระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกลงในการเรียกใช้  AtraceRunMetricCollector รวบรวมการติดตามจากไดเรกทอรีทดสอบทั้งหมดในไดเรกทอรีที่ระบุจากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีทดสอบ และประมวลผลไฟล์การติดตามในไดเรกทอรีทดสอบในภายหลัง รวมถึงรวบรวมเมตริก  AveragePostProcessor การใช้โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่คำนวณค่าเฉลี่ยของรายการเมตริก  BaseDeviceMetricCollector การใช้งานพื้นฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการเก็บรวบรวมใน onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) และ ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))  BasePostProcessor IPostProcessor พื้นฐานที่การติดตั้งใช้งานทุกรายการควรขยาย  BluetoothConnectionLatencyCollector ตัวรวบรวมจะพุชการกําหนดค่าเมตริกระยะเวลา statsd ที่กําหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อบลูทูธสําหรับแต่ละโปรไฟล์  BluetoothConnectionStateCollector เครื่องมือรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกจํานวนสถานะการเชื่อมต่อสําหรับแต่ละโปรไฟล์  BluetoothConnectionSuccessRatePostProcessor การใช้โปรแกรมประมวลผลผลลัพธ์ซึ่งคํานวณอัตราความสําเร็จสําหรับโปรไฟล์บลูทูธ ใช้ "metric-key-match" เพื่อระบุเมตริกที่มีสถานะการเชื่อมต่อบลูทูธในอาร์เรย์ตัวเลข เช่น [0, 1, 2, 3, 0, 1, 2, 3]  BluetoothHciSnoopLogCollector ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง  BugreportzOnFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อเฟรมทดสอบไม่ผ่าน  BugreportzOnTestCaseFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อเทสเคสในการเรียกใช้ไม่สําเร็จ  ClangCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ Clang จากอุปกรณ์และบันทึกเป็นรายการทดสอบ  CodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ Java และแบบเนทีฟออกจากอุปกรณ์และบันทึกเป็นรายการทดสอบ  CollectingTestListener ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด  ConsoleResultReporter เครื่องมือรายงานผลลัพธ์เพื่อพิมพ์ผลลัพธ์การทดสอบไปยังคอนโซล  CountTestCasesCollector นับและรายงานจํานวนกรณีทดสอบสําหรับ IRemoteTest ที่ระบุ  DebugHostLogOnFailureCollector ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในชุดทดสอบ  DeviceTraceCollector เครื่องมือรวบรวมข้อมูลที่จะเริ่มการติดตามด้วย Perfetto เมื่อการทดสอบเริ่มขึ้นและบันทึกไฟล์การติดตามเมื่อสิ้นสุด  EventsLoggerListener โปรแกรมฟังที่บันทึกเหตุการณ์ทั้งหมดที่ได้รับลงในไฟล์  FileProtoResultReporter เครื่องมือรายงาน Proto ที่ส่งออก TestRecord ไปยังไฟล์  FilePullerDeviceMetricCollector BaseDeviceMetricCollector ที่คอยฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูลเหล่านั้นเป็นไฟล์จากอุปกรณ์  FilePullerLogCollector โปรแกรมบันทึกไฟล์ที่รายงานโดยอุปกรณ์  FormattedGeneratorReporter เครื่องมือรายงานที่อนุญาตให้สร้างรายงานในรูปแบบที่เฉพาะเจาะจง  GcovCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุม gcov จากอุปกรณ์และบันทึกเป็นรายการทดสอบ  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจาก debugfs และออกจากอุปกรณ์ จากนั้นบันทึกเป็นอาร์ติแฟกต์การทดสอบ  GranularRetriableTestWrapper.StartEndCollector ตัวช่วยของคลาสเพื่อจับเวลาเริ่มต้นและสิ้นสุดการเรียกใช้ที่ขาดหายไป  HostStatsdMetricCollector IMetricCollector ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คําสั่งยูทิลิตี statsd   IMetricCollector ระบบจะเพิ่มอินเทอร์เฟซนี้เป็นส่วนตกแต่งเมื่อรายงานผลการทดสอบเพื่อรวบรวมเมตริกที่ตรงกัน  IPostProcessor โปรแกรมประมวลผลผลลัพธ์เป็นออบเจ็กต์ Trade Federation ที่มีไว้เพื่อประมวลผลเมตริกและบันทึกหลังจากการทดสอบและก่อนการรายงานผลลัพธ์  InvocationProtoResultReporter ผู้รายงานเพื่อจัดเก็บข้อมูลการแคชระดับการเรียกใช้และรายการโมดูล  JavaCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ Java จากอุปกรณ์และบันทึกเป็นรายการทดสอบ  JsonHttpTestResultReporter ผู้รายงานผลที่เข้ารหัสผลลัพธ์เมตริกการทดสอบและข้อมูลสาขา อุปกรณ์เป็น JSON และ POST ไปยังปลายทางบริการ HTTP  LUCIResultReporter เครื่องมือรายงานผลลัพธ์ที่บันทึกผลการทดสอบที่ ResultDB และ LUCI ต้องการในรูปแบบ JSON (go/result-sink) และบันทึกตำแหน่งไฟล์ในคอนโซล  LegacySubprocessResultsReporter การติดตั้งใช้งานเครื่องมือรายงานผลของกระบวนการย่อยแบบหยุดทำงานชั่วคราวซึ่งควรจะเข้ากันได้กับ TF/CTS เวอร์ชันเก่า (เช่น 8 ขึ้นไป) แม้ว่าจะมีการเปลี่ยนแปลงในซุปเปอร์คลาสก็ตาม  LogSaverResultForwarder ResultForwarder สําหรับการบันทึกบันทึกด้วยโปรแกรมบันทึกไฟล์ส่วนกลาง  LogcatOnFailureCollector ตัวรวบรวมที่จะบันทึกและบันทึก Logcat เมื่อเฟรมทดสอบไม่ผ่าน  LogcatTimingMetricCollector ตัวรวบรวมเมตริกที่รวบรวมข้อมูลการกําหนดเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำ 1 ครั้งหรือหลายครั้งโดยใช้รูปแบบนิพจน์ทั่วไปที่ระบุเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat  MetricFilePostProcessor ใช้สําหรับการอัปโหลดไฟล์บันทึกเมตริกที่รวบรวมระหว่างการทดสอบและระดับการเรียกใช้  MetricsXMLResultReporter MetricsXMLResultReporter จะเขียนเมตริกการทดสอบและเมตริกการเรียกใช้ลงในไฟล์ XML ในโฟลเดอร์ที่ระบุโดยพารามิเตอร์ metrics-folder ในระยะ invocationEnded ของการทดสอบ  ModuleListener Listener ที่แนบมากับ IRemoteTest แต่ละรายการของโมดูลแต่ละรายการเพื่อรวบรวมรายการผลลัพธ์  ModuleLogcatCollector เวอร์ชันของเครื่องมือรวบรวม Logcat สำหรับโมดูล  ModuleProtoResultReporter ผู้รายงานผลลัพธ์ที่มีไว้เพื่อรายงานเฉพาะผลลัพธ์ระดับโมดูล  PerfettoGenericPostProcessor โปรแกรมประมวลผลผลลัพธ์ที่ประมวลผลไฟล์ Proto ของเมตริกข้อความ/ไบนารีเป็นคู่คีย์-ค่าโดยการขยายข้อความและช่อง Proto ที่มีค่าสตริงแบบซ้ำๆ จนกว่าจะพบช่องที่มีค่าตัวเลข  PerfettoPullerMetricCollector การติดตั้งใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์  ProtoResultReporter ผู้รายงานผลจะสร้าง TestRecord protobuf ที่มีผลการค้นหาทั้งหมดอยู่ภายใน  RebootReasonCollector เครื่องมือรวบรวมข้อมูลที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน  ReportPassedTests รายงานในไฟล์ตัวกรองที่เป็นไปได้เพื่อยกเว้นการทดสอบที่ผ่าน  ResultAggregator ตัวส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจําเป็น โดยอิงตามกลยุทธ์การลองอีกครั้งที่ใช้  ResultAndLogForwarder ตัวส่งต่อสําหรับผลลัพธ์และเหตุการณ์ในบันทึก  ResultDBReporter เครื่องมือรายงานผลลัพธ์ที่อัปโหลดผลการทดสอบไปยัง ResultDB  RetryLogSaverResultForwarder ตัวส่งต่อที่จัดการการส่งผ่านความพยายามปัจจุบันของเราด้วย  RuntimeRestartCollector เครื่องมือรวบรวมข้อมูลที่รวบรวมการประทับเวลาของการเริ่มทํางานอีกครั้ง (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี  ScreenshotOnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึกภาพหน้าจอเมื่อกรอบการทดสอบไม่ผ่าน  ShardListener ITestInvocationListener ที่รวบรวมผลลัพธ์จากกลุ่มการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้หลายรายการพร้อมกันในหลายทรัพยากร) และส่งต่อไปยังโปรแกรมฟังอื่น  ShardMainResultForwarder ResultForwarder ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบที่แบ่งกลุ่ม  ShowmapPullerMetricCollector การติดตั้งใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์  StatsdBeforeAfterGaugeMetricPostProcessor โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลเมตริกการวัดที่รวบรวมในแนวทาง "ก่อน/หลัง" เช่น  StatsdEventMetricPostProcessor โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลเมตริกเหตุการณ์ในรายงาน statsd เป็นคู่คีย์-ค่า โดยใช้รูปแบบที่ระบุไว้ในโปรแกรมประมวลผล  StatsdGenericPostProcessor โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลรายงาน Statsd รูปแบบไบนารีเป็นคู่คีย์-ค่าโดยการขยายรายงานเป็นโครงสร้างต้นไม้  StreamProtoResultReporter การใช้งาน ProtoResultReporter  SubprocessResultsReporter ใช้ ITestInvocationListener เพื่อระบุเป็น result_reporter และส่งต่อผลการทดสอบ การเรียกใช้การทดสอบ และการเรียกใช้การทดสอบจากกระบวนการย่อย  SuiteResultReporter รวบรวมผลการทดสอบสําหรับการเรียกใช้ชุดทดสอบทั้งหมดและแสดงผลลัพธ์สุดท้าย  TextResultReporter ผู้รายงานผลลัพธ์การทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit  TraceCmdCollector IMetricCollector ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกร่องรอยเหล่านั้นลงในการเรียกใช้  XmlFormattedGeneratorReporter การใช้ FormattedGeneratorReporter ซึ่งจัดรูปแบบชุดผลลัพธ์เป็นรูปแบบ XML   XmlResultReporter เขียนผลลัพธ์ JUnit ลงในไฟล์ XML ในรูปแบบที่สอดคล้องกับ XMLJUnitResultFormatter ของ Ant

---

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

วิธีนี้ช่วยให้ ITestInvocationListener หลายรายการใช้ไฟล์บันทึกที่บันทึกไว้เดียวกันเมื่อสร้างรายงาน และช่วยให้ผู้ฟังแต่ละรายไม่ต้องบันทึกไฟล์แยกกันเมื่อเรียกใช้ 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)

นอกจากนี้ คลาสนี้จะส่งอินสแตนซ์ 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) callbacks โดยตรงนั้นไม่สามารถทำได้
default void	setLogSaver(ILogSaver logSaver) ตั้งค่า ILogSaver เพื่ออนุญาตให้ผู้ติดตั้งใช้งานบันทึกไฟล์
default void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) เรียกใช้เมื่อบันทึกบันทึกการทดสอบ

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

พารามิเตอร์
logSaver	ILogSaver: ILogSaver

testLogSaved

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

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

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

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