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

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

ResultDBReporter

public class ResultDBReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
↳	com.android.tradefed.result.resultdb.ResultDBReporter

สรุป

ค่าคงที่
`int`	`MAX_PRIMARY_ERROR_MESSAGE_BYTES`
`int`	`MAX_SUMMARY_HTML_BYTES`

ตัวสร้างแบบสาธารณะ
`ResultDBReporter()`

เมธอดสาธารณะ
`TestSummary`	`getSummary()` อนุญาตให้ InvocationListener แสดงผลสรุป
`void`	`invocationEnded(long elapsedTime)` รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือไม่สำเร็จเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationFailed(FailureDescription failure)` รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง
`void`	`invocationFailed(Throwable cause)` รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง
`void`	`invocationSkipped(SkipReason reason)` รายงานการเรียกใช้ว่าข้าม
`void`	`invocationStarted(IInvocationContext context)` รายงานการเริ่มต้นการเรียกใช้การทดสอบ
`void`	`logAssociation(String dataName, LogFile logFile)` ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นหนา แต่โอกาสที่จะทําเช่นนั้นใน `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` callbacks โดยตรงนั้นไม่สามารถทำได้
`void`	`setConfiguration(IConfiguration configuration)` แทรก `IConfiguration` ที่ใช้อยู่
`void`	`setLogSaver(ILogSaver logSaver)` ตั้งค่า `ILogSaver` เพื่ออนุญาตให้ผู้ติดตั้งใช้งานบันทึกไฟล์
`boolean`	`supportGranularResults()` แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False
`void`	`testAssumptionFailure(TestDescription test, String trace)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` ทางเลือกสำหรับ `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง
`void`	`testEnded(TestDescription test, testMetrics)` รายงานการสิ้นสุดการดําเนินการของเคสทดสอบแต่ละรายการ
`void`	`testFailed(TestDescription test, FailureDescription failure)` รายงานการทดสอบแต่ละรายการที่ล้มเหลว
`void`	`testFailed(TestDescription test, String trace)` รายงานการทดสอบแต่ละรายการที่ล้มเหลว
`void`	`testIgnored(TestDescription test)` เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ org.junit.Ignore
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ
`void`	`testModuleEnded()` รายงานการสิ้นสุดการเรียกใช้ข้อบังคับ
`void`	`testModuleStarted(IInvocationContext moduleContext)` รายงานการเริ่มต้นการทํางานของโมดูล
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` รายงานการสิ้นสุดการทดสอบ
`void`	`testRunFailed(FailureDescription failure)` การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย `FailureDescription`
`void`	`testRunFailed(String errorMessage)` การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` รายงานการเริ่มต้นการทดสอบ
`void`	`testRunStarted(String runName, int testCount)` รายงานการเริ่มต้นการทดสอบ
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` รายงานการเริ่มต้นการทดสอบ
`void`	`testRunStopped(long elapsedTime)` การทดสอบรายงานหยุดลงก่อนเสร็จสิ้นตามคําขอของผู้ใช้
`void`	`testSkipped(TestDescription test, SkipReason reason)` เรียกใช้เมื่อมีการข้ามการทดสอบและไม่ทํางานด้วยเหตุผลที่ปกติแล้วไม่คาดคิด
`void`	`testStarted(TestDescription test, long startTime)` ทางเลือกสำหรับ `testStarted(com.android.tradefed.result.TestDescription)` ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` เพื่อการวัดผลที่แม่นยำ
`void`	`testStarted(TestDescription test)` รายงานการเริ่มต้นของ Test Case แต่ละรายการ

ค่าคงที่

MAX_PRIMARY_ERROR_MESSAGE_BYTES

public static final int MAX_PRIMARY_ERROR_MESSAGE_BYTES

ค่าคงที่: 1024 (0x00000400)

MAX_SUMMARY_HTML_BYTES

public static final int MAX_SUMMARY_HTML_BYTES

ค่าคงที่: 4096 (0x00001000)

ตัวสร้างแบบสาธารณะ

ResultDBReporter

public ResultDBReporter ()

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

getSummary

public TestSummary getSummary ()

อนุญาตให้ InvocationListener แสดงผลสรุป

คิกรีเทิร์น
`TestSummary`	`TestSummary` ที่สรุปการเรียกใช้ หรือ Null

invocationEnded

public void invocationEnded (long elapsedTime)

รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือไม่สำเร็จเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
`elapsedTime`	`long`: เวลาผ่านไปของคําเรียกเป็นมิลลิวินาที

invocationFailed

public void invocationFailed (FailureDescription failure)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
`failure`	`FailureDescription`: `FailureDescription` ที่อธิบายสาเหตุของการไม่สําเร็จ

invocationFailed

public void invocationFailed (Throwable cause)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
`cause`	`Throwable`: `Throwable` สาเหตุของการไม่สําเร็จ

invocationSkipped

