החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

מחלקות משנה לא ישירות ידועות

‫ATestFileSystemLogSaver, ‏ AndroidBuildApiLogSaver, ‏ ClusterLogSaver, ‏ FileSystemLogSaver

ATestFileSystemLogSaver	המחלקות LogSaver משמשות את ATest לשמירת יומנים בנתיב ספציפי.
AndroidBuildApiLogSaver	מחלקת Android ששומרת קובצי יומן ב-Android Build API.
ClusterLogSaver	מחלקת `ILogSaver` להעלאת פלט של בדיקות ל-TFC.
FileSystemLogSaver	שמירת יומנים במערכת קבצים.

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

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

סיכום

‫methods ציבוריים
`abstract LogFile`	`getLogReportDir()` מקבלים את `LogFile` שמכיל את הנתיב או כתובת ה-URL של הספרייה שבה היומנים נשמרים.
`default void`	`init(IInvocationContext context)` התראה מוקדמת על אתחול, לפני שפרטי הבנייה זמינים.
`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)` שומרים את קובץ היומן.

‫methods ציבוריים

getLogReportDir

public abstract LogFile getLogReportDir ()

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

החזרות
`LogFile`	הכרטיס `LogFile`.

init

public void init (IInvocationContext context)

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

פרמטרים
`context`	‫`IInvocationContext`: מידע על הקריאה.

invocationEnded

public abstract void invocationEnded (long elapsedTime)

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

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

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

invocationStarted

public abstract void invocationStarted (IInvocationContext context)

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

המערכת תתקשר אוטומטית אל TradeFederation framework לפני שהיא תתקשר אל ITestInvocationListener.invocationStarted(IInvocationContext).

פרמטרים
`context`	‫`IInvocationContext`: מידע על הקריאה.

saveLogData

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

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

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

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

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat`String`
`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)

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

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

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat`String`
`dataType`	‫`LogDataType`: `LogDataType` של הקובץ.
`fileToLog`	‫`File`: `ERROR(/File)` שרוצים לשמור.

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

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