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

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) โดยตรง Callback ไม่ได้

void printEvent(String key, Object event)

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

void setOutputTestLog(boolean outputTestLog)

ตั้งค่าว่าเราควรส่งออกการทดสอบที่บันทึกไว้หรือไม่

boolean supportGranularResults()

แสดงค่า "จริง" หากผู้รายงานรองรับผลการค้นหาแบบละเอียด หรือเป็นเท็จ

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)

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

void testFailed(TestDescription testId, FailureDescription failure)

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

void testFailed(TestDescription testId, String reason)

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

void testIgnored(TestDescription testId)

เรียกใช้เมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีการทดสอบมีคำอธิบายประกอบด้วย 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)

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

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

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

public SubprocessResultsReporter ()

วิธีการสาธารณะ

ปิด

public void close ()

getสรุป

public TestSummary getSummary ()

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

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

สิ้นสุดการเรียกใช้

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

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

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

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
failure FailureDescription: FailureDescription ที่อธิบายสาเหตุของความล้มเหลว

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

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
cause Throwable: สาเหตุ Throwable ของความล้มเหลว

เริ่มคำขอแล้ว

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) โดยตรง Callback ไม่ได้ ดังนั้น Callback นี้จึงช่วยให้เกิดการเชื่อมโยงที่แข็งแกร่ง อย่างชัดเจน

พารามิเตอร์
dataName String: ชื่อของข้อมูล
logFile LogFile: LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับ กรอบการทดสอบ

เหตุการณ์การพิมพ์

public void printEvent (String key, 
                Object event)

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

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

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

ตั้งค่าว่าเราควรส่งออกการทดสอบที่บันทึกไว้หรือไม่

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

supportGranularResults

public boolean supportGranularResults ()

แสดงค่า "จริง" หากผู้รายงานรองรับผลการค้นหาแบบละเอียด หรือเป็นเท็จ

คิกรีเทิร์น
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 ที่อธิบายความล้มเหลวและบริบท

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

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

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

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

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

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

จะมีการเรียกระหว่าง testStarted และ testEnded

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

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

public void testFailed (TestDescription testId, 
                String reason)

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

จะมีการเรียกระหว่าง testStarted และ testEnded

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

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

public void testIgnored (TestDescription testId)

เรียกใช้เมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีการทดสอบมีคำอธิบายประกอบด้วย org.junit. ignore

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

บันทึกการทดสอบ

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

โมดูลทดสอบสิ้นสุดแล้ว

public void testModuleEnded ()

รายงานเมื่อสิ้นสุดการเรียกใช้โมดูล

testModuleStarted แล้ว

public void testModuleStarted (IInvocationContext moduleContext)

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

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

สิ้นสุดการทดสอบแล้ว

public void testRunEnded (long time, 
                 runMetrics)

สิ้นสุดการทดสอบรายงาน แก้ไข: เราไม่สามารถมีแผนที่ 2 แบบ<> ที่มีอินเทอร์เฟซหลายประเภท ดังนั้น เราต้องใช้ HashMap ตรงนี้

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String reason)

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

พารามิเตอร์
reason String: String อธิบายสาเหตุที่ทำให้เรียกใช้ล้มเหลว

เริ่มการทดสอบแล้ว

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

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

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

เริ่มการทดสอบแล้ว

public void testRunStarted (String runName, 
                int testCount)

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

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

เริ่มการทดสอบแล้ว

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

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

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

หยุดการทดสอบแล้ว

public void testRunStopped (long arg0)

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

สิ่งที่ต้องทำ: ยังไม่ได้ใช้ในขณะนี้ ลองพิจารณาลบ

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

ข้ามการทดสอบแล้ว

public void testSkipped (TestDescription testId, 
                SkipReason reason)

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

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

เริ่มทดสอบแล้ว

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

เริ่มทดสอบแล้ว

public void testStarted (TestDescription testId)

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

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