דף זה תורגם על ידי 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,‏ CollectingTestListener,‏ ConsoleResultReporter ו-49 אחרים.

AggregatePostProcessor	צובר מדדים שמציג את הערכים המינימלי, המקסימלי, הממוצע, השונות, סטיית התקן, הסכום, המספר והפרסנטילים (אופציונלי) של מדדים מספריים שנאספו במהלך מספר סבבי בדיקה, כאשר הם מטופלים כמספרים כפולים.
AtraceCollector	`IMetricCollector` שמפעיל את atrace במהלך בדיקה, אוסף את התוצאה ומעדכן את היומן בקריאה.
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 של Bluetooth HCI ב-DUT ואיסוף היומן לכל בדיקה.
BugreportzOnFailureCollector	איסוף דוח bugreportz כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.
ClangCodeCoverCollector	`BaseDeviceMetricCollector` שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדות אותן ביומן כפריטי בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
ConsoleResultReporter	דיווח על תוצאות כדי להדפיס את תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה ודיווח על מספר מקרי הבדיקה של `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	אוסף שיאסוף את היומנים בצד המארח ויתעדה אותם ביומן כשמתרחשת כשל בתרגיל הבדיקה.
DeviceTraceCollector	אוסף שיתחיל מעקב של perfetto כשהרצת הבדיקה תתחיל, וירשום את קובץ המעקב ביומן בסיום.
EventsLoggerListener	מאזין שמתעדה ביומן את כל האירועים שהוא מקבל בקובץ
FileProtoResultReporter	דיווח על פרוטוקול שמפיק את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמאזין למפתח מדדים שמגיע מהמכשיר ומושך אותם כקובץ מהמכשיר.
FilePullerLogCollector	יומן של הקובץ שדווח בצד המכשיר.
FormattedGeneratorReporter	כלי דיווח שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך מדידות כיסוי של הליבה של gcov מ-debugfs ומהמכשיר, ולאחר מכן מתעד אותן כפריטי מידע שנוצרו במהלך הבדיקה.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לכיתה לזיהוי תחילת ריצה וסיום ריצה חסרים.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות השירות של statsd.
IMetricCollector	הממשק הזה יתווסף כעיצוב בדיווח על תוצאות הבדיקה כדי לאסוף מדדים תואמים.
IPostProcessor	עיבוד נתונים לאחר הבדיקה הוא אובייקט של Trade Federation שמאפשר עיבוד של מדדים ורשומות ביומן אחרי הבדיקה ולפני הדיווח על התוצאות.
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	משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה.
MetricsXMLתוצאהReporter	MetricsXMLתוצאהReporter כותב מדדי בדיקה ומריצים מדדים לקובץ XML בתיקייה שצוינה בפרמטר של תיקיית המדדים בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין שמצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסת האוסף של logcat, אבל למודול.
ModuleProtoResultReporter	דיווח על תוצאות שמיועד לדיווח רק על התוצאות ברמת המודול.
PerfettoGenericPostProcessor	מעבד פוסט שממיר קובץ proto של מדד טקסט/בינארי ב-perfetto לצמדי מפתח/ערך על ידי הרחבה רפרסיבית של הודעות ה-proto והשדות עם ערכי מחרוזות, עד שמגיעים לשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את קובצי Perfoto מהמכשיר ולאסוף ממנו את המדדים.
ProtoResultReporter	דיווח על תוצאות יוצר protobuf של `TestRecord` עם כל התוצאות בפנים.
RebootReasonCollector	אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה.
ResultAggregator	שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה.
ResultAndLogForwarder	שירות העברה של תוצאות ואירועים ביומן.
RetryLogSaverResultForwarder	שרת העברה שמטפל גם בהעברת הניסיון הנוכחי.
RuntimeRestartCollector	אוסף שמאגר חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenshotOnFailureCollector	אמצעי איסוף נתונים שצילום מסך יתועד ויירשם ביומן כאשר מקרה בדיקה נכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מחלקיק של קריאה (קריאה שמפוצלת לצורך הפעלה בכמה משאבים בו-זמנית) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	`ResultForwarder` שמאחד את התוצאות של הקריאות לבדיקה שמחולקות למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד מידע שמעבד מדדים של מדדים שנאספים בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד פוסט שממיר מדדי אירועים בדוחות של statsd לצמדי מפתח/ערך, באמצעות הפורמטרים שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט (postoring) שמעבד דוחות של נתונים סטטיסטיים בינאריים מסוג אב-ערך לצמדי מפתח-ערך, על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	הטמעת `ITestInvocationListener` כדי לציין אותו בתור דיווח על תוצאות, והעברה מהתהליך המשני של תוצאות הבדיקות, הפעלות הבדיקות והפעלות הבדיקה.
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 יוכלו לשמור קבצים נוספים באותו המיקום.

סיכום

שיטות ציבוריות
`default void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן הדוק למקרים של בדיקות, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של `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)` הקריאה מתבצעת כשיומן הבדיקה נשמר.

שיטות ציבוריות

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן הדוק למקרים של בדיקות, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של 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 לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה.
`dataType`	`LogDataType`: ה-`LogDataType` של הנתונים
`dataStream`	`InputStreamSource`: ה-`InputStreamSource` של הנתונים. מטמיעי האפליקציות צריכים לקרוא ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שה-InputStream שנוצר נסגר בסיום.
`logFile`	`LogFile`: ה-`LogFile` שמכיל את המטא-נתונים של הקובץ שנשמר.