ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

คลาสย่อยโดยอ้อมที่รู้จัก AggregatePostProcessor ตัวรวบรวมเมตริกที่ระบุค่าต่ำสุด ค่าสูงสุด ค่าเฉลี่ย ค่าเบี่ยงเบนมาตรฐาน ค่ารวม จำนวน และ เปอร์เซ็นไทล์ (ไม่บังคับ) สำหรับเมตริกตัวเลขที่รวบรวมระหว่างการทดสอบการทดสอบหลายครั้ง เหมือนเป็นโรค 2 เท่า  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 เครื่องมือรวบรวมจะพุชการกำหนดค่าเมตริกระยะเวลาเชิงสถิติที่กำหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวม ระยะเวลาการเชื่อมต่อบลูทูธสำหรับแต่ละโปรไฟล์  BluetoothConnectionStateCollector เครื่องมือรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกสถานะการเชื่อมต่อ สำหรับแต่ละโปรไฟล์  BluetoothConnectionSuccessRatePostProcessor การใช้งานระบบหลังการประมวลผลซึ่งคำนวณอัตราความสำเร็จของโปรไฟล์บลูทูธ ใช้ "metric-key-match" เพื่อระบุเมตริกที่มีสถานะการเชื่อมต่อบลูทูธเป็นตัวเลข ตัวอย่างอาร์เรย์ [0, 1, 2, 3, 0, 1, 2, 3]  บลูทูธHciSnoopLogCollector อุปกรณ์รวบรวมเพื่อเปิดใช้การบันทึก HCI Snoop ของบลูทูธบน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง  BugreportzOnFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรอบการทดสอบล้มเหลว  BugreportzOnTestCaseFailureCollector รวบรวม Bugreportz เมื่อกรณีการทดสอบในการทำงานล้มเหลว  ClangCodecoverCollector BaseDeviceMetricCollector ที่จะดึง Clang การวัดความครอบคลุมภายนอกอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์ทดสอบ  CollectingTestListener ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด  ConsoleResultReporter รายงานผลลัพธ์เพื่อพิมพ์ผลการทดสอบไปยังคอนโซล  CountTestCasesCollector นับและรายงานจำนวนกรอบการทดสอบสำหรับ IRemoteTest ที่ระบุ  DebugHostLogOnFailureCollector เครื่องมือรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อกรอบการทดสอบล้มเหลว  DeviceTraceCollector ผู้รวบรวมที่จะเริ่มการติดตาม Perfetto เมื่อการเรียกใช้การทดสอบเริ่มขึ้นและไฟล์การติดตามในตอนท้าย  EventLoggerListener Listener ที่บันทึกเหตุการณ์ทั้งหมดที่แอปได้รับลงในไฟล์ FileProtoResultReporter ผู้รายงาน Proto ที่ถ่ายโอน TestRecord ลงในไฟล์  FilePullerDeviceMetricCollector BaseDeviceMetricCollectorที่รอรับคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูล เป็นไฟล์จากอุปกรณ์  FilePullerLogCollector ตัวบันทึกไฟล์ที่ด้านอุปกรณ์รายงาน  FormattedGeneratorReporter ตัวรายงานที่อนุญาตให้สร้างรายงานในรูปแบบเฉพาะ  GcovCodecoverCollector BaseDeviceMetricCollector ที่จะดึง gcov การวัดความครอบคลุมภายนอกอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์ทดสอบ  GcovKernelCodecoverCollector BaseDeviceMetricCollector ที่จะดึงเคอร์เนล gcov การวัดความครอบคลุมของ Debugf และนอกอุปกรณ์ จากนั้นจะบันทึกเป็นการทดสอบ และอาร์ติแฟกต์อื่นๆ  GranularRetriableTestWrapper.StartEndCollector ผู้ช่วยของชั้นเรียนที่จะตรวจจับการเริ่มต้นและสิ้นสุดการวิ่งที่ขาดหายไป  HostStatsdMetricCollector IMetricCollector ที่รวบรวมเมตริกทางสถิติจากฝั่งโฮสต์โดยใช้ยูทิลิตีที่มีสถิติ คำสั่ง  IMetricCollector ระบบจะเพิ่มอินเทอร์เฟซนี้เป็นเติมแต่งเมื่อรายงานผลการทดสอบเพื่อรวบรวม เมตริกที่ตรงกัน  PostProcessor ผู้ประมวลผลข้อมูลโพสต์คือออบเจ็กต์สหพันธ์การค้าที่ออกแบบมาเพื่ออนุญาตการประมวลผลเมตริกและบันทึก "หลังจากการทดสอบ" และ "ก่อนการรายงานผล"  JavaCodecoverCollector BaseDeviceMetricCollector ที่จะดึง Java การวัดความครอบคลุมภายนอกอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์ทดสอบ  JsonHttpTestResultReporter รายงานผลลัพธ์ที่เข้ารหัสผลลัพธ์ของเมตริกการทดสอบและสาขา ข้อมูลอุปกรณ์ลงใน JSON และ POST ลงในปลายทางบริการ HTTP LUCIResultReporter รายงานผลลัพธ์ที่บันทึกผลการทดสอบซึ่ง ResultDB และ LUCI ต้องการ เป็นรูปแบบ JSON (go/result-sink) และบันทึกตำแหน่งไฟล์ในคอนโซล  รายงานผลลัพธ์ย่อยแบบเดิม การใช้งานชั่วคราวของผู้รายงานผลลัพธ์ของกระบวนการย่อย ซึ่งควรยังคงเข้ากันได้กับ TF/CTS เวอร์ชันก่อนหน้า (เช่น 8+) แม้ว่าจะมีการเปลี่ยนแปลงในซูเปอร์คลาสก็ตาม  LogSaverผลลัพธ์Forwarder ResultForwarder สำหรับบันทึกบันทึกด้วยโปรแกรมประหยัดไฟล์ส่วนกลาง  LogcatOnFailureCollector ผู้รวบรวมที่จะรับและบันทึก Logcat เมื่อกรอบการทดสอบล้มเหลว  LogcatTimingMetricCollector ตัวรวบรวมเมตริกที่รวบรวมข้อมูลช่วงเวลา (เช่น เวลาเปลี่ยนผู้ใช้) จาก Logcat ระหว่าง การทดสอบซ้ำ 1 หรือหลายรายการโดยใช้รูปแบบนิพจน์ทั่วไปที่กำหนดเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของ เหตุการณ์จากบรรทัด Logcat  MetricFilePostProcessor ใช้สำหรับอัปโหลดไฟล์บันทึกของเมตริกที่รวบรวมระหว่างการทดสอบและระดับการเรียกใช้  MetricsXMLMessageReporter MetricsXMLResultReporter เขียนเมตริกทดสอบและเรียกใช้เมตริกไปยังไฟล์ XML ในโฟลเดอร์ที่ระบุ ตามพารามิเตอร์เมตริก-โฟลเดอร์ที่ช่วง invocationEnded ของการทดสอบ  Listener โมดูล Listener ที่แนบมากับ IRemoteTest แต่ละรายการของแต่ละโมดูลเพื่อรวบรวมรายการ ผลลัพธ์  ModuleLogcatCollector เวอร์ชันของตัวรวบรวม Logcat แต่สำหรับโมดูล  PerfettoGenericPostProcessor โพสต์โปรเซสเซอร์ที่ประมวลผลไฟล์ต้นแบบ Perfetto แบบข้อความ/ไบนารีเป็นคู่คีย์-ค่าโดย ขยายข้อความโปรโตและช่องด้วยค่าสตริงซ้ำไปเรื่อยๆ จนถึงฟิลด์ที่มี พบค่าที่เป็นตัวเลข  PerfettoPullerMetricCollector การใช้งานฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากอุปกรณ์  ProtoResultReporter ผู้รายงานผลลัพธ์สร้าง Protobuf ของ TestRecord ที่มีผลลัพธ์ทั้งหมดด้านใน  รีบูตReasonCollector เครื่องมือรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน  ReportPassedTests รายงานในไฟล์เป็นตัวกรองที่เป็นไปได้เพื่อยกเว้นการทดสอบที่ผ่าน  ผลลัพธ์Aggregator ผู้ส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจำเป็น โดยอิงจากกลยุทธ์การลองใหม่ที่ มีคนใช้  ResultAndLogForwarder ส่งต่อสำหรับผลลัพธ์และบันทึกเหตุการณ์  ลองอีกครั้งLogSaverผลลัพธ์Forwarder ผู้ส่งต่อที่ดำเนินการผ่านการดำเนินการปัจจุบันที่เรามีอยู่  RuntimeRestartCollector ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ วิ่งได้ หากมี  ScreenshotOnFailureCollector ผู้รวบรวมที่จะจับและบันทึกภาพหน้าจอเมื่อกรอบการทดสอบล้มเหลว  ShardListener ITestInvocationListener ที่รวบรวมผลลัพธ์จากชาร์ดการเรียกใช้ (หรือที่เรียกว่า การแยกการเรียกใช้เพื่อเรียกใช้ในทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยังทรัพยากรอื่น Listener  ShardMainResultForwarder ResultForwarder ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบแบบชาร์ด  ShowmapPullerMetricCollector การใช้งานฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงรายการแผนที่ ไฟล์จากอุปกรณ์และรวบรวมเมตริกจากอุปกรณ์ดังกล่าว  StatsdAfterGaugeMetricPostProcessor โปรเซสเซอร์แบบโพสต์ที่ประมวลผลจะวัดเมตริกที่รวบรวมในส่วน "ก่อน/หลัง" แนวทาง เช่น StatsdEventMetricPostProcessor โพสต์โปรเซสเซอร์ที่ประมวลผลเมตริกเหตุการณ์ในรายงานที่มีสถิติเป็นคู่คีย์-ค่า รูปแบบที่ระบุบนโปรเซสเซอร์  PostProcessor ของสถิติ โพสต์โปรเซสเซอร์ที่ประมวลผลรายงานสถิติที่มีโปรโตคอลไบนารีเป็นคู่คีย์-ค่าโดยขยายฟังก์ชัน รายงานเป็นโครงสร้างต้นไม้  StreamProtoResultReporter การใช้งาน ProtoResultReporter ผู้รายงานผลลัพธ์ย่อย ติดตั้งใช้งาน ITestInvocationListener เพื่อมีการระบุเป็น results_reporter และส่งต่อจาก การประมวลผลย่อยผลการทดสอบ การเรียกใช้งานทดสอบ การเรียกใช้ทดสอบ  SuiteResultReporter รวบรวมผลการทดสอบสำหรับการเรียกใช้ทั้งชุดและแสดงผลลัพธ์สุดท้าย  TextResultReporter รายงานผลการทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit  TraceCmdCollector IMetricCollector ที่รวบรวมการติดตามระหว่างการทดสอบโดยใช้ track-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)

คลาสนี้จะส่งอินสแตนซ์ 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) โดยตรง Callback ไม่ได้
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) โดยตรง Callback ไม่ได้ ดังนั้น Callback นี้จึงช่วยให้เกิดการเชื่อมโยงที่แข็งแกร่ง อย่างชัดเจน

พารามิเตอร์
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 ของข้อมูล ผู้ปฏิบัติงานควรโทรติดต่อ createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบว่าได้ปิด InputStream เมื่อเสร็จสมบูรณ์
logFile	LogFile: LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้