public void invocationSkipped (SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

พารามิเตอร์
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

รายงานการเริ่มต้นการเรียกใช้การทดสอบ

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ ผู้รายงานต้องลบล้างวิธีนี้เพื่อรองรับการรายงานหลายอุปกรณ์

พารามิเตอร์
`context`	`IInvocationContext`: ข้อมูลเกี่ยวกับการเรียกใช้

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` ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

setConfiguration

public void setConfiguration (IConfiguration configuration)

แทรก IConfiguration ที่ใช้อยู่

พารามิเตอร์
`configuration`	`IConfiguration`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

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

supportGranularResults

public boolean supportGranularResults ()

แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False

คิกรีเทิร์น
`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`trace`	`String`: สแต็กเทรซของข้อผิดพลาด

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`failure`	`FailureDescription`: `FailureDescription` อธิบายความล้มเหลวและบริบท

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ทางเลือกสำหรับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง ใช้ร่วมกับ testStarted(com.android.tradefed.result.TestDescription, long) เพื่อให้การวัดผลแม่นยำ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`endTime`	`long`: เวลาสิ้นสุดการทดสอบที่วัดผ่าน `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` ของเมตริกที่ส่งออก

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

รายงานการสิ้นสุดการดําเนินการของเคสทดสอบแต่ละรายการ

หากไม่มีการเรียกใช้ testFailed(TestDescription, FailureDescription) แสดงว่าทดสอบนี้ผ่าน และยังแสดงเมตริกคีย์/ค่าที่อาจแสดงระหว่างการเรียกใช้ชุดทดสอบด้วย

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`testMetrics`	: `ERROR(/Map)` ของเมตริกที่ส่งออก

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

รายงานการทดสอบแต่ละรายการที่ล้มเหลว

ระบบจะเรียกใช้ระหว่าง testStarted กับ testEnded

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`failure`	`FailureDescription`: `FailureDescription` อธิบายความล้มเหลวและบริบท

testFailed

public void testFailed (TestDescription test, 
                String trace)

รายงานการทดสอบแต่ละรายการที่ล้มเหลว

ระบบจะเรียกใช้ระหว่าง testStarted กับ testEnded

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`trace`	`String`: สแต็กเทรซของข้อผิดพลาด

testIgnored

public void testIgnored (TestDescription test)

เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ org.junit.Ignore

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ

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 จะเสร็จสมบูรณ์

testModuleEnded

public void testModuleEnded ()

รายงานการสิ้นสุดการเรียกใช้ข้อบังคับ

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นการทํางานของโมดูล การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และสามารถเลือกใช้ในลำดับหรือไม่ก็ได้ จะใช้ในระหว่างการเรียกใช้ที่ใช้ข้อบังคับเท่านั้น นั่นคือเครื่องมือรันไทม์ที่อิงตามชุด

พารามิเตอร์
`moduleContext`	`IInvocationContext`: `IInvocationContext` ของโมดูล

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

รายงานการสิ้นสุดการทดสอบ

พารามิเตอร์
`elapsedTimeMillis`	`long`: เวลาที่ผ่านไปที่อุปกรณ์รายงานเป็นมิลลิวินาที
`runMetrics`	: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบ

testRunFailed

public void testRunFailed (FailureDescription failure)

การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

พารามิเตอร์
`failure`	`FailureDescription`: `FailureDescription` อธิบายความล้มเหลวและบริบท

testRunFailed

public void testRunFailed (String errorMessage)

การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง

พารามิเตอร์
`errorMessage`	`String`: `String` อธิบายสาเหตุของการเรียกใช้ที่ไม่สําเร็จ

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

รายงานการเริ่มต้นการทดสอบ

พารามิเตอร์
`runName`	`String`: ชื่อการทดสอบ
`testCount`	`int`: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ
`attemptNumber`	`int`: หมายเลขคำสั่งซื้อ ซึ่งระบุการพยายามต่างๆ ของ runName เดียวกันที่เรียกใช้หลายครั้ง attemptNumber จะเริ่มต้นที่ 0 และควรเพิ่มขึ้นทุกครั้งที่มีการทำงานใหม่ เช่น การทดสอบได้รับการลองใหม่แบบละเอียด 3 ครั้ง ก็ควรมีการทำงานทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะอยู่ระหว่าง 0 ถึง 3

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

รายงานการเริ่มต้นการทดสอบ

พารามิเตอร์
`runName`	`String`: ชื่อการทดสอบ
`testCount`	`int`: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

รายงานการเริ่มต้นการทดสอบ

พารามิเตอร์
`runName`	`String`: ชื่อการทดสอบ
`testCount`	`int`: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ
`attemptNumber`	`int`: หมายเลขคำสั่งซื้อ ซึ่งระบุการพยายามต่างๆ ของ runName เดียวกันที่เรียกใช้หลายครั้ง attemptNumber จะเริ่มต้นที่ 0 และควรเพิ่มขึ้นทุกครั้งที่มีการทำงานใหม่ เช่น การทดสอบได้รับการลองใหม่แบบละเอียด 3 ครั้ง ก็ควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะอยู่ระหว่าง 0 ถึง 3
`startTime`	`long`: เวลาเริ่มต้นการเรียกใช้ ซึ่งวัดผ่าน `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

การทดสอบรายงานหยุดลงก่อนเสร็จสิ้นตามคําขอของผู้ใช้

TODO: currently unused, consider removing

พารามิเตอร์
`elapsedTime`	`long`: เวลาที่ผ่านไปที่อุปกรณ์รายงานเป็นมิลลิวินาที

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

เรียกใช้เมื่อมีการข้ามการทดสอบและไม่ทํางานด้วยเหตุผลที่ปกติแล้วไม่คาดคิด ระบบจะพยายามทดสอบเหล่านี้อีกครั้งเพื่อพยายามเรียกใช้อย่างถูกต้อง

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

ทางเลือกสำหรับ testStarted(com.android.tradefed.result.TestDescription) ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดผลที่แม่นยำ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`startTime`	`long`: เวลาเริ่มต้นการทดสอบซึ่งวัดผ่าน `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

รายงานการเริ่มต้นของ Test Case แต่ละรายการ อินเทอร์เฟซเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription) เมื่อเป็นไปได้

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