TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.testtype.suite.TestFailureListener


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

סיכום

קונסטרוקטורים גלויים לכולם

TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)

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

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