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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

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

‫ATestFileSystemLogSaver, ‏ AndroidBuildApiLogSaver, ‏ ClusterLogSaver, ‏ FileSystemLogSaver

ATestFileSystemLogSaver	המחלקות LogSaver האלה משמשות את ATest כדי לשמור יומנים בנתיב ספציפי.
AndroidBuildApiLogSaver	כיתה ששומרת קובצי יומן ב-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,LogDataType,InputStream)`
`default LogFile`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` שומרים את קובץ היומן.
`default void`	`testModuleEnded()` הודעה שהמודול לבדיקה הסתיים.
`default void`	`testModuleStarted(IInvocationContext context)` הפונקציה מחזירה את תחילת מודול הבדיקה.

‫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 תקרא לפונקציה הזו באופן אוטומטי לפני הקריאה לפונקציה ITestInvocationListener.invocationStarted(IInvocationContext).

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

saveLogData

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

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

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

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

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat`String`
`dataType`	‫`LogDataType`: `LogDataType` של הקובץ.
`dataStream`	`InputStream`: `InputStream` הנתונים.

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

הקפצת הודעות שגיאה (throw)
`IOException`	אם לא ניתן ליצור קובץ יומן

saveLogDataRaw

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

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

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

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

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat.`String`
`dataType`	‫`LogDataType`: `LogDataType` שמכיל את הסוג והסיומת של הקובץ
`dataStream`	`InputStream`: `InputStream` הנתונים.

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

הקפצת הודעות שגיאה (throw)
`IOException`	אם לא ניתן ליצור קובץ יומן

saveLogFile

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

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

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation בכל פעם שמופעלת הפונקציה ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) והזרם מפנה לקובץ.

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

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

הקפצת הודעות שגיאה (throw)
`IOException`	אם לא ניתן ליצור קובץ יומן

testModuleEnded

public void testModuleEnded ()

הודעה שהמודול לבדיקה הסתיים.

testModuleStarted

public void testModuleStarted (IInvocationContext context)

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

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