ตั้งแต่วันที่ 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 และอื่นๆ อีก 83 รายการ

AggregatePostProcessor	ตัวรวบรวมเมตริกที่ให้ค่าต่ำสุด สูงสุด ค่าเฉลี่ย ความแปรปรวน ค่าเบี่ยงเบนมาตรฐาน ผลรวม จำนวน และ เปอร์เซ็นไทล์ (ไม่บังคับ) สำหรับเมตริกตัวเลขที่รวบรวมระหว่างการทดสอบแบบหลายครั้ง โดยถือว่าเป็นค่าทศนิยม
AtraceCollector	`IMetricCollector` ที่เรียกใช้ atrace ระหว่างการทดสอบ และรวบรวมผลลัพธ์และบันทึก ไปยังการเรียกใช้
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	การติดตั้งใช้งาน Postprocessor ซึ่งคำนวณอัตราความสำเร็จสำหรับโปรไฟล์บลูทูธ ใช้ "metric-key-match" เพื่อระบุเมตริกที่มีสถานะการเชื่อมต่อบลูทูธในอาร์เรย์ตัวเลข ตัวอย่าง [0, 1, 2, 3, 0, 1, 2, 3]
BluetoothHciSnoopLogCollector	Collector เพื่อเปิดใช้การบันทึกการสอดแนม HCI ของบลูทูธใน DUT และเพื่อรวบรวมบันทึกสำหรับการทดสอบแต่ละครั้ง
BugreportCollector	`ITestInvocationListener` แบบส่งต่อที่รวบรวมรายงานข้อบกพร่องเมื่อเกิดเหตุการณ์ที่กำหนดค่าได้ แล้วเรียกใช้ `ITestInvocationListener.testLog` ในองค์กรย่อยหลังจากรวบรวมรายงานข้อบกพร่องแต่ละรายการ
BugreportzOnFailureCollector	รวบรวม bugreportz เมื่อกรณีทดสอบล้มเหลว
BugreportzOnTestCaseFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบในการเรียกใช้ล้มเหลว
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ Clang ออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
CodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ Java และ เนทีฟออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
CollectingTestListener	`ITestInvocationListener` ที่จะรวบรวมผลการทดสอบทั้งหมด
CommandStatusHandler	ตัวแฮนเดิลที่ช่วยตรวจสอบและอัปเดตสถานะของการเรียกใช้
ConditionFailureMonitor	ตรวจสอบความล้มเหลวจากการเรียกใช้
ConsoleResultReporter	Result reporter เพื่อพิมพ์ผลการทดสอบไปยังคอนโซล
CountTestCasesCollector	นับและรายงานจำนวนกรณีทดสอบสำหรับ `IRemoteTest` ที่กำหนด
DebugHostLogOnFailureCollector	ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในกรณีทดสอบ
DeviceReleaseReporter	โปรแกรมรายงานการปล่อยอุปกรณ์ที่จัดการการสื่อสารกับกระบวนการหลักของอุปกรณ์ที่จะปล่อย
DeviceTraceCollector	ตัวรวบรวมที่จะเริ่มการติดตาม Perfetto เมื่อการทดสอบเริ่มทำงานและบันทึกไฟล์การติดตามเมื่อสิ้นสุด
DeviceUnavailableMonitor	เครื่องมือตรวจสอบนี้พยายามจับภาพ DNAE ระดับกรณีทดสอบเท่านั้น
EventsLoggerListener	Listener ที่บันทึกเหตุการณ์ทั้งหมดที่ได้รับลงในไฟล์
FileProtoResultReporter	Proto reporter ที่ทิ้ง `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`s ฟังเมื่อมีการบันทึกไฟล์บันทึก
IMetricCollector	เราจะเพิ่มอินเทอร์เฟซนี้เป็นตัวตกแต่งเมื่อรายงานผลการทดสอบเพื่อรวบรวม เมตริกที่ตรงกัน
IPostProcessor	Post processors เป็นออบเจ็กต์ Trade Federation ที่มีไว้เพื่อให้ประมวลผลเมตริกและบันทึกได้ หลังจากทดสอบและก่อนการรายงานผลลัพธ์
IShardableListener	`ITestInvocationListener`ที่สามารถแยกส่วนได้
ISupportGranularResults	อินเทอร์เฟซที่ระบุว่า `ITestInvocationListener` รองรับการรับผลลัพธ์แบบละเอียดหรือไม่
ITestInvocationListener	Listener สำหรับผลการทดสอบจากการเรียกใช้การทดสอบ
ITestSummaryListener	อินเทอร์เฟซที่ช่วยให้ `ITestInvocationListener` แลกเปลี่ยนข้อมูลที่จำกัดบางอย่างผ่านสรุปได้
InvocationProtoResultReporter	ผู้รายงานจะจัดเก็บข้อมูลการแคชระดับการเรียกใช้และรายการโมดูล
InvocationToJUnitResultForwarder	คลาสที่รับฟัง`ITestInvocationListener`เหตุการณ์และส่งต่อเหตุการณ์ไปยัง `TestListener`
JarHostTest.HostTestListener	Wrapper Listener ที่ส่งต่อเหตุการณ์ทั้งหมด ยกเว้น testRunStarted() และ testRunEnded() ไปยัง Listener ที่ฝัง
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดความครอบคลุมของ Java ออกจากอุปกรณ์และบันทึกเป็นอาร์ติแฟกต์การทดสอบ
JsonHttpTestResultReporter	เครื่องมือรายงานผลลัพธ์ที่เข้ารหัสผลลัพธ์ของเมตริกการทดสอบและสาขา ข้อมูลอุปกรณ์เป็น JSON และ POST ไปยังปลายทางบริการ HTTP
LUCIResultReporter	เครื่องมือรายงานผลลัพธ์ที่บันทึกผลการทดสอบที่ ResultDB และ LUCI ต้องการ ในรูปแบบ JSON (go/result-sink) และบันทึกตำแหน่งไฟล์ในคอนโซล
LastShardDetector	เมื่อเรียกใช้การแบ่งข้อมูลในเครื่อง บางครั้งเราอาจต้องการดำเนินการบางอย่างเฉพาะเมื่อ Shard สุดท้าย ไปถึง `invocationEnded(long)`
LegacySubprocessResultsReporter	การติดตั้งใช้งานที่หยุดการอัปเดตของเครื่องมือรายงานผลลัพธ์ของกระบวนการย่อย ซึ่งควรยังคงใช้งานร่วมกับ TF/CTS เวอร์ชันก่อนหน้า (เช่น 8 ขึ้นไป) ได้ แม้ว่าจะมีการเปลี่ยนแปลงในคลาสหลักก็ตาม
LogSaverResultForwarder	`ResultForwarder` สำหรับการบันทึกบันทึกด้วยโปรแกรมบันทึกไฟล์ส่วนกลาง
LogcatCrashResultForwarder	Special listener: on failures (instrumentation process crashing) it will attempt to extract from the logcat the crash and adds it to the failure message associated with the test.
LogcatOnFailureCollector	ตัวรวบรวมที่จะบันทึกและบันทึก Logcat เมื่อกรณีทดสอบล้มเหลว
LogcatTimingMetricCollector	เครื่องมือรวบรวมเมตริกที่รวบรวมข้อมูลเวลา (เช่น เวลาเปลี่ยนผู้ใช้) จาก Logcat ระหว่างการทดสอบที่ทำซ้ำ 1 ครั้งขึ้นไปโดยใช้รูปแบบนิพจน์ทั่วไปที่กำหนดเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด Logcat
MetricFilePostProcessor	ใช้สําหรับอัปโหลดไฟล์บันทึกเมตริกที่รวบรวมระหว่างการทดสอบและระดับการเรียกใช้
MetricsXMLResultReporter	MetricsXMLResultReporter จะเขียนเมตริกการทดสอบและเมตริกการเรียกใช้ลงในไฟล์ XML ในโฟลเดอร์ที่ระบุโดยพารามิเตอร์ metrics-folder ในระยะ invocationEnded ของการทดสอบ
ModuleListener	Listener ที่แนบมากับ `IRemoteTest` ของแต่ละโมดูลเพื่อรวบรวมรายการผลลัพธ์
ModuleLogcatCollector	เวอร์ชันของเครื่องมือรวบรวม Logcat แต่สำหรับโมดูล
ModuleProtoResultReporter	เครื่องมือรายงานผลลัพธ์มีไว้เพื่อรายงานผลลัพธ์ระดับโมดูลเท่านั้น
ModuleResultsAndMetricsForwarder	ส่วนขยายของ `ResultAndLogForwarder` ที่เพิ่มเมตริกโมดูลเพิ่มเติมที่เกี่ยวข้องกับผลการทดสอบ
NameMangleListener	เครื่องมือตรวจสอบพร็อกซีเพื่อแปลชื่อเมธอดทดสอบ คลาส และแพ็กเกจเมื่อมีการรายงานผลลัพธ์
PassingTestFileReporter	`ITestInvocationListener` ที่บันทึกรายการกรณีทดสอบที่ผ่านไปยังไฟล์ทดสอบ
PerfettoFilePullerCollector	เครื่องมือรวบรวมที่ดึงไฟล์การติดตามของ Perfetto จากอุปกรณ์ บีบอัดไฟล์ (ไม่บังคับ) และ เพิ่มไฟล์ลงในบันทึกการทดสอบ
PerfettoGenericPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลไฟล์ Proto ของ Perfetto เมตริกข้อความ/ไบนารีเป็นคู่คีย์-ค่าโดย ขยายข้อความและช่อง Proto แบบเรียกซ้ำด้วยค่าสตริงจนกว่าจะพบช่องที่มี ค่าตัวเลข
PerfettoPullerMetricCollector	คลาสนี้เลิกใช้งานแล้ว โปรดใช้ `PerfettoFilePullerCollector` และ `ERROR(/PerfettoTracePostProcessor)` แทน
PerfettoTracePostProcessor	โปรแกรมประมวลผลภายหลังซึ่งดึงไฟล์การติดตามของ Perfetto จากบันทึกการทดสอบและเรียกใช้โปรแกรมประมวลผลการติดตาม ในไฟล์เหล่านั้นเพื่อสร้าง Proto ของเมตริก Perfetto
PrettyTestEventLogger	เครื่องบันทึกที่ตรงกับเหตุการณ์และบันทึกเหตุการณ์ตามลำดับเพื่อให้แก้ไขข้อบกพร่องได้ง่ายขึ้น
ProtoResultReporter	Result reporter build a `TestRecord` protobuf with all the results inside.
PtsBotTest	เรียกใช้การทดสอบ PTS-bot
PythonBinaryHostTest.PythonForwarder	Result forwarder to replace the run name by the binary name.
RebootReasonCollector	ตัวรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน
RemoteTestTimeOutEnforcer	Listener ที่อนุญาตให้ตรวจสอบเวลาในการดำเนินการของการกำหนดค่าการทดสอบที่ระบุและทำให้การทดสอบล้มเหลวหากใช้เวลานานกว่าการหมดเวลาที่ระบุ
ReportPassedTests	รายงานในไฟล์ตัวกรองที่เป็นไปได้เพื่อยกเว้นการทดสอบที่ผ่าน
ResultAggregator	Special forwarder ที่รวบรวมผลลัพธ์เมื่อจำเป็น โดยอิงตามกลยุทธ์การลองใหม่ที่ ใช้
ResultAndLogForwarder	ตัวส่งต่อสำหรับผลลัพธ์และเหตุการณ์ในบันทึก
ResultDBReporter	เครื่องมือรายงานผลลัพธ์ที่อัปโหลดผลการทดสอบไปยัง ResultDB
ResultForwarder	`ITestInvocationListener` ที่ส่งต่อผลการเรียกใช้ไปยังรายการผู้ฟังอื่นๆ
ResultReporter
RetryLogSaverResultForwarder	Forwarder ที่จัดการการส่งต่อความพยายามปัจจุบันที่เรากำลังดำเนินการอยู่ด้วย
RetryResultForwarder	ส่วนขยายของ `ResultForwarder` ที่จะส่งไปยังหมายเลขการพยายามที่ระบุเสมอ
RuntimeRestartCollector	ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี
ScreenshotOnFailureCollector	ตัวรวบรวมที่จะจับภาพหน้าจอและบันทึกเมื่อกรณีทดสอบล้มเหลว
ShardListener	`ITestInvocationListener`ที่รวบรวมผลลัพธ์จากชาร์ดการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้ในหลายทรัพยากรแบบขนาน) และส่งต่อผลลัพธ์ไปยังเครื่องฟังอีกเครื่อง
ShardMainResultForwarder	`ResultForwarder` ที่รวมผลลัพธ์ของการเรียกใช้การทดสอบที่แยกส่วน
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์ดังกล่าว
StatsdBeforeAfterGaugeMetricPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลเมตริกเกจที่รวบรวมในแนวทาง "ก่อน/หลัง" เช่น
StatsdEventMetricPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลเมตริกเหตุการณ์ในรายงาน statsd เป็นคู่คีย์-ค่า โดยใช้รูปแบบที่ระบุไว้ในโปรแกรมประมวลผล
StatsdGenericPostProcessor	โปรแกรมประมวลผลภายหลังที่ประมวลผลรายงาน StatsD แบบไบนารีของ Proto เป็นคู่คีย์-ค่าโดยการขยายรายงาน เป็นโครงสร้างแบบต้นไม้
StreamProtoResultReporter	การใช้งาน `ProtoResultReporter`
SubprocessResultsReporter	ใช้ `ITestInvocationListener` เพื่อระบุเป็น result_reporter และส่งต่อผลการทดสอบ การทดสอบที่รัน และการเรียกใช้การทดสอบจาก กระบวนการย่อย
SuiteResultReporter	รวบรวมผลการทดสอบสำหรับการเรียกใช้ชุดการทดสอบทั้งหมดและแสดงผลลัพธ์สุดท้าย
TestRunResultListener	Listener ที่อนุญาตให้อ่านสถานะการทดสอบครั้งสุดท้าย
TestTimeoutEnforcer	เครื่องมือตรวจสอบที่ช่วยให้คุณตรวจสอบเวลาในการดำเนินการของกรณีทดสอบที่กำหนดและทำให้การทดสอบล้มเหลวหากใช้เวลานานกว่าการหมดเวลาที่กำหนด
TextResultReporter	เครื่องมือรายงานผลการทดสอบที่ส่งต่อผลลัพธ์ไปยังเครื่องพิมพ์ผลลัพธ์ข้อความ JUnit
TraceCmdCollector	`IMetricCollector` ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกลงใน การเรียกใช้
TradefedSandboxRunner.StubScheduledInvocationListener	Stub `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 อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง กล่าวคือ ผู้ใช้ต้องสามารถจัดการ การเรียกหลายครั้งที่มี dataName เดียวกันได้
`dataType`	`LogDataType`: `LogDataType` ของข้อมูล
`dataStream`	`InputStreamSource`: `InputStreamSource` ของข้อมูล ผู้ใช้ควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบว่าได้ปิด InputStream ที่ได้เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบว่าแหล่งที่มาของข้อมูลยังคง อยู่และเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์