החל משנת 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.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

‫AggregatePostProcessor,‏ AndroidBuildResultReporter,‏ AtraceCollector,‏ AtraceRunMetricCollector,‏ AveragePostProcessor,‏ BaseDeviceMetricCollector,‏ BasePostProcessor,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothConnectionSuccessRatePostProcessor,‏ BluetoothHciSnoopLogCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector,‏ CodeCoverageCollector ועוד 63 אחרים.

AggregatePostProcessor	מצבר מדדים שמציג את הערכים הבאים: מינימום, מקסימום, ממוצע, שונות, סטיית תקן, סה"כ, ספירה ואחוזונים (אופציונלי) של מדדים מספריים שנאספו במהלך הפעלות בדיקה מרובות איטרציות, תוך התייחסות אליהם כאל מספרים ממשיים.
‫AndroidBuildResultReporter	התוצאות של הבדיקה מדווחות ל-Android Build API.
AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
AtraceRunMetricCollector	הפקודה אוספת את העקבות מכל ספריית הבדיקה בספרייה הנתונה ממכשיר הבדיקה, מתעדת את ספריית הבדיקה ומבצעת עיבוד לאחר העיבוד של קובצי העקבות בספריית הבדיקה ומצטברת את המדדים.
AveragePostProcessor	הטמעה של מעבד פוסט שחישב את הממוצע של רשימת המדדים.
BaseDeviceMetricCollector	יישום בסיסי של `IMetricCollector` שמאפשר להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(DeviceMetricData)` וב-`onTestRunEnd(DeviceMetricData,Map)`.
BasePostProcessor	מחלקת הבסיס `IPostProcessor` שכל הטמעה צריכה להרחיב.
BluetoothConnectionLatencyCollector	הכלי לאיסוף נתונים ידחוף למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך החיבור ב-Bluetooth לכל פרופיל.
‫BluetoothConnectionStateCollector	הכלי הזה יאסוף מדדים של BluetoothConnectionStateChanged ויתעד את מספר מצב החיבור לכל פרופיל.
BluetoothConnectionSuccessRatePostProcessor	הטמעה של מעבד שאחרי העיבוד שמחשב את שיעור ההצלחה של פרופיל Bluetooth משתמשים ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור Bluetooth במערך מספרי. דוגמה [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	כלי לאיסוף נתונים שמאפשר להפעיל רישום Snoop עבור HCI של Bluetooth במכשיר הנבדק ולאסוף את היומן לכל בדיקה.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך מדידות של כיסוי Java וכיסוי מקורי מהמכשיר וירשום אותן כארטיפקטים של בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
ConsoleResultReporter	כלי לדיווח על תוצאות, להדפסת תוצאות הבדיקה במסוף.
CountTestCasesCollector	לספור ולדווח על מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
CoverageMetadataCollector	‫`ILogSaverListener` שאוסף מדדי כיסוי שנרשמו ביומן ויוצר CoverageMetadataProto לעיבוד על ידי שירות כיסוי הקוד של Android.
DebugHostLogOnFailureCollector	אספן שיאסוף ויתעד את היומנים בצד המארח כשמתרחשת שגיאה בתרחיש בדיקה.
DeviceTraceCollector	כלי לאיסוף נתונים שיפעיל מעקב ב-Perfetto כשמתחילים בהרצת בדיקה, ויתעד את קובץ המעקב בסוף.
EventsLoggerListener	פונקציית listener שמתעדת את כל האירועים שהיא מקבלת בקובץ
FileProtoResultReporter	כלי ליצירת דוחות בפורמט Proto שמייצא את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמקשיב למפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
FormattedGeneratorReporter	כלי ליצירת דוחות שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של gcov מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
GcovKernelCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של ליבת gcov מ-debugfs ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
‫GeminiDebuggingPostProcessor	מעבד פוסטים שיוצר שאילתות הנחיה לניפוי שגיאות.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לשיעור שיעזור לכם לזהות מקרים שבהם חסרים נתוני התחלה וסיום של ריצה.
HostStatsdMetricCollector	‫`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות של כלי statsd.
IMetricCollector	הממשק הזה יתווסף כ-decorator כשמדווחים על תוצאות של בדיקות, כדי לאסוף מדדים תואמים.
IPostProcessor	מעבדי פוסט הם אובייקט של Trade Federation שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ולפני דיווח התוצאות.
InvocationProtoResultReporter	הכלי Reporters לאחסון מידע על שמירת נתונים במטמון ברמת ההפעלה ורשימת המודולים שלו
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
JsonHttpTestResultReporter	כלי לדיווח על תוצאות שמקודד את תוצאות המדדים של הבדיקה ואת פרטי הענף והמכשיר ל-JSON, ושולח אותם באמצעות POST לנקודת קצה של שירות HTTP
LUCIResultReporter	כלי לדיווח על תוצאות ששומר את תוצאות הבדיקה שנדרשות על ידי ResultDB ו-LUCI בפורמט JSON (go/result-sink) ומתעד את מיקום הקובץ במסוף.
LegacySubprocessResultsReporter	הטמעה קפואה של הכלי לדיווח על תוצאות של תהליכי משנה, שאמורה להישאר תואמת לגרסאות קודמות של TF/CTS (למשל 8 ומעלה), למרות שינויים במחלקת העל שלה.
LogSaverResultForwarder	`ResultForwarder` לשמירת יומנים באמצעות הכלי הגלובלי לשמירת קבצים.
LogcatOnFailureCollector	כלי לאיסוף נתונים שיכול לתעד ולרשום ביומן logcat כשמקרה בדיקה או הרצת בדיקה נכשלים.
LogcatTimingMetricCollector	כלי לאיסוף מדדים שאוסף מידע על תזמון (למשל זמן המעבר בין משתמשים) מ-logcat במהלך בדיקה חוזרת אחת או יותר, באמצעות דפוסי ביטוי רגולרי שמוגדרים מראש כדי לנתח אותות התחלה וסיום של אירוע משורות logcat.
MetricFilePostProcessor	הקובץ משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה.
MetricsXMLResultReporter	‫MetricsXMLResultReporter כותב מדדי בדיקה ומדדי הרצה לקובץ XML בתיקייה שצוינה על ידי הפרמטר metrics-folder בשלב invocationEnded של הבדיקה.
‫ModuleListener	מאזין שמצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסה של logcat collector אבל למודול.
ModulePerfettoCollector	כלי לאיסוף נתונים שיתחיל את המעקב של perfetto כשמודול בדיקה יתחיל ויסתיים, וכשהמכשיר יופעל מחדש.
ModuleProtoResultReporter	כלי לדיווח על תוצאות שנועד לדווח רק על תוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	הרחבה של `ResultAndLogForwarder` שמוסיפה מדדים נוספים שקשורים למודול לתוצאות הבדיקה.
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קבצים של מעקב perfetto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של perfetto.
ProtoResultReporter	הכלי Result reporter יוצר `TestRecord` protobuf עם כל התוצאות.
RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן ההרצה של הגדרת בדיקה מסוימת, ולגרום לכך שהבדיקה תיכשל אם היא חורגת מזמן קצוב לתפוגה מסוים.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגה של בדיקה שעברה.
ResultAggregator	מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שננקטה.
ResultAndLogForwarder	מעביר תוצאות ואירועים ביומן.
ResultDBReporter	כלי לדיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB.
ResultReporter
RetryLogSaverResultForwarder	העברה שמטפלת גם בהעברת הניסיון הנוכחי שאנחנו נמצאים בו.
RuntimeRestartCollector	אוסף שמקבל חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenRecordOnFailureCollector	כלי לאיסוף נתונים שיצלם וישמור יומן של הקלטת מסך כשמקרה בדיקה נכשל.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך ויתעד אותו ביומן כשמקרה בדיקה ייכשל.
ShardListener	‫`ITestInvocationListener` שאוסף תוצאות משבר הפעלה (כלומר, הפעלה שפוצלה כדי לפעול במקביל בכמה משאבים) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	‫`ResultForwarder` שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים.
ShowmapPullerMetricCollector	יישום בסיסי של `FilePullerDeviceMetricCollector` שמאפשר לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
SimpleperfProfilePostProcessor	מעבד פוסט שמוצא נתוני פרופיל של simpleperf ויוצר פרופיל pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד שאחרי העיבוד, שמטפל במדדי אירועים בדוחות של statsd והופך אותם לצמדי מפתח/ערך באמצעות מעצבי הפורמט שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות בינאריים של proto statsd לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	מטמיע את `ITestInvocationListener` כדי לציין אותו כ-result_reporter ולהעביר מהתהליך המשני את התוצאות של הבדיקות, הרצות הבדיקות והפעלות הבדיקות.
SuiteResultReporter	איסוף תוצאות הבדיקה עבור הפעלה של חבילה שלמה והצגת התוצאות הסופיות.
TextResultReporter	כלי לדיווח על תוצאות בדיקה שמעביר את התוצאות למדפיס תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותן ביומן של הקריאה.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` באיזה פורמט התוצאות של החבילה בפורמט xml
XmlResultReporter	כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

מאפשר ל-ITestInvocationListener להאזין למצב שבו קובצי יומן נשמרים.

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

במחלקה שמטמיעה את הממשק הזה צריך לזכור שהמערכת תקרא ל-testLogSaved(String,LogDataType,InputStreamSource,LogFile) בכל פעם שהיא תקרא ל-ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

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

סיכום

‫methods ציבוריים
`default void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`default void`	`setLogSaver(ILogSaver logSaver)` מגדירים את `ILogSaver` כדי לאפשר למטמיע לשמור קבצים.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` מופעל כשיומן הבדיקה נשמר.

‫methods ציבוריים

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.

פרמטרים
`logSaver`	`ILogSaver`: `ILogSaver`

testLogSaved

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

מופעל כשיומן הבדיקה נשמר.

צריך להשתמש במקומה במדיניות ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

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