LogSaverresultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

JavaScript.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)

במקרים מסוימים היומן צריך להיות משויך באופן הדוק למקרי הבדיקה, אבל אפשר לעשות זאת כך גם בקישור הישיר 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)

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

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

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

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

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

LogSaverresultForwarder 

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

פרמטרים
logSaver ILogSaver

listeners

config IConfiguration

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

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

public void invocationEnded (long elapsedTime)

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

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

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

ההפעלה התחילה

public void invocationStarted (IInvocationContext context)

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

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

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

שיוך (logAssociation)

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

testLogForward

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

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

פרמטרים
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

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

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

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

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