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

XmlResultReporter

public class XmlResultReporter
extends CollectingTestListener implements ILogSaverListener

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

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

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

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

הועבר מ-XmlReportPrinter של dalvik runner.

קובצי התוצאה יישמרו בנתיב שנוצר באמצעות [--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 ()

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

פרמטרים
`logSaver`	`ILogSaver`: `ILogSaver`

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.

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 כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום.
`logFile`	`LogFile`: ה-`LogFile` שמכיל את המטא-נתונים של הקובץ השמור.