ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

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

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

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 และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง
BugreportCollector	`ITestInvocationListener` ที่ส่งผ่านซึ่งรวบรวมข้อบกพร่องเมื่อเกิดเหตุการณ์ที่กําหนดค่าได้ จากนั้นเรียก `ITestInvocationListener.testLog` ในรายการย่อยหลังจากรวบรวมข้อบกพร่องแต่ละรายการแล้ว
BugreportzOnFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเฟรมทดสอบไม่ผ่าน
BugreportzOnTestCaseFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเทสเคสในการเรียกใช้ไม่สําเร็จ
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Clang จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java และแบบเนทีฟออกจากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CollectingTestListener	`ITestInvocationListener` ที่จะรวบรวมผลการทดสอบทั้งหมด
CommandStatusHandler	แฮนเดิลที่ช่วยตรวจสอบและอัปเดตสถานะของการเรียกใช้
ConditionFailureMonitor	ตรวจสอบการเรียกใช้ที่ไม่สําเร็จ
ConsoleResultReporter	เครื่องมือรายงานผลลัพธ์เพื่อพิมพ์ผลลัพธ์การทดสอบไปยังคอนโซล
CountTestCasesCollector	นับและรายงานจํานวนกรณีทดสอบสําหรับ `IRemoteTest` ที่ระบุ
DebugHostLogOnFailureCollector	ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในชุดทดสอบ
DeviceReleaseReporter	ผู้รายงานรุ่นอุปกรณ์ที่จัดการการสื่อสารกับกระบวนการหลักของอุปกรณ์ที่จะเผยแพร่
DeviceTraceCollector	เครื่องมือรวบรวมข้อมูลที่จะเริ่มการติดตามด้วย Perfetto เมื่อการทดสอบเริ่มขึ้นและบันทึกไฟล์การติดตามเมื่อสิ้นสุด
DeviceUnavailableMonitor	โปรแกรมฟังนี้จะพยายามบันทึก DNAE ระดับ Test Case เท่านั้น
EventsLoggerListener	โปรแกรมฟังที่บันทึกเหตุการณ์ทั้งหมดที่ได้รับลงในไฟล์
FileProtoResultReporter	เครื่องมือรายงาน Proto ที่ส่งออก `TestRecord` ไปยังไฟล์
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` ที่คอยฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูลเหล่านั้นเป็นไฟล์จากอุปกรณ์
FilePullerLogCollector	โปรแกรมบันทึกไฟล์ที่รายงานโดยอุปกรณ์
FilteredResultForwarder	ตัวแปรของ `ResultForwarder` ที่อนุญาตให้รายงานเฉพาะรายการที่อนุญาตของ `TestDescription`
FormattedGeneratorReporter	เครื่องมือรายงานที่อนุญาตให้สร้างรายงานในรูปแบบที่เฉพาะเจาะจง
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุม gcov จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจาก debugfs และออกจากอุปกรณ์ จากนั้นบันทึกเป็นอาร์ติแฟกต์การทดสอบ
GranularRetriableTestWrapper.StartEndCollector	ตัวช่วยของคลาสเพื่อจับเวลาเริ่มต้นและสิ้นสุดการเรียกใช้ที่ขาดหายไป
HostStatsdMetricCollector	`IMetricCollector` ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คําสั่งยูทิลิตี statsd
ICommandScheduler.IScheduledInvocationListener	Listener สําหรับเหตุการณ์การเรียกใช้เมื่อการเรียกใช้เสร็จสมบูรณ์
ILogSaverListener	อนุญาตให้ `ITestInvocationListener` ฟังเมื่อบันทึกไฟล์บันทึก
IMetricCollector	ระบบจะเพิ่มอินเทอร์เฟซนี้เป็นส่วนตกแต่งเมื่อรายงานผลการทดสอบเพื่อรวบรวมเมตริกที่ตรงกัน
IPostProcessor	โปรแกรมประมวลผลผลลัพธ์เป็นออบเจ็กต์ Trade Federation ที่มีไว้เพื่อประมวลผลเมตริกและบันทึกหลังจากการทดสอบและก่อนการรายงานผลลัพธ์
IShardableListener	`ITestInvocationListener` ที่สามารถแบ่งกลุ่มได้
ISupportGranularResults	อินเทอร์เฟซที่ระบุว่า `ITestInvocationListener` รองรับการรับผลลัพธ์แบบละเอียดหรือไม่
ITestInvocationListener	โปรแกรมรับฟังผลการทดสอบจากการเรียกใช้การทดสอบ
ITestSummaryListener	อินเทอร์เฟซที่ช่วยให้ `ITestInvocationListener` แลกเปลี่ยนข้อมูลบางอย่างแบบจํากัดได้ผ่านสรุป
InvocationProtoResultReporter	ผู้รายงานเพื่อจัดเก็บข้อมูลการแคชระดับการเรียกใช้และรายการโมดูล
InvocationToJUnitResultForwarder	คลาสที่คอยฟังเหตุการณ์ `ITestInvocationListener` และส่งต่อไปยัง `TestListener`
JarHostTest.HostTestListener	Listener ของ Wrapper ที่ส่งต่อเหตุการณ์ทั้งหมดยกเว้น testRunStarted() และ testRunEnded() ไปยัง Listener ที่ฝัง
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
JsonHttpTestResultReporter	ผู้รายงานผลที่เข้ารหัสผลลัพธ์เมตริกการทดสอบและข้อมูลสาขา อุปกรณ์เป็น JSON และ POST ไปยังปลายทางบริการ HTTP
LUCIResultReporter	เครื่องมือรายงานผลลัพธ์ที่บันทึกผลการทดสอบที่ ResultDB และ LUCI ต้องการในรูปแบบ JSON (go/result-sink) และบันทึกตำแหน่งไฟล์ในคอนโซล
LastShardDetector	เมื่อเรียกใช้การแยกข้อมูลระดับท้องถิ่น บางครั้งเราต้องการดําเนินการบางอย่างเมื่อกลุ่มย่อยสุดท้ายมีจำนวนถึง `invocationEnded(long)` เท่านั้น
LegacySubprocessResultsReporter	การติดตั้งใช้งานเครื่องมือรายงานผลของกระบวนการย่อยแบบหยุดทำงานชั่วคราวซึ่งควรจะเข้ากันได้กับ TF/CTS เวอร์ชันเก่า (เช่น 8 ขึ้นไป) แม้ว่าจะมีการเปลี่ยนแปลงในซุปเปอร์คลาสก็ตาม
LogSaverResultForwarder	`ResultForwarder` สําหรับการบันทึกบันทึกด้วยโปรแกรมบันทึกไฟล์ส่วนกลาง
LogcatCrashResultForwarder	โปรแกรมรับฟังพิเศษ: ในกรณีที่เกิดความล้มเหลว (กระบวนการเครื่องมือวัดประสิทธิภาพขัดข้อง) ระบบจะพยายามดึงข้อมูลข้อขัดข้องจาก Logcat และเพิ่มลงในข้อความแสดงข้อผิดพลาดที่เชื่อมโยงกับการทดสอบ
LogcatOnFailureCollector	ตัวรวบรวมที่จะบันทึกและบันทึก Logcat เมื่อเฟรมทดสอบไม่ผ่าน
LogcatTimingMetricCollector	ตัวรวบรวมเมตริกที่รวบรวมข้อมูลการกําหนดเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำ 1 ครั้งหรือหลายครั้งโดยใช้รูปแบบนิพจน์ทั่วไปที่ระบุเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat
MetricFilePostProcessor	ใช้สําหรับการอัปโหลดไฟล์บันทึกเมตริกที่รวบรวมระหว่างการทดสอบและระดับการเรียกใช้
MetricsXMLResultReporter	MetricsXMLResultReporter จะเขียนเมตริกการทดสอบและเมตริกการเรียกใช้ลงในไฟล์ XML ในโฟลเดอร์ที่ระบุโดยพารามิเตอร์ metrics-folder ในระยะ invocationEnded ของการทดสอบ
ModuleListener	Listener ที่แนบมากับ `IRemoteTest` แต่ละรายการของโมดูลแต่ละรายการเพื่อรวบรวมรายการผลลัพธ์
ModuleLogcatCollector	เวอร์ชันของเครื่องมือรวบรวม Logcat สำหรับโมดูล
ModuleProtoResultReporter	ผู้รายงานผลลัพธ์ที่มีไว้เพื่อรายงานเฉพาะผลลัพธ์ระดับโมดูล
NameMangleListener	โปรแกรมรับฟังพร็อกซีเพื่อแปลชื่อเมธอดทดสอบ คลาส และแพ็กเกจเมื่อมีการรายงานผลลัพธ์
PassingTestFileReporter	`ITestInvocationListener` ที่บันทึกรายการเฟรมทดสอบที่ผ่านไปยังไฟล์ทดสอบ
PerfettoGenericPostProcessor	โปรแกรมประมวลผลผลลัพธ์ที่ประมวลผลไฟล์ Proto ของเมตริกข้อความ/ไบนารีเป็นคู่คีย์-ค่าโดยการขยายข้อความและช่อง Proto ที่มีค่าสตริงแบบซ้ำๆ จนกว่าจะพบช่องที่มีค่าตัวเลข
PerfettoPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
PrettyTestEventLogger	โปรแกรมบันทึกที่จับคู่เหตุการณ์และบันทึกเหตุการณ์เพื่อให้แก้ไขข้อบกพร่องได้ง่ายขึ้น
ProtoResultReporter	ผู้รายงานผลจะสร้าง `TestRecord` protobuf ที่มีผลการค้นหาทั้งหมดอยู่ภายใน
PtsBotTest	เรียกใช้การทดสอบ PTS-bot
PythonBinaryHostTest.PythonForwarder	ตัวส่งต่อผลลัพธ์เพื่อแทนที่ชื่อการเรียกใช้ด้วยชื่อไบนารี
RebootReasonCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน
RemoteTestTimeOutEnforcer	รายการฟังที่อนุญาตให้ตรวจสอบเวลาดำเนินการของการกำหนดค่าการทดสอบหนึ่งๆ และดำเนินการไม่สำเร็จหากใช้เวลานานกว่าการหมดเวลาที่กำหนด
ReportPassedTests	รายงานในไฟล์ตัวกรองที่เป็นไปได้เพื่อยกเว้นการทดสอบที่ผ่าน
ResultAggregator	ตัวส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจําเป็น โดยอิงตามกลยุทธ์การลองอีกครั้งที่ใช้
ResultAndLogForwarder	ตัวส่งต่อสําหรับผลลัพธ์และเหตุการณ์ในบันทึก
ResultDBReporter	เครื่องมือรายงานผลลัพธ์ที่อัปโหลดผลการทดสอบไปยัง ResultDB
ResultForwarder	`ITestInvocationListener` ที่ส่งต่อผลลัพธ์การเรียกไปยังรายการ Listener อื่นๆ
RetryLogSaverResultForwarder	ตัวส่งต่อที่จัดการการส่งผ่านความพยายามปัจจุบันของเราด้วย
RetryResultForwarder	ส่วนขยายของ `ResultForwarder` ที่พุชไปยังจำนวนครั้งที่พยายามหนึ่งๆ เสมอ
RuntimeRestartCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการประทับเวลาของการเริ่มทํางานอีกครั้ง (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี
ScreenshotOnFailureCollector	ตัวรวบรวมที่จะจับภาพและบันทึกภาพหน้าจอเมื่อกรอบการทดสอบไม่ผ่าน
ShardListener	`ITestInvocationListener` ที่รวบรวมผลลัพธ์จากกลุ่มการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้หลายรายการพร้อมกันในหลายทรัพยากร) และส่งต่อไปยังโปรแกรมฟังอื่น
ShardMainResultForwarder	`ResultForwarder` ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบที่แบ่งกลุ่ม
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
StatsdBeforeAfterGaugeMetricPostProcessor	โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลเมตริกการวัดที่รวบรวมในแนวทาง "ก่อน/หลัง" เช่น
StatsdEventMetricPostProcessor	โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลเมตริกเหตุการณ์ในรายงาน statsd เป็นคู่คีย์-ค่า โดยใช้รูปแบบที่ระบุไว้ในโปรแกรมประมวลผล
StatsdGenericPostProcessor	โปรแกรมประมวลผลข้อมูลหลังการประมวลผลที่ประมวลผลรายงาน Statsd รูปแบบไบนารีเป็นคู่คีย์-ค่าโดยการขยายรายงานเป็นโครงสร้างต้นไม้
StreamProtoResultReporter	การใช้งาน `ProtoResultReporter`
SubprocessResultsReporter	ใช้ `ITestInvocationListener` เพื่อระบุเป็น result_reporter และส่งต่อผลการทดสอบ การเรียกใช้การทดสอบ และการเรียกใช้การทดสอบจากกระบวนการย่อย
SuiteResultReporter	รวบรวมผลการทดสอบสําหรับการเรียกใช้ชุดทดสอบทั้งหมดและแสดงผลลัพธ์สุดท้าย
TestRunResultListener	โปรแกรมฟังที่อนุญาตให้อ่านสถานะการทดสอบครั้งสุดท้าย
TestTimeoutEnforcer	รายการฟังที่อนุญาตให้ตรวจสอบเวลาดำเนินการของเฟรมทดสอบหนึ่งๆ และทดสอบไม่ผ่านหากใช้เวลานานกว่าการหมดเวลาที่กำหนด
TextResultReporter	ผู้รายงานผลลัพธ์การทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit
TraceCmdCollector	`IMetricCollector` ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกร่องรอยเหล่านั้นลงในการเรียกใช้
TradefedSandboxRunner.StubScheduledInvocationListener	สตับ `IScheduledInvocationListener` ที่ไม่ทําอะไรเลย
XmlFormattedGeneratorReporter	การใช้ `FormattedGeneratorReporter` ซึ่งจัดรูปแบบชุดผลลัพธ์เป็นรูปแบบ XML
XmlResultReporter	เขียนผลลัพธ์ JUnit ลงในไฟล์ XML ในรูปแบบที่สอดคล้องกับ XMLJUnitResultFormatter ของ Ant

เอนทิตีที่บันทึกสตรีมข้อมูลประเภทต่างๆ ได้

สรุป

เมธอดสาธารณะ
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ

ต้องเรียกใช้ก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

เฟรมเวิร์ก TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจะระบุบันทึกของโฮสต์และบันทึก Logcat ของอุปกรณ์ (หากมี)

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