החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

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 הוא חלק מהשרשרת, זה יוביל ללולאה אינסופית.

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

public void applyModuleConfiguration (boolean bugreportOnFailure)

מאפשרת לשנות את הגדרות ההפעלה של 'תיעוד בזמן כשל' באמצעות ההגדרות הספציפיות למודולים.

פרמטרים
`bugreportOnFailure`	`boolean`: true כדי לתעד דוח באגים במקרה של כשל בבדיקה. אחרת, הערך יהיה false.

public void join ()

צריך להצטרף לכל השרשור של צילום הנתונים ב-logcat כדי לוודא שהם מסתיימים.

public void setLogger (ITestLogger logger)

מגדיר את המיקום שבו יומנים יישמרו.

פרמטרים
`logger`	`ITestLogger`

public void testFailed (TestDescription test, 
                String trace)

דיווח על כשל של מקרה בדיקה ספציפי.

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`trace`	`String`: סטאק טריי של הכשל

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

הנתונים המשויכים של היומן או ניפוי הבאגים מהפעלת הבדיקה.

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

פרמטרים
`dataName`	`String`: `String` שם תיאורי של הנתונים. לדוגמה, 'device_logcat'. הערה: שם המשתנה dataName לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה
`dataType`	`LogDataType`: ה-`LogDataType` של הנתונים
`dataStream`	`InputStreamSource`: ה-`InputStreamSource` של הנתונים. מי שמטמיע את הקוד צריך להפעיל את createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום. מבצעי הקריאה צריכים לוודא שמקור הנתונים יישאר נוכח וזמין עד להשלמת השיטה testLog.

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

מעבירים את היומן ליומן, לא עושים זאת מתוך פונקציית ה-callback של #testLog, כי אם TestFailureListener הוא חלק מהשרשרת, זה יוביל ללולאה אינסופית.