ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

תת-מחלקות עקיפות ידועות AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostHciSno , BugregatePostHciSno, BugreSport greportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , ConsoleResultReporter ו -48 אחרים. AggregatePostProcessor צובר מדדים שנותן את המינימום, המקסימום, הממוצע, השונות, סטיית התקן, סך הכל, הספירה ואחוזונים אופציונליים עבור מדדים מספריים שנאספו במהלך ריצות בדיקה מרובות איטרציות, ומתייחס אליהם ככפולים. AtraceCollector IMetricCollector שמריץ atrace במהלך בדיקה ואוסף את התוצאה ומחבר אותם ל-invocation. 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 הטמעת postprocessor שמחשב את אחוזי ההצלחה עבור פרופיל Bluetooth השתמש ב-"metric-key-match" כדי לציין מדדים המכילים מצבי חיבור Bluetooth בדוגמה של מערך מספרי [0, 1, 2, 3, 0, 1, 2, 3]. BluetoothHciSnoopLogCollector אספן כדי לאפשר רישום סנופ של Bluetooth HCI ב-DUT ולאסוף את היומן עבור כל בדיקה. BugreportzOnFailureCollector אסוף דיווח באג כאשר מקרה מבחן נכשל. BugreportzOnTestCaseFailureCollector אסוף דיווח באג כאשר מקרה בדיקה בהרצה נכשל. ClangCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי Clang מהמכשיר וירשום אותן כחפצי בדיקה. CollectingTestListener ITestInvocationListener שיאסוף את כל תוצאות הבדיקה. ConsoleResultReporter כתב תוצאות כדי להדפיס את תוצאות הבדיקה למסוף. CountTestCasesCollector ספור ודווח על מספר מקרי הבדיקה עבור IRemoteTest נתון. DebugHostLogOnFailureCollector אספן שיאסוף וירשום את היומנים בצד המארח כאשר מתרחש כשל של מקרה בדיקה. DeviceTraceCollector אספן שיתחיל מעקב פרפטו כשתתחיל ריצת בדיקה וקובץ מעקב יומן בסוף. EventsLoggerListener מאזין שמתעד את כל האירועים שהוא מקבל לקובץ FileProtoResultReporter כתב פרוטו שמטיל את ה- TestRecord לקובץ. FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמאזין למפתח מדדים המגיע מהמכשיר ומושך אותם כקובץ מהמכשיר. FilePullerLogCollector לוגר של הקובץ שדווח על ידי צד המכשיר. FormattedGeneratorReporter כתב המאפשר להפיק דוחות בפורמט מסוים. GcovCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי gcov מהמכשיר וירשום אותם כחפצי בדיקה. GcovKernelCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי ליבת gcov מתוך ניפוי באגים ומחוץ למכשיר ואז לבסוף ירשום אותם כחפצי בדיקה. GranularRetriableTestWrapper.StartEndCollector עוזר כיתה לתפוס ריצה חסרה התחלה וסיום. HostStatsdMetricCollector IMetricCollector שאוסף מדדי statsd מהצד המארח באמצעות פקודות השירות statsd. IMetricCollector ממשק זה יתווסף כמעצב בעת דיווח על תוצאות בדיקות על מנת לאסוף מדדים תואמים. IPostProcessor Post Processers הוא אובייקט של Trade Federation שנועד לאפשר עיבוד של מדדים ויומנים לאחר הבדיקות ולפני דיווח התוצאות. JavaCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי Java מהמכשיר וירשום אותם כחפצי בדיקה. JsonHttpTestResultReporter כתב תוצאות שמקודד תוצאות מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST לנקודת קצה של שירות HTTP LUCIResultReporter כתב תוצאות ששומר את תוצאות הבדיקה הדרושות ל-ResultDB ו-LUCI בפורמט JSON (go/result-sink) ומתעד את מיקום הקובץ בקונסולה. מדור קודם SubprocessResultsReporter יישום קפוא של מדווח תוצאות המשנה שאמור להישאר תואם לגרסאות קודמות של TF/CTS (למשל 8+), למרות שינויים במחלקת העל שלו. LogSaverResultForwarder ResultForwarder לשמירת יומנים עם שומר הקבצים הגלובלי. LogcatOnFailureCollector אספן שילכוד ויועד logcat כאשר מקרה בדיקה נכשל. LogcatTimingMetricCollector אספן מדדים שאוסף מידע תזמון (למשל זמן החלפת משתמש) מ-logcat במהלך בדיקה חוזרת אחת או מרובות על ידי שימוש בתבניות רגקס נתונות כדי לנתח אותות התחלה וסיום של אירוע משורות logcat. MetricFilePostProcessor משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה והריצה. MetricsXMLResultReporter MetricsXMLResultReporter כותב מדדי בדיקה ומריץ מדדים לקובץ XML בתיקייה שצוינה על ידי פרמטר metrics-folder בשלב invocationEnded של הבדיקה. ModuleListener מאזין מצורף לכל IRemoteTest של כל מודול על מנת לאסוף את רשימת התוצאות. ModuleLogcatCollector גרסה של אספן logcat אבל עבור מודול. PerfettoGenericPostProcessor מעבד פוסט שמעבד קובץ פרוטו טקסט/מטרי בינארי לצמדי מפתח-ערך על ידי הרחבה רקורסיבית של הודעות הפרוטו והשדות עם ערכי מחרוזת עד להיתקל בשדה עם ערך מספרי. PerfettoPullerMetricCollector יישום בסיס של FilePullerDeviceMetricCollector המאפשר משיכת קבצי הפרפטו מהמכשיר ואיסוף המדדים ממנו. ProtoResultReporter כתב תוצאות בנה פרוטובוף TestRecord עם כל התוצאות בפנים. RebootReasonCollector אספן שאוסף אתחול מחדש של המכשיר במהלך הפעלת הבדיקה ומדווח עליהם לפי סיבה וספירות. ReportPassedTests דווח בקובץ על מסננים אפשריים כדי לא לכלול מבחן שעבר. ResultAggregator משלח מיוחד שמגבש את התוצאות בעת הצורך, בהתבסס על אסטרטגיית הניסיון החוזר שננקטה. ResultAndLogForwarder משלח לתוצאות ואירועי יומן. RetryLogSaverResultForwarder משלח שמטפל גם בהעברת הניסיון הנוכחי בו אנו נמצאים. RuntimeRestartCollector אספן שאוסף חותמות זמן של הפעלה מחדש של זמן ריצה (קריסת שרת מערכת) במהלך ריצת הבדיקה, אם בכלל. צילום מסךOnFailureCollector אספן שיצלם ויועד צילום מסך כאשר מקרה מבחן נכשל. ShardListener ITestInvocationListener שאוסף תוצאות מ-Shard (הידוע גם בשם פיצול הזמנה להפעלה על מספר משאבים במקביל), ומעביר אותם למאזין אחר. ShardMainResultForwarder ResultForwarder המשלב את התוצאות של קריאות בדיקה מפוצלות. הצג מפהPullerMetricCollector יישום בסיס של FilePullerDeviceMetricCollector המאפשר משיכת קבצי ה-showmap מהמכשיר ואיסוף המדדים ממנו. StatsdBeforeAfterGaugeMetricPostProcessor מעבד פוסט המעבד מדדי מד הנאספים בגישת "לפני/אחרי", כלומר StatsdEventMetricPostProcessor מעבד לאחר המעבד מדדי אירועים בדוחות סטטיסטיים לזוגות מפתח-ערך, תוך שימוש בפורמטים שצוינו במעבד. StatsdGenericPostProcessor מעבד פוסט המעבד דוחות פרוטו סטטיסטיים בינאריים לזוגות מפתח-ערך על ידי הרחבת הדוח כמבנה עץ. StreamProtoResultReporter יישום של ProtoResultReporter SubprocessResultsReporter מיישמת ITestInvocationListener שיצוין כ-Result_reporter ומעבירה מתהליך התוצאות של בדיקות, ריצות בדיקה, קריאות בדיקה. SuiteResultReporter אסוף תוצאות בדיקה עבור הזמנה של חבילה שלמה והוציא את התוצאות הסופיות. TextResultReporter כתב תוצאות בדיקה המעביר תוצאות למדפסת תוצאות טקסט JUnit. TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ורושמת אותם ל-invocation. 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 s יכולים לשמור קבצים נוספים באותו מיקום.

סיכום

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