จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.BugreportCollector


ITestInvocationListener แบบพาส-ทรูที่รวบรวมรายงานจุดบกพร่องเมื่อเหตุการณ์ที่กำหนดค่าได้เกิดขึ้น จากนั้นเรียก ITestInvocationListener#testLog ในลูกๆ หลังจากรวบรวมรายงานจุดบกพร่องแต่ละรายการ

พฤติกรรม: (FIXME: จบสิ่งนี้)

  • จับภาพหลังจากแต่ละกรณีหากมีการทดสอบล้มเหลว
  • จับภาพหลังจากแต่ละกรณีทดสอบ
  • จับภาพหลังจากแต่ละกรณีทดสอบล้มเหลว
  • การจับกุม

สรุป

คลาสที่ซ้อนกัน

enum BugreportCollector.Filter

enum BugreportCollector.Freq

enum BugreportCollector.Noun

class BugreportCollector.Predicate

เพรดิเคตฉบับสมบูรณ์ที่อธิบายว่าเมื่อใดควรบันทึกรายงานข้อบกพร่อง

enum BugreportCollector.Relation

interface BugreportCollector.SubPredicate

ทุ่งนา

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

เพรดิเคตที่กำหนดไว้ล่วงหน้าซึ่งจะเริ่มทำงานหลังจากแต่ละกรณีทดสอบล้มเหลว

public static final BugreportCollector.Predicate AT_START

เพรดิเคตที่กำหนดไว้ล่วงหน้าซึ่งจะเริ่มทำงานเมื่อการเรียกใช้ครั้งแรกเริ่มต้น

ผู้สร้างสาธารณะ

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

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

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

บล็อกจนกว่าตัวรวบรวมจะไม่รวบรวมรายงานข้อบกพร่องใดๆ

TestSummary getSummary ()

อนุญาตให้ InvocationListener ส่งคืนสรุป

void invocationEnded (long elapsedTime)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

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

void setAsynchronous (boolean asynchronous)

ตั้งค่าว่าการรวบรวมรายงานจุดบกพร่องควรรวบรวมรายงานจุดบกพร่องในเธรดอื่น ( asynchronous = true ) หรือบล็อกผู้เรียกจนกว่าจะมีการบันทึกรายงานข้อผิดพลาด ( asynchronous = false )

void setDescriptiveName (String name)

ตั้งชื่อที่สื่อความหมายเพื่อใช้เมื่อบันทึกรายงานข้อบกพร่อง

void setDeviceWaitTime (int waitTime)

ตั้งเวลา (เป็นวินาที) เพื่อรอให้อุปกรณ์ออนไลน์ก่อนที่เราจะพยายามบันทึกรายงานข้อบกพร่อง

void testAssumptionFailure ( TestDescription test, String trace)

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

void testFailed ( TestDescription test, String trace)

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

void testIgnored ( TestDescription test)

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

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

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

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

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

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount)

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

void testRunStopped (long elapsedTime)

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

void testStarted ( TestDescription test)

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

ทุ่งนา

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

เพรดิเคตที่กำหนดไว้ล่วงหน้าซึ่งจะเริ่มทำงานหลังจากแต่ละกรณีทดสอบล้มเหลว

AT_START

public static final BugreportCollector.Predicate AT_START

เพรดิเคตที่กำหนดไว้ล่วงหน้าซึ่งจะเริ่มทำงานเมื่อการเรียกใช้ครั้งแรกเริ่มต้น

ผู้สร้างสาธารณะ

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

พารามิเตอร์
listener ITestInvocationListener

testDevice ITestDevice

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

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

พารามิเตอร์
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

บล็อกจนกว่าตัวรวบรวมจะไม่รวบรวมรายงานข้อบกพร่องใดๆ หากผู้รวบรวมไม่ได้รวบรวมรายงานข้อบกพร่อง ให้ส่งคืนทันที

รับสรุป

public TestSummary getSummary ()

อนุญาตให้ InvocationListener ส่งคืนสรุป

คืนสินค้า
TestSummary TestSummary สรุปการทำงานหรือ null

การร้องขอสิ้นสุด

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation

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

invocationFailed

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation ผู้รายงานจำเป็นต้องแทนที่วิธีนี้เพื่อรองรับการรายงานอุปกรณ์หลายเครื่อง

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

ตั้งค่าอะซิงโครนัส

public void setAsynchronous (boolean asynchronous)

ตั้งค่าว่าการรวบรวมรายงานจุดบกพร่องควรรวบรวมรายงานจุดบกพร่องในเธรดอื่น ( asynchronous = true ) หรือบล็อกผู้เรียกจนกว่าจะมีการบันทึกรายงานข้อผิดพลาด ( asynchronous = false )

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

setDescriptiveName

public void setDescriptiveName (String name)

ตั้งชื่อที่สื่อความหมายเพื่อใช้เมื่อบันทึกรายงานข้อบกพร่อง หาก null BugreportCollector จะถอยกลับไปเป็นการทำงานเริ่มต้นของการจัดลำดับชื่อของเหตุการณ์ที่ทำให้เกิดการรวบรวมรายงานข้อบกพร่อง

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

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

ตั้งเวลา (เป็นวินาที) เพื่อรอให้อุปกรณ์ออนไลน์ก่อนที่เราจะพยายามบันทึกรายงานข้อบกพร่อง หากเป็นลบ จะไม่มีการตรวจสอบ DeviceNotAvailableException ใดๆ ที่พบในระหว่างการตรวจสอบนี้จะถูกบันทึกและละเว้น

พารามิเตอร์
waitTime int

ทดสอบสมมติฐานล้มเหลว

public void testAssumptionFailure (TestDescription test, 
                String trace)

เรียกว่าเมื่อ atomic test flag ถือว่ามีเงื่อนไขที่เป็นเท็จ

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

trace String : สแต็กเทรซของความล้มเหลว

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

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : a ERROR(/Map) ของตัวชี้วัดที่ปล่อยออกมา

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

public void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String : สแต็กเทรซของความล้มเหลว

ทดสอบละเว้น

public void testIgnored (TestDescription test)

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

พารามิเตอร์
test 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 จะเสร็จสมบูรณ์

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย Metric

testRunFailed

public void testRunFailed (String errorMessage)

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

พารามิเตอร์
errorMessage String : String ที่อธิบายสาเหตุของความล้มเหลวในการรัน

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

พารามิเตอร์
runName String : ชื่อการทดสอบรัน

testCount int : จำนวนการทดสอบทั้งหมดในการทดสอบรัน

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

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

public void testStarted (TestDescription test)

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

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