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

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

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

RetryLogSaverResultForwarder

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

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

סיכום

‫constructors ציבוריים
`LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config)`
`LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config, boolean setLogSaver)`

‫methods ציבוריים
`void`	`invocationEnded(long elapsedTime)` הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.
`void`	`invocationStarted(IInvocationContext context)` הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.
`void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`static void`	`logFile(List<ITestInvocationListener> listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)` רישום קובץ סופי לפני השלמת ההעברה
`static void`	`reportEndHostLog(List<ITestInvocationListener> 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` עטוף באחר, צריך לוודא שנעביר את הקריאה החוזרת testLogSaved למאזינים שמתחתיו.
`void`	`testModuleEnded()` הפונקציה מדווחת על סיום של הרצת מודול.
`void`	`testModuleStarted(IInvocationContext moduleContext)` האירוע הזה מדווח על תחילת ההפעלה של מודול.

‫constructors ציבוריים

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config)

פרמטרים
`logSaver`	`ILogSaver`
`listeners`	`List`
`config`	`IConfiguration`

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config, 
                boolean setLogSaver)

פרמטרים
`logSaver`	`ILogSaver`
`listeners`	`List`
`config`	`IConfiguration`
`setLogSaver`	`boolean`

‫methods ציבוריים

invocationEnded

public void invocationEnded (long elapsedTime)

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

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

logFile

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

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

פרמטרים
`listeners`	`List`
`saver`	`ILogSaver`
`source`	`InputStreamSource`
`name`	`String`
`type`	`LogDataType`

reportEndHostLog

public static void reportEndHostLog (List<ITestInvocationListener> listeners, 
                ILogSaver saver, 
                String name)

מדווח על host_log מסשן שנמצא בתהליך.

פרמטרים
`listeners`	`List`
`saver`	`ILogSaver`
`name`	`String`

testLog

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

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

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

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

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

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat.`String` הערה יכול להיות ש-dataName לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו 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 עטוף באחר, צריך לוודא שנעביר את הקריאה החוזרת testLogSaved למאזינים שמתחתיו.

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

testModuleEnded

public void testModuleEnded ()

הפונקציה מדווחת על סיום של הרצת מודול.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

האירוע הזה מדווח על תחילת ההפעלה של מודול. הקריאה החוזרת הזו משויכת ל-testModuleEnded() והיא אופציונלית ברצף. הוא נמצא בשימוש רק במהלך הרצה שמשתמשת במודולים: suite based runners.

פרמטרים
`moduleContext`	‫`IInvocationContext`: `IInvocationContext` של המודול.