TestFailureListener
public
class
TestFailureListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.TestFailureListener |
מאזין שמשמש לביצוע פעולות כמו צילום מסך, דוח באגים, איסוף logcat במקרה של כשל בבדיקה, לפי דרישה.
סיכום
קונסטרוקטורים גלויים לכולם | |
---|---|
TestFailureListener(
|
שיטות ציבוריות | |
---|---|
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)
מעבירים את היומן ליומן, לא עושים זאת מתוך פונקציית ה-callback של #testLog, כי אם TestFailureListener הוא חלק מהשרשרת, זה יוביל ללולאה אינסופית. |
קונסטרוקטורים גלויים לכולם
TestFailureListener
public TestFailureListener (devices, boolean bugReportOnFailure, boolean rebootOnFailure)
פרמטרים | |
---|---|
devices |
|
bugReportOnFailure |
boolean |
rebootOnFailure |
boolean |
שיטות ציבוריות
applyModuleConfiguration
public void applyModuleConfiguration (boolean bugreportOnFailure)
מאפשרת לשנות את הגדרות ההפעלה של 'תיעוד בזמן כשל' באמצעות ההגדרות הספציפיות למודולים.
פרמטרים | |
---|---|
bugreportOnFailure |
boolean : true כדי לתעד דוח באגים במקרה של כשל בבדיקה. אחרת, הערך יהיה false. |
הצטרף
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 לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה |
dataType |
LogDataType : ה-LogDataType של הנתונים |
dataStream |
InputStreamSource : ה-InputStreamSource של הנתונים. מי שמטמיע את הקוד צריך להפעיל את createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום. מבצעי הקריאה צריכים לוודא שמקור הנתונים יישאר נוכח וזמין עד להשלמת השיטה testLog. |
testLogForward
public void testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream)
מעבירים את היומן ליומן, לא עושים זאת מתוך פונקציית ה-callback של #testLog, כי אם TestFailureListener הוא חלק מהשרשרת, זה יוביל ללולאה אינסופית.
פרמטרים | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |