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

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

TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

java.lang.Object
↳	com.android.tradefed.result.TestResultListener

คลาสย่อยโดยตรงที่ทราบ

ConsoleResultReporter, CountingTestResultListener, PassingTestFileReporter

ConsoleResultReporter	เครื่องมือรายงานผลลัพธ์เพื่อพิมพ์ผลการทดสอบไปยังคอนโซล
CountingTestResultListener	`TestResultListener` ที่ติดตามจํานวนการทดสอบทั้งหมดตาม `TestStatus`
PassingTestFileReporter	`ITestInvocationListener` ที่บันทึกรายการเฟรมทดสอบที่ผ่านไปยังไฟล์ทดสอบ

การลดความซับซ้อนของ ITestLifecycleListener สําหรับผู้ใช้งานที่สนใจเฉพาะผลการทดสอบแต่ละรายการ

โดยจะกรองเหตุการณ์ต่างๆ ในวงจรชีวิตให้เหลือเพียงเมธอด testResult

การดำเนินการนี้ไม่ปลอดภัยสำหรับเธรด และโดยเฉพาะอย่างยิ่งจะถือว่าได้รับเหตุการณ์ ITestLifecycleListener ตามลำดับ

สรุป

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

เมธอดสาธารณะ
`final void`	`testAssumptionFailure(TestDescription test, String trace)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ
`final void`	`testEnded(TestDescription test, testMetrics)` รายงานการสิ้นสุดการดําเนินการของเคสทดสอบแต่ละรายการ
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` ทางเลือกสำหรับ `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง
`final void`	`testFailed(TestDescription test, String trace)` รายงานการทดสอบแต่ละรายการที่ล้มเหลว
`final void`	`testIgnored(TestDescription test)` เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ org.junit.Ignore
`abstract void`	`testResult(TestDescription test, TestResult result)`
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` รายงานการสิ้นสุดการทดสอบ
`void`	`testSkipped(TestDescription test, SkipReason reason)` เรียกใช้เมื่อมีการข้ามการทดสอบและไม่ทํางานด้วยเหตุผลที่ปกติแล้วไม่คาดคิด
`final void`	`testStarted(TestDescription test, long startTime)` ทางเลือกสำหรับ `testStarted(com.android.tradefed.result.TestDescription)` ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` เพื่อการวัดผลที่แม่นยำ
`final void`	`testStarted(TestDescription test)` รายงานการเริ่มต้นของ Test Case แต่ละรายการ

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

TestResultListener

public TestResultListener ()

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testEnded

public final 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)` ของเมตริกที่ส่งออก

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

testIgnored

public final void testIgnored (TestDescription test)

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

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

testResult

public abstract void testResult (TestDescription test, 
                TestResult result)

พารามิเตอร์
`test`	`TestDescription`
`result`	`TestResult`

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final 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 final void testStarted (TestDescription test)

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

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