XmlResultReporter

public class XmlResultReporter
extends CollectingTestListener implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.result.XmlResultReporter

---

כותבת תוצאות של JUnit לקובצי XML בפורמט שתואם ל- XMLJUnitProductFormatter של Ant.

בשונה מהמעצב של ענת, המחלקה הזו לא מדווחת על זמן הביצוע של בדיקות.

האובייקט אוסף את כל פרטי הבדיקה בזיכרון, ולאחר מכן מעביר אותם לקובץ בסיום ההפעלה.

שותף מ-Dalvik Runner XmlReportPrinter.

קובצי התוצאות יאוחסנו בנתיב שנוצר באמצעות [--output-file-path]/[build_id]

סיכום

יוצרים ציבוריים
XmlResultReporter()

שיטות ציבוריות
void	invocationEnded(long elapsedTime) האירוע הזה מדווח על סיום ההפעלה, בין שהיא הסתיימה בהצלחה ובין שהיא הסתיימה בגלל תנאי שגיאה כלשהו.
void	setLogSaver(ILogSaver logSaver) מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.
void	testFailed(TestDescription test, String trace) מדווח על כשל במקרה בדיקה ספציפי.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) הנתונים המשויכים של היומן או ניפוי הבאגים מהפעלת הבדיקה.
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) הקריאה מתבצעת כשיומן הבדיקה נשמר.

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

XmlResultReporter

public XmlResultReporter ()

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

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

public void invocationEnded (long elapsedTime)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

פרמטרים
elapsedTime	long: זמן ההפעלה שחלף באלפיות השנייה

setLogSaver

public void setLogSaver (ILogSaver logSaver)

מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.

פרמטרים
logSaver	ILogSaver: ILogSaver

הבדיקה נכשלה

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 לא יכול להיות ייחודי בכל הפעלה. כלומר, הטמעות צריכות להיות מסוגלות לטפל כמה קריאות עם אותו dataName
dataType	LogDataType: ה-LogDataType של הנתונים
dataStream	InputStreamSource: ה-InputStreamSource של הנתונים. מטמיעים צריכים להתקשר CreateInputStream כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה. מבצעי הקריאה צריכים לוודא שמקור הנתונים יישאר נוכח ונגיש עד להשלמת השיטה testLog.

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

הקריאה מתבצעת כשיומן הבדיקה נשמר.

צריך להשתמש בו במקום ב-ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

פרמטרים
dataName	String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'. הערה: שם המשתנה dataName לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה.
dataType	LogDataType: ה-LogDataType של הנתונים
dataStream	InputStreamSource: ה-InputStreamSource של הנתונים. מטמיעים צריכים להתקשר CreateInputStream כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה.
logFile	LogFile: ה-LogFile שמכיל את המטא-נתונים של הקובץ שנשמר.