אוסף דוחות באגים

public class BugreportCollector
extends Object implements ITestInvocationListener

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

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)
void testFailed(TestDescription test, String trace)

void testIgnored(TestDescription test)
void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

void 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

פרדיקט מוגדר מראש שמופעל כשההפעלה הראשונה מתחילה

בנאים ציבוריים

אוסף דוחות באגים

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

פרמטרים
listener ITestInvocationListener

testDevice ITestDevice

שיטות ציבוריות

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

פרמטרים
p BugreportCollector.Predicate

בלוק עדId

public void blockUntilIdle ()

יש לחסום עד שהאוסף לא יאסוף דוחות על באגים. אם אספן לא פעיל איסוף דוח על באג, חזרה מיד

getSummary

public TestSummary getSummary ()

החזרות
TestSummary

ההפעלה הסתיימה

public void invocationEnded (long elapsedTime)

פרמטרים
elapsedTime long

ההפעלה נכשלה

public void invocationFailed (Throwable cause)

פרמטרים
cause Throwable

ההפעלה התחילה

public void invocationStarted (IInvocationContext context)

פרמטרים
context IInvocationContext

הגדרה אסינכרונית

public void setAsynchronous (boolean asynchronous)

הגדרה אם איסוף דוחות הבאגים יאסוף את הדוח על הבאג בשרשור אחר (asynchronous = true), או לחסום את המתקשר עד שהדוח על הבאג יתועד (asynchronous = false).

פרמטרים
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

צריך להגדיר את השם התיאורי שישמש לתיעוד דוחות על באגים. אם null, BugreportCollector יחזור להתנהגות ברירת המחדל של סידור השם בהמשכים האירוע שגרם לאיסוף של הדוח על הבאג.

פרמטרים
name String

setDevicePendingTime (זמן ההמתנה של המכשיר)

public void setDeviceWaitTime (int waitTime)

יש להגדיר את משך הזמן (בשניות) למצב המתנה עד שהמכשיר יהיה במצב אונליין לפני שננסה לצלם על באג. אם הערך שלילי, לא תתבצע בדיקה. כל DeviceNotAvailableException במהלך הבדיקה הזו יתועדו, והמערכת תתעלם מהם.

פרמטרים
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

פרמטרים
test TestDescription

trace String

הבדיקה הסתיימה

public void testEnded (TestDescription test, 
                 testMetrics)

פרמטרים
test TestDescription

testMetrics

הבדיקה נכשלה

public void testFailed (TestDescription test, 
                String trace)

פרמטרים
test TestDescription

trace String

התעלמות מבדיקה

public void testIgnored (TestDescription test)

פרמטרים
test TestDescription

יומן בדיקה

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

פרמטרים
dataName String

dataType LogDataType

dataStream InputStreamSource

הבדיקה הסתיימה

public void testRunEnded (long elapsedTime, 
                 runMetrics)

פרמטרים
elapsedTime long

runMetrics

הבדיקה נכשלה

public void testRunFailed (String errorMessage)

פרמטרים
errorMessage String

בדיקת ההרצה

public void testRunStarted (String runName, 
                int testCount)

פרמטרים
runName String

testCount int

TestRunSStop

public void testRunStopped (long elapsedTime)

פרמטרים
elapsedTime long

הבדיקה התחילה

public void testStarted (TestDescription test)

פרמטרים
test TestDescription