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

דף זה תורגם על ידי Cloud Translation API.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

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

AggregatePostProcessor	מצבר מדדים שמציג את הערכים הבאים: מינימום, מקסימום, ממוצע, שונות, סטיית תקן, סה"כ, ספירה ואחוזונים (אופציונלי) של מדדים מספריים שנאספו במהלך הפעלות בדיקה מרובות איטרציות, תוך התייחסות אליהם כאל מספרים ממשיים.
AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
AtraceRunMetricCollector	איסוף העקבות מכל ספריית הבדיקה בספרייה הנתונה ממכשיר הבדיקה, רישום ספריית הבדיקה ועיבוד שלאחר האיסוף של קובצי העקבות בספריית הבדיקה וצבירת המדדים.
AveragePostProcessor	הטמעה של מעבד פוסט שחישב את הממוצע של רשימת המדדים.
BaseDeviceMetricCollector	הטמעה בסיסית של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וב-`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.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 ב-DUT ולאיסוף היומן לכל בדיקה.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java ושל קוד מקורי מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
ConsoleResultReporter	כלי לדיווח על תוצאות, להדפסת תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה ודיווח של מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	כלי לאיסוף ולרישום של יומני הצד של המארח כשמתרחשת שגיאה בתרחיש בדיקה.
DeviceTraceCollector	כלי לאיסוף נתונים שמתחיל מעקב ב-Perfetto כשמתחילים להריץ בדיקה, ומתעד את קובץ המעקב בסוף.
EventsLoggerListener	רכיב Listener שמתעד את כל האירועים שהוא מקבל בקובץ
FileProtoResultReporter	כלי ליצירת דוחות בפורמט Proto שמייצא את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמקשיב למפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
FormattedGeneratorReporter	כלי ליצירת דוחות שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של gcov מהמכשיר וירשום אותם כארטיפקטים של הבדיקה.
GcovKernelCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של ליבת gcov מ-debugfs ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לשיעור שיעזור לכם לזהות מקרים שבהם חסרים נתוני התחלה וסיום של ריצה.
HostStatsdMetricCollector	‫`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות של כלי statsd.
IMetricCollector	הממשק הזה יתווסף כ-decorator כשמדווחים על תוצאות של בדיקות, כדי לאסוף מדדים תואמים.
IPostProcessor	מעבדי פוסט הם אובייקט של Trade Federation שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ולפני דיווח התוצאות.
InvocationProtoResultReporter	הכלי Reporters מאחסן מידע על שמירת נתונים במטמון ברמת ההפעלה ואת רשימת המודולים שלו
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
JsonHttpTestResultReporter	כלי לדיווח על תוצאות שמקודד את תוצאות המדדים של הבדיקה ואת פרטי הענף והמכשיר ל-JSON, ושולח אותם לנקודת קצה של שירות 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, אבל עבור מודול.
ModuleProtoResultReporter	כלי לדיווח על תוצאות שנועד לדווח רק על תוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	תוסף של `ResultAndLogForwarder` שמוסיף לממצאי הבדיקה מדדים נוספים שקשורים למודול.
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קובצי מעקב של Perfecto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של Perfecto.
ProtoResultReporter	הכלי Result reporter יוצר `TestRecord` protobuf עם כל התוצאות.
‫RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה מסוימת, ולגרום לכך שהבדיקה תיכשל אם היא חורגת מזמן קצוב מסוים.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגה של בדיקה שעברה.
ResultAggregator	מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שנבחרה.
ResultAndLogForwarder	מעביר תוצאות ואירועים ביומן.
ResultDBReporter	כלי לדיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB.
ResultReporter
RetryLogSaverResultForwarder	העברה שגם מטפלת בהעברת הניסיון הנוכחי שאנחנו נמצאים בו.
RuntimeRestartCollector	כלי לאיסוף נתונים שאוסף חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשהתרחיש לבדיקה ייכשל.
ShardListener	‫`ITestInvocationListener` שאוסף תוצאות משבר הפעלה (כלומר, פיצול של הפעלה להרצה במקביל בכמה משאבים) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	‫`ResultForwarder` שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד פוסט שמעבד מדדי אירועים בדוחות statsd לצמדי מפתח/ערך, באמצעות מעצבי הפורמט שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות statsd של פרוטוקול בינארי לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	מטמיע את `ITestInvocationListener` כדי לציין אותו כ-result_reporter ולהעביר מתהליך המשנה את תוצאות הבדיקות, הרצות הבדיקות והפעלות הבדיקות.
SuiteResultReporter	איסוף תוצאות הבדיקה עבור הפעלה של חבילה שלמה והצגת התוצאות הסופיות.
TextResultReporter	כלי לדיווח על תוצאות בדיקה שמעביר את התוצאות למדפיס תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותם ביומן של הקריאה.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` באיזה פורמט התוצאות של החבילה בפורמט xml
XmlResultReporter	כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

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

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

במחלקה שמטמיעה את הממשק הזה צריך לדעת שהמערכת תקרא ל-testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) בכל פעם שהיא תקרא ל-ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

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

סיכום

‫methods ציבוריים
`default void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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`: `String` שם תיאורי של הנתונים, למשל device_logcat. הערה יכול להיות ש-dataName לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו dataName
`dataType`	‫`LogDataType`: `LogDataType` של הנתונים
`dataStream`	`InputStreamSource`: `InputStreamSource` הנתונים. מטמיעים צריכים לקרוא ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שסוגרים את InputStream שמתקבל בסיום.
`logFile`	‫`LogFile`: `LogFile` שמכיל את המטא-נתונים של הקובץ שנשמר.