ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาแบบ Trunk Stable และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ หากต้องการสร้างและมีส่วนร่วมใน AOSP ให้ใช้ android-latest-release android-latest-release สาขา Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

คลาสย่อยทางอ้อมที่ทราบ

AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector และอื่นๆ อีก 63 รายการ

AggregatePostProcessor	ตัวรวบรวมเมตริกที่ให้ค่าต่ำสุด สูงสุด ค่าเฉลี่ย ความแปรปรวน ค่าเบี่ยงเบนมาตรฐาน ผลรวม จำนวน และ เปอร์เซ็นไทล์ (ไม่บังคับ) สำหรับเมตริกตัวเลขที่รวบรวมระหว่างการทดสอบแบบหลายครั้ง โดยถือว่าเป็นค่าทศนิยม
AndroidBuildResultReporter	รายงานผลการทดสอบไปยัง Android Build API
AtraceCollector	`IMetricCollector` ที่เรียกใช้ atrace ระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกลงในการเรียกใช้
AtraceRunMetricCollector	รวบรวมการติดตามจากไดเรกทอรีการทดสอบทั้งหมดภายใต้ไดเรกทอรีที่ระบุ จากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีการทดสอบ และประมวลผลภายหลังไฟล์การติดตาม ภายใต้ไดเรกทอรีการทดสอบ และรวบรวมเมตริก
AveragePostProcessor	การใช้งานโปรแกรมประมวลผลภายหลังที่คำนวณค่าเฉลี่ยของรายการเมตริก
BaseDeviceMetricCollector	การติดตั้งใช้งานพื้นฐานของ `IMetricCollector` ที่อนุญาตให้เริ่มและหยุดการรวบรวมข้อมูลใน `onTestRunStart(DeviceMetricData)` และ `onTestRunEnd(DeviceMetricData,Map)`
BasePostProcessor	`IPostProcessor` พื้นฐานที่การติดตั้งใช้งานทุกครั้งควรขยาย
BluetoothConnectionLatencyCollector	ตัวรวบรวมจะพุชการกำหนดค่าเมตริกระยะเวลา statsd ที่กำหนดไว้ล่วงหน้าไปยังอุปกรณ์ และรวบรวม ระยะเวลาการเชื่อมต่อบลูทูธสำหรับแต่ละโปรไฟล์
BluetoothConnectionStateCollector	ตัวรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกสถานะการเชื่อมต่อ หมายเลขสำหรับแต่ละโปรไฟล์
BluetoothConnectionSuccessRatePostProcessor	การติดตั้งใช้งาน Postprocessor ซึ่งคำนวณอัตราความสำเร็จสำหรับโปรไฟล์บลูทูธ ใช้ "metric-key-match" เพื่อระบุเมตริกที่มีสถานะการเชื่อมต่อบลูทูธในอาร์เรย์ตัวเลข ตัวอย่าง [0, 1, 2, 3, 0, 1, 2, 3]
BluetoothHciSnoopLogCollector	ตัวรวบรวมเพื่อเปิดใช้การบันทึกการสอดแนม HCI ของบลูทูธใน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง
BugreportzOnFailureCollector	รวบรวม bugreportz เมื่อกรณีทดสอบล้มเหลว
BugreportzOnTestCaseFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบในการเรียกใช้ล้มเหลว
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ Clang ออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
CodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ Java และ เนทีฟออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
CollectingTestListener	`ITestInvocationListener` ที่จะรวบรวมผลการทดสอบทั้งหมด
ConsoleResultReporter	Result reporter เพื่อพิมพ์ผลการทดสอบไปยังคอนโซล
CountTestCasesCollector	นับและรายงานจำนวนกรณีทดสอบสำหรับ `IRemoteTest` ที่กำหนด
CoverageMetadataCollector	`ILogSaverListener` ซึ่งรวบรวมการวัดความครอบคลุมที่บันทึกไว้และสร้าง CoverageMetadataProto เพื่อให้บริการความครอบคลุมของโค้ด Android ประมวลผล
DebugHostLogOnFailureCollector	ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดกรณีทดสอบที่ไม่สำเร็จ
DeviceTraceCollector	ตัวรวบรวมที่จะเริ่มการติดตาม Perfetto เมื่อการทดสอบเริ่มทำงานและบันทึกไฟล์การติดตามเมื่อสิ้นสุด
EventsLoggerListener	Listener ที่บันทึกเหตุการณ์ทั้งหมดที่ได้รับลงในไฟล์
FileProtoResultReporter	Proto reporter ที่ทิ้ง `TestRecord` ลงในไฟล์
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` ที่รอรับคีย์เมตริกที่มาจากอุปกรณ์และดึง คีย์เหล่านั้นเป็นไฟล์จากอุปกรณ์
FilePullerLogCollector	เครื่องบันทึกของไฟล์ที่รายงานโดยฝั่งอุปกรณ์
FormattedGeneratorReporter	เครื่องมือรายงานที่ช่วยสร้างรายงานในรูปแบบที่เฉพาะเจาะจง
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ gcov ออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของเคอร์เนล gcov ออกจาก debugfs และออกจากอุปกรณ์ แล้วบันทึกเป็นอาร์ติแฟกต์การทดสอบในที่สุด
GeminiDebuggingPostProcessor	โปรแกรมประมวลผลภายหลังสร้างคำค้นหาพรอมต์เพื่อแก้ไขข้อบกพร่อง
GranularRetriableTestWrapper.StartEndCollector	ตัวช่วยในชั้นเรียนเพื่อตรวจหาการเริ่มต้นและสิ้นสุดการวิ่งที่ขาดหายไป
HostStatsdMetricCollector	`IMetricCollector` ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คำสั่งยูทิลิตี statsd
IMetricCollector	เราจะเพิ่มอินเทอร์เฟซนี้เป็น Decorator เมื่อรายงานผลการทดสอบเพื่อรวบรวม เมตริกที่ตรงกัน
IPostProcessor	Post processors เป็นออบเจ็กต์ของ 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 แต่สำหรับโมดูล
ModulePerfettoCollector	ตัวรวบรวมที่จะเริ่มการติดตาม Perfetto เมื่อโมดูลการทดสอบเริ่มต้นและสิ้นสุด รวมถึงเมื่ออุปกรณ์รีบูต
ModuleProtoResultReporter	เครื่องมือรายงานผลลัพธ์มีไว้เพื่อรายงานผลลัพธ์ระดับโมดูลเท่านั้น
ModuleResultsAndMetricsForwarder	ส่วนขยายของ `ResultAndLogForwarder` ที่เพิ่มเมตริกโมดูลเพิ่มเติมที่เกี่ยวข้องกับผลการทดสอบ
PerfettoFilePullerCollector	เครื่องมือรวบรวมที่ดึงไฟล์การติดตามของ Perfetto จากอุปกรณ์ บีบอัดไฟล์ (ไม่บังคับ) และ เพิ่มไฟล์ลงในบันทึกการทดสอบ
PerfettoGenericPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลไฟล์ข้อความ/ไบนารีเมตริก perfetto proto เป็นคู่คีย์-ค่าโดย ขยายข้อความและช่อง proto แบบเรียกซ้ำด้วยค่าสตริงจนกว่าจะพบช่องที่มี ค่าตัวเลข
PerfettoPullerMetricCollector	เลิกใช้คลาสนี้แล้ว โปรดใช้ `PerfettoFilePullerCollector` และ `ERROR(/PerfettoTracePostProcessor)` แทน
PerfettoTracePostProcessor	โปรแกรมประมวลผลภายหลังที่ดึงไฟล์การติดตามของ Perfetto จากบันทึกการทดสอบและเรียกใช้โปรแกรมประมวลผลการติดตาม ในไฟล์เหล่านั้นเพื่อสร้าง Proto ของเมตริก Perfetto
ProtoResultReporter	Result reporter build a `TestRecord` protobuf with all the results inside.
RebootReasonCollector	ตัวรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน
RemoteTestTimeOutEnforcer	Listener ที่อนุญาตให้ตรวจสอบเวลาในการดำเนินการของการกำหนดค่าการทดสอบที่ระบุและทำให้การทดสอบล้มเหลวหากใช้เวลานานกว่าการหมดเวลาที่ระบุ
ReportPassedTests	รายงานในไฟล์ตัวกรองที่เป็นไปได้เพื่อยกเว้นการทดสอบที่ผ่าน
ResultAggregator	ผู้ส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจำเป็น โดยอิงตามกลยุทธ์การลองใหม่ที่ ใช้
ResultAndLogForwarder	ตัวส่งต่อสำหรับผลลัพธ์และเหตุการณ์ในบันทึก
ResultDBReporter	เครื่องมือรายงานผลลัพธ์ที่อัปโหลดผลการทดสอบไปยัง ResultDB
ResultReporter
RetryLogSaverResultForwarder	ตัวส่งต่อที่จัดการการส่งต่อความพยายามปัจจุบันที่เรากำลังดำเนินการอยู่ด้วย
RuntimeRestartCollector	ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี
ScreenRecordOnFailureCollector	ตัวรวบรวมที่จะจับภาพและบันทึกวิดีโอหน้าจอเมื่อกรณีทดสอบล้มเหลว
ScreenshotOnFailureCollector	ตัวรวบรวมที่จะจับภาพหน้าจอและบันทึกเมื่อกรอบการทดสอบล้มเหลว
ShardListener	`ITestInvocationListener` ที่รวบรวมผลลัพธ์จากชาร์ดการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้ในหลายๆ ทรัพยากรแบบขนาน) และส่งต่อผลลัพธ์ไปยัง Listener อื่น
ShardMainResultForwarder	`ResultForwarder` ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบที่แยกส่วน
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์ดังกล่าว
SimpleperfProfilePostProcessor	โปรแกรมประมวลผลภายหลังที่ค้นหาข้อมูลการทำโปรไฟล์ simpleperf และสร้างโปรไฟล์ pprof
StatsdBeforeAfterGaugeMetricPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลเมตริกเกจที่รวบรวมในแนวทาง "ก่อน/หลัง" เช่น
StatsdEventMetricPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลเมตริกเหตุการณ์ในรายงาน statsd เป็นคู่คีย์-ค่า โดยใช้ รูปแบบที่ระบุไว้ในโปรแกรมประมวลผล
StatsdGenericPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลรายงาน StatsD ของ Proto แบบไบนารีเป็นคู่คีย์-ค่าโดยการขยายรายงาน เป็นโครงสร้างแบบต้นไม้
StreamProtoResultReporter	การใช้งาน `ProtoResultReporter`
SubprocessResultsReporter	ใช้ `ITestInvocationListener` เพื่อระบุเป็น result_reporter และส่งต่อจาก กระบวนการย่อยผลการทดสอบ การทดสอบที่รัน และการเรียกใช้การทดสอบ
SuiteResultReporter	รวบรวมผลการทดสอบสำหรับการเรียกใช้ชุดการทดสอบทั้งหมดและแสดงผลลัพธ์สุดท้าย
TextResultReporter	เครื่องมือรายงานผลการทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit
TraceCmdCollector	`IMetricCollector` ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกลงใน การเรียกใช้
XmlFormattedGeneratorReporter	การติดตั้งใช้งาน `FormattedGeneratorReporter` ซึ่งจัดรูปแบบผลลัพธ์ของชุดทดสอบในรูปแบบ XML
XmlResultReporter	เขียนผลลัพธ์ JUnit ลงในไฟล์ XML ในรูปแบบที่สอดคล้องกับ XMLJUnitResultFormatter ของ Ant

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

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

คลาสที่ใช้การเชื่อมต่อนี้ควรทราบว่าระบบจะเรียกใช้ testLogSaved(String,LogDataType,InputStreamSource,LogFile) ทุกครั้งที่เรียกใช้ ITestInvocationListener.testLog(String,LogDataType,InputStreamSource)

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

สรุป

เมธอดสาธารณะ
`default void`	`logAssociation(String dataName, LogFile logFile)` ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างใกล้ชิด แต่ไม่สามารถดำเนินการดังกล่าวใน`testLogSaved(String,LogDataType,InputStreamSource,LogFile)` การเรียกกลับโดยตรงได้
`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,LogDataType,InputStreamSource,LogFile) การเรียกกลับโดยตรงได้ ดังนั้น Callback นี้จึงช่วยให้เชื่อมโยงได้อย่างชัดเจน

พารามิเตอร์
`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` ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้