TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.testtype.suite.TestFailureListener

---

Listener ที่ใช้ดำเนินการ เช่น ภาพหน้าจอ รายงานข้อบกพร่อง การเก็บรวบรวม Logcat เมื่อการทดสอบไม่สําเร็จเมื่อมีการขอ

สรุป

ตัวสร้างแบบสาธารณะ
TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)

เมธอดสาธารณะ
void	applyModuleConfiguration(boolean bugreportOnFailure) อนุญาตให้ลบล้างการตั้งค่าการเรียกใช้ของการเก็บบันทึกเมื่อดำเนินการไม่สำเร็จตามการกำหนดค่าเฉพาะโมดูล
void	join() เข้าร่วมในเธรดการบันทึก Logcat ทั้งหมดเพื่อให้แน่ใจว่าเธรดสิ้นสุดการทำงานแล้ว
void	setLogger(ITestLogger logger) กำหนดตำแหน่งที่จะบันทึกบันทึก
void	testFailed(TestDescription test, String trace) รายงานการทดสอบแต่ละรายการที่ล้มเหลว
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) ส่งต่อบันทึกไปยังโปรแกรมบันทึก โปรดอย่าดำเนินการจากภายในการเรียกกลับ #testLog เนื่องจากหาก TestFailureListener เป็นส่วนหนึ่งของเชน การดำเนินการนี้จะทำให้เกิดลูปที่ไม่มีที่สิ้นสุด

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

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

พารามิเตอร์
devices
bugReportOnFailure	boolean
rebootOnFailure	boolean

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

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

อนุญาตให้ลบล้างการตั้งค่าการเรียกใช้ของการเก็บบันทึกเมื่อดำเนินการไม่สำเร็จตามการกำหนดค่าเฉพาะโมดูล

พารามิเตอร์
bugreportOnFailure	boolean: true เพื่อบันทึกรายงานข้อบกพร่องเมื่อการทดสอบล้มเหลว จะเป็นเท็จหากไม่เป็นเช่นนั้น

เข้าร่วม

public void join ()

เข้าร่วมในเธรดการบันทึก Logcat ทั้งหมดเพื่อให้แน่ใจว่าเธรดสิ้นสุดการทำงานแล้ว

setLogger

public void setLogger (ITestLogger logger)

กำหนดตำแหน่งที่จะบันทึกบันทึก

พารามิเตอร์
logger	ITestLogger

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

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

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

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

testLogForward

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

ส่งต่อบันทึกไปยังโปรแกรมบันทึก โปรดอย่าดำเนินการจากภายในการเรียกกลับ #testLog เนื่องจากหาก TestFailureListener เป็นส่วนหนึ่งของเชน การดำเนินการนี้จะทำให้เกิดลูปที่ไม่มีที่สิ้นสุด

พารามิเตอร์
dataName	String
dataType	LogDataType
dataStream	InputStreamSource