ผู้รายงานผลลัพธ์ย่อย

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

ใช้ ITestInvocationListener เพื่อระบุเป็น results_reporter และส่งต่อผลลัพธ์ของการทดสอบ การเรียกใช้การทดสอบ การเรียกใช้การทดสอบ จากการประมวลผลย่อย

สรุป

ช่างก่อสร้างสาธารณะ

SubprocessResultsReporter()

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

void close()

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

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 printEvent(String key, Object event)

ผู้ช่วยในการพิมพ์คีย์เหตุการณ์แล้วตามด้วยออบเจ็กต์ JSON

void setOutputTestLog(boolean outputTestLog)

ตั้งค่าว่าควรแสดงผลลัพธ์การทดสอบที่บันทึกไว้หรือไม่

boolean supportGranularResults()

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

void testAssumptionFailure(TestDescription testId, String trace)

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

void testAssumptionFailure(TestDescription testId, FailureDescription failure)

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

void testEnded(TestDescription testId, long endTime, metrics)

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

void testEnded(TestDescription testId, metrics)

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

void testFailed(TestDescription testId, FailureDescription failure)

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

void testFailed(TestDescription testId, String reason)

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

void testIgnored(TestDescription testId)

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

void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

ให้ข้อมูลบันทึกหรือข้อมูลการแก้ไขข้อบกพร่องที่เกี่ยวข้องจากการเรียกใช้ทดสอบ

void testModuleEnded()

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

void testModuleStarted(IInvocationContext moduleContext)

รายงานการเริ่มต้นการทํางานของโมดูล

void testRunEnded(long time, runMetrics)

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

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String reason)

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

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 arg0)

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

void testSkipped(TestDescription testId, SkipReason reason)

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

void testStarted(TestDescription testId, long startTime)

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

void testStarted(TestDescription testId)

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

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

SubprocessResultsReporter

public SubprocessResultsReporter ()

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

ปิด

public void close ()

getสรุป

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

การเรียกใช้ล้มเหลว

public void invocationFailed (FailureDescription failure)

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

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

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

invocationFailed

public void invocationFailed (Throwable cause)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

การเชื่อมโยงบันทึก

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

printEvent

public void printEvent (String key, 
                Object event)

ตัวช่วยในการพิมพ์คีย์เหตุการณ์ตามด้วยออบเจ็กต์ JSON

พารามิเตอร์
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

ตั้งค่าว่าควรแสดงผลลัพธ์การทดสอบที่บันทึกไว้หรือไม่

พารามิเตอร์
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

testEnded

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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

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

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

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

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

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

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

testFailed

public void testFailed (TestDescription testId, 
                String reason)

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

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

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

ละเว้นการทดสอบแล้ว

public void testIgnored (TestDescription testId)

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

พารามิเตอร์
testId 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 อาจซ้ำกันต่อการเรียกใช้ กล่าวคือ ผู้ติดตั้งใช้งานต้องจัดการการเรียกหลายครั้งด้วย 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 time, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String reason)

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

พารามิเตอร์
reason 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 arg0)

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

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription testId, 
                SkipReason reason)

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

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

testStarted

public void testStarted (TestDescription testId, 
                long startTime)

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

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

testStarted

public void testStarted (TestDescription testId)

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

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