ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

รับการแจ้งเตือนเหตุการณ์ระหว่างทำการทดสอบการใช้เครื่องมือ

รูปแบบตาม org.junit.runner.notification.RunListener

ลำดับการเรียกใช้จะเป็นดังนี้

  • testRunStarted
  • testStarted
  • [testFailed]
  • [testAssumptionFailure]
  • [ทดสอบแล้ว]
  • testEnded
  • ....
  • [testRunFailed]
  • testRunEnded

สรุป

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

default void testAssumptionFailure(TestDescription test, String trace)

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

default void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

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

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

default void testEnded(TestDescription test, testMetrics)

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

default void testFailed(TestDescription test, FailureDescription failure)

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

default void testFailed(TestDescription test, String trace)

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

default void testIgnored(TestDescription test)

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

default void testRunEnded(long elapsedTimeMillis, runMetrics)

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

default void testRunFailed(FailureDescription failure)

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

default void testRunFailed(String errorMessage)

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

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

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

default void testRunStarted(String runName, int testCount)

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

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

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

default void testRunStopped(long elapsedTime)

การเรียกใช้การทดสอบรายงานหยุดลงก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

default void testSkipped(TestDescription test, SkipReason reason)

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

default void testStarted(TestDescription test, long startTime)

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

default void testStarted(TestDescription test)

รายงานการเริ่มต้นของ Test Case แต่ละรายการ

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

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) รายการที่ระบบปล่อยออกมา

การทดสอบล้มเหลว

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: ระบุการทดสอบ

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)

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

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