LogSaverresultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.result.LogSaverתוצאהForwarder

ResultForwarder לשמירת יומנים באמצעות שומר הקבצים הגלובלי.

סיכום

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

LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)

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

void invocationEnded(long elapsedTime)

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

void invocationStarted(IInvocationContext context)

דיווח על התחלת ההפעלה של הבדיקה.

void logAssociation(String dataName, LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן חזק למקרה בדיקה, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

static void logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

רישום קובץ סופי לפני הסיום

static void reportEndHostLog( listeners, ILogSaver saver, String name)

מדווח host_log מסשן בפעולה.

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

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

כמו כן, שומרים את קובץ היומן עם ILogSaver הגלובלי וקריאה ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) עבור המאזינים שמטמיעים את הממשק של ILogSaverListener.

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

מעבירים רק את testLog במקום לשמור את היומן קודם.

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

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

אם LogSaverResultForwarder עטוף ב-wrap אחר, צריך לוודא שאנחנו מעבירים את הקריאה החוזרת (callback) של testLogSaved למאזינים שמתחתיו.

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

LogSaverתוצאהForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

פרמטרים
logSaver ILogSaver

listeners

config IConfiguration

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

מדווח על התחלת ההפעלה של הבדיקה.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation. דיווחים צריכים לשנות את השיטה הזו כדי לתמוך בדיווח ממספר מכשירים.

פרמטרים
context IInvocationContext: מידע על ההפעלה

שיוך (logAssociation)

public void logAssociation (String dataName, 
                LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן חזק למקרה בדיקה, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). כך, קריאת ה-callback הזו מאפשרת לספק באופן מפורש שיוך חזק.

פרמטרים
dataName String: השם של הנתונים
logFile LogFile: ה-LogFile שרשום ביומן קודם וצריך לשייך למקרה הבדיקה.

קובץ LogFile

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

רישום קובץ סופי לפני הסיום

פרמטרים
listeners

saver ILogSaver

source InputStreamSource

name String

type LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

מדווח host_log מסשן בפעולה.

פרמטרים
listeners

saver ILogSaver

name String

יומן בדיקה

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

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

חובה להתקשר לפני ERROR(/ITestInvocationListener#invocationFailed(Throwable)) או ERROR(/ITestInvocationListener#invocationEnded(long))

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

בנוסף, שומרים את קובץ היומן באמצעות ILogSaver הגלובלי ומפעילים את ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) למאזינים שמטמיעים את הממשק ILogSaverListener.

פרמטרים
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)

צריך להעביר את קובץ ה-testLog במקום לשמור את היומן קודם.

פרמטרים
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

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

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

אם LogSaverResultForwarder עטוף ב-wrap אחר, צריך לוודא שאנחנו מעבירים את הקריאה החוזרת (callback) של testLogSaved למאזינים שמתחתיו.

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