ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

תתי-מחלקות עקיפות ידועות 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 האספן יחסום הגדרה מוגדרת מראש של מדד משך הזמן של הנתונים הסטטיסטיים במכשיר, ויאסוף משך החיבור של Bluetooth לכל פרופיל.  BluetoothConnectionStateCollector האספן הזה יאסוף מדדי BluetoothConnectionStateChanged ויתעד את מצב החיבור המספר של כל פרופיל.  BluetoothConnectionSuccessRatePostProcessor הטמעת מעבד לאחר מכן שמחשב את שיעור ההצלחה של פרופיל Bluetooth שימוש ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור של Bluetooth דוגמה למערך [0, 1, 2, 3, 0, 1, 2, 3].  BluetoothHciSnoopLogCollector Collector כדי להפעיל רישום snoop של Bluetooth HCI ב-DUT ולאסוף את היומן עבור כל בדיקה.  BugreportzOnFailureCollector איסוף דוח על באג אם מקרה בדיקה נכשל.  BugreportzOnTestCaseFailureCollector איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.  ClangCodeCoverCollector BaseDeviceMetricCollector שימשוך את Clang של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  CollectingTestListener ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.  ConsoleמוצאReporter כתב התוצאות ידפיס את תוצאות הבדיקה במסוף.  CountTestCasesCollector ספירה ודיווח על מספר מקרי הבדיקה של IRemoteTest נתון.  DebugHostLogOnFailureCollector Collector שיאסוף את היומנים בצד המארח וירשום אותם ביומן כאשר מתרחש כשל בתרחיש בדיקה.  DeviceTraceCollector אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.  EventsLoggerListener ה-listener שמתעד בקובץ את כל האירועים שהוא מקבל. FileProtoClaimReporter כתב אב שמוסיף את TestRecord לקובץ.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמזהה מפתח מדדים שמגיע מהמכשיר ומושך כקובץ מהמכשיר.  FilePullerLogCollector יומן הרישום של הקובץ שדווח בצד המכשיר.  FormattedGeneratorReporter כתב שמאפשר ליצור דוחות בפורמט מסוים.  GcovCodeCoverCollector BaseDeviceMetricCollector שימשוך gcov של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  GcovKernelCodeCoverCollector BaseDeviceMetricCollector שימשוך ליבה (kernel) של gcov מדידות של הכיסוי מתוך ניפוי באגים ומחוץ למכשיר, ואז הן מתועדות כבדיקה. ארטיפקטים.  GranularRetriableTestWrapper.StartEndCollector עוזר/ת בכיתה לזהות נקודות התחלה וסיום חסרות לריצה.  HostStatsdMetricCollector IMetricCollector שאוסף מדדים סטטיסטיים מהצד המארח באמצעות נתונים סטטיסטיים פקודות.  IMetricCollector הממשק הזה יתווסף כעיצוב בזמן דיווח על תוצאות הבדיקה כדי לאסוף מדדים תואמים.  IPostProcessor השירות 'מעבדי פוסט' הוא אובייקט של איחוד שירותי הסחר, שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ודיווח על התוצאות לפני הבדיקה.  JavaCodeCoverCollector BaseDeviceMetricCollector שיאחזר את Java של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  JsonHttpTestresultsReporter כתב תוצאות שמקודד תוצאות של מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST בנקודת קצה של שירות HTTP LUCIתוצאהReporter כתב תוצאות ששומר את תוצאות הבדיקה שנדרשות על ידי resultDB ו-LUCI בפורמט JSON (go/result-sink) ורושם את מיקום הקובץ במסוף.  LegacySubprocess ResultsReporter (דיווח על התוצאות של תהליכים שעברו תהליכים קודם) הטמעה קפואה של דיווח התוצאות של תהליך המשנה שאמורה להיות תואמת גרסאות קודמות של TF/CTS (למשל 8+ ), למרות שינויים במחלקה-העל.  LogSaverתוצאהForwarder ResultForwarder לשמירת יומנים באמצעות שומר הקבצים הגלובלי.  LogcatOnFailureCollector Collector שיתעד וירשום ביומן Logcat כשמקרה בדיקה נכשל.  LogcatTimingMetricCollector כלי לאיסוף מדדים שאוסף פרטי תזמון (למשל, זמן המעבר של המשתמש) מ-Logcat במהלך בדיקה חוזרת אחת או יותר על ידי שימוש בתבניות ביטויים רגולריים (regex) כדי לנתח אותות התחלה וסיום של אירוע משורות Logcat.  MetricFilePostProcessor משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה וההרצה.  MetricsXMLתוצאהReporter MetricsXMLתוצאהReporter כותבת מדדי בדיקה ומריצים מדדים בקובץ XML בתיקייה שצוינה לפי פרמטר תיקיית המדדים בשלב invocationEnded של הבדיקה.  ModuleListener ה-listener מצורף לכל IRemoteTest של כל מודול כדי לאסוף את הרשימה של תוצאות.  ModuleLogcatCollector גרסת אספן Logcat, אבל למודול.  PerfettoGeneralPostProcessor מעבד פוסט שמעבד קובץ פרוטו של טקסט/מדד בינארי לצמדי מפתח/ערך באמצעות מרחיב באופן רקורסיבי את ההודעות והשדות של הפרוטו עם ערכי מחרוזות עד לשדה עם המערכת נתקלה בערך מספרי.  PerfettoPullerMetricCollector ההטמעה הבסיסית של FilePullerDeviceMetricCollector שמאפשרת שולפת את הקבצים הקבועים מהמכשיר ואוספת ממנו את המדדים.  ProtoresultsReporter כתב התוצאות יבנה אב-טיפוס של TestRecord שכולל את כל התוצאות.  להפעיל מחדש את האסיסטנט אוסף שאוסף הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהן לפי סיבה וספירה.  ReportPassedTests דיווח בקובץ מסננים אפשריים כדי לא לכלול את הבדיקה שעברה בהצלחה.  צבירת תוצאות העברה מיוחדת שצוברת את התוצאות במקרה הצורך, על סמך אסטרטגיית הניסיונות החוזרים נלקחו.  resultAndLogForwarder העברה לאירועים ולתוצאות ביומנים.  RetryLogSaverתוצאהForwarder העברה שמטפלת גם במעבר של הניסיון הנוכחי שאנחנו נמצאים בו.  RuntimeResumeCollector אוסף שאוסף חותמות זמן של הפעלות מחדש של סביבת זמן הריצה (קריסות של שרת המערכת) במהלך הבדיקה להפעיל, אם בכלל.  ScreenshotOnFailureCollector Collector שיצלם ויתעד צילום מסך כשמקרה בדיקה ייכשל.  ShardListener ITestInvocationListener שאוסף תוצאות מפיצול הפעלה (כלומר הפעלה של כמה משאבים במקביל), ומעבירה אותם לאחד מהמשאבים Listener.  ShardMainתוצאהForwarder ResultForwarder שמשלבת את התוצאות של הפעלות בדיקה מפוצלות.  ShowmapPullerMetricCollector הטמעת הבסיס של FilePullerDeviceMetricCollector שמאפשרת לשלוף את מפת התוכנית קבצים מהמכשיר ולאסוף ממנו את המדדים.  StatsdBeforeAfterGaugeMetricPostProcessor מעבד מידע שמעבד מדדי מדידה שנאספו בשיטת 'לפני/אחרי' גישה חופשית, כלומר StatsdEventMetricPostProcessor מעבד מידע שמעבד מדדי אירועים בדוחות של נתונים סטטיסטיים לצמדי מפתח/ערך, באמצעות הפונקציה שהוגדרו במעבד.  StatsdgenerativePostProcessor מעבד מידע (post-מעבד) שמעבד דוחות סטטיסטיים בינאריים מסוג אב-ערך לצמדי מפתח-ערך, על-ידי הרחבת הפונקציה בתור מבנה עץ.  StreamProtoresultReporter (דוח תוצאות של סטרימינג) הטמעה של ProtoResultReporter SubProcess ResultsReporter (דיווח על תוצאות בתהליך משנה) נעשה שימוש ב-ITestInvocationListener שיצוין בו כ- result_reporter ותתבצע העברה מ- לעבד את התוצאות של בדיקות, הרצות בדיקה והפעלות של בדיקות.  SuiteresultsReporter אוספים תוצאות בדיקה להפעלת החבילה כולה ומפיקים את התוצאות הסופיות.  TextresultsReporter (דיווח על תוצאות טקסט) כתבי תוצאות בדיקה שמעבירים את התוצאות למדפסת תוצאות הטקסט של JUnit.  TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות מעקב cmd, ומתעד אותם בהפעלה.  XmlFormattedGeneratorReporter הטמעת ה-FormattedGeneratorReporter שפורמט החבילה מוביל לקובץ xml הפורמט.  XmlProductReporter כותבת תוצאות של JUnit לקובצי XML בפורמט שתואם ל- XMLJUnitProductProductter של המפענח.

---

ל-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) במקרים מסוימים היומן צריך להיות משויך באופן הדוק למקרי הבדיקה, אבל אפשר לעשות זאת כך גם בקישור הישיר 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)

במקרים מסוימים היומן צריך להיות משויך באופן הדוק למקרי הבדיקה, אבל אפשר לעשות זאת כך גם בקישור הישיר 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 כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה.
logFile	LogFile: ה-LogFile שמכיל את המטא-נתונים של הקובץ שנשמר.