ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver


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

ILogSaver מוגדר בתצורה והוא אחראי לאחסון היומנים במיקום מרכזי. הוא גם חושף שיטות כדי ש-ILogSaverListeners יוכלו לשמור קבצים נוספים באותו מיקום.

סיכום

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

abstract LogFile getLogReportDir()

מקבלים את LogFile שמכיל את הנתיב ו/או את כתובת ה-URL של הספרייה שבה נשמרים היומנים.

default void init(IInvocationContext context)

התראה מוקדמת על אתחול, לפני שפרטים על גרסאות build יהיו זמינים.

abstract void invocationEnded(long elapsedTime)

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

abstract void invocationStarted(IInvocationContext context)

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

abstract LogFile saveLogData(String dataName, LogDataType dataType, InputStream dataStream)

שומרים את נתוני היומן.

default LogFile saveLogDataRaw(String dataName, LogDataType dataType, InputStream dataStream)

השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-saveLogData(String, com.android.tradefed.result.LogDataType, InputStream)

default LogFile saveLogFile(String dataName, LogDataType dataType, File fileToLog)

שומרים את קובץ היומן.

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

getLogReportDir

public abstract LogFile getLogReportDir ()

מקבלים את LogFile שמכיל את הנתיב ו/או את כתובת ה-URL של הספרייה שבה נשמרים היומנים.

החזרות
LogFile LogFile.

init

public void init (IInvocationContext context)

התראה מוקדמת על אתחול, לפני שפרטים על גרסאות build יהיו זמינים. כך תוכלו להגדיר את הדרישות לקבלת יומנים.

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

invocationEnded

public abstract void invocationEnded (long elapsedTime)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation אחרי הקריאה ל-ITestInvocationListener.invocationEnded(long).

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

invocationStarted

public abstract void invocationStarted (IInvocationContext context)

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

המערכת תבצע קריאה אוטומטית ל-method הזה במסגרת TradeFederation לפני שתתבצע קריאה ל-ITestInvocationListener.invocationStarted(IInvocationContext).

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

saveLogData

public abstract LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

שומרים את נתוני היומן.

המערכת תבצע קריאה אוטומטית ל-method הזה במסגרת TradeFederation בכל פעם שתתבצע קריאה ל-ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource). אפשר גם להשתמש בה כשיטת עזר לשמירת נתוני יומן נוספים.

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

פרמטרים
dataName String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'

dataType LogDataType: ה-LogDataType של הקובץ.

dataStream InputStream: ה-ERROR(/InputStream) של הנתונים.

החזרות
LogFile השדה LogFile שמכיל את הנתיב וכתובת ה-URL של הקובץ שנשמר.

זריקות
אם לא ניתן היה ליצור את קובץ היומן

saveLogDataRaw

public LogFile saveLogDataRaw (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

השיטה הזו הוצאה משימוש.
יש להשתמש ב-saveLogData(String, com.android.tradefed.result.LogDataType, InputStream) במקום זאת

שיטה מסייעת לשמירת נתוני היומן ללא שינוי.

ניתן לאחסן יומנים במיקום שלא נגיש ל-Tradefed.

פרמטרים
dataName String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'.

dataType LogDataType: LogDataType שמכיל את הסוג ואת הסיומת של הקובץ

dataStream InputStream: ה-ERROR(/InputStream) של הנתונים.

החזרות
LogFile השדה LogFile שמכיל את הנתיב וכתובת ה-URL של הקובץ שנשמר.

זריקות
אם לא ניתן היה ליצור את קובץ היומן

saveLogFile

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

שומרים את קובץ היומן.

המערכת תבצע קריאה אוטומטית ל-method הזה במסגרת TradeFederation בכל פעם שמפעילים את ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) והסטרימינג מפנה לקובץ.

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

פרמטרים
dataName String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'

dataType LogDataType: ה-LogDataType של הקובץ.

fileToLog File: ה-ERROR(/File) שרוצים לשמור.

החזרות
LogFile השדה LogFile שמכיל את הנתיב וכתובת ה-URL של הקובץ שנשמר.

זריקות
אם לא ניתן היה ליצור את קובץ היומן