ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

תתי-מחלקות עקיפות ידועות 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 ולאסוף את היומן עבור כל בדיקה.  BugreportCollector ITestInvocationListener של צדדים שלישיים שאוסף דוחות על באגים כשאירועים שניתנים להגדרה מתרחשת קריאה ל-ITestInvocationListener#testLog עבור הצאצאים שלו אחרי כל מתבצע איסוף של דוחות על באג.  BugreportzOnFailureCollector איסוף דוח על באג אם מקרה בדיקה נכשל.  BugreportzOnTestCaseFailureCollector איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.  ClangCodeCoverCollector BaseDeviceMetricCollector שימשוך את Clang של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  CollectingTestListener ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.  CommandStatusHandler אפליקציית handler עוזרת לעקוב אחרי סטטוס ההפעלה ולעדכן אותה.  ConditionFailureMonitor לעקוב אחרי כשלים בהפעלה.  ConsoleמוצאReporter כתב התוצאות ידפיס את תוצאות הבדיקה במסוף.  CountTestCasesCollector ספירה ודיווח על מספר מקרי הבדיקה של IRemoteTest נתון.  DebugHostLogOnFailureCollector Collector שיאסוף את היומנים בצד המארח וירשום אותם ביומן כאשר מתרחש כשל בתרחיש בדיקה.  DeviceReleaseReporter הכלי לדיווח על הפצה של מכשירים שמטפל בתקשורת עם ההורה מתבצע עיבוד של המכשירים שוחרר.  DeviceTraceCollector אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.  DeviceUnavailableMonitor ה-listener הזה מנסה לתעד DNAE ברמת תרחיש הבדיקה בלבד.  EventsLoggerListener ה-listener שמתעד בקובץ את כל האירועים שהוא מקבל. FileProtoProductReporter כתב אב שמוסיף את TestRecord לקובץ.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמזהה מפתח מדדים שמגיע מהמכשיר ומושך כקובץ מהמכשיר.  FilePullerLogCollector יומן הרישום של הקובץ שדווח בצד המכשיר.  FilteredresultsForwarder וריאנט של ResultForwarder שמאפשר להגדיר רק רשימת היתרים של TestDescription דווחו.  FormattedGeneratorReporter כתב שמאפשר ליצור דוחות בפורמט מסוים.  GcovCodeCoverCollector BaseDeviceMetricCollector שימשוך gcov של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  GcovKernelCodeCoverCollector BaseDeviceMetricCollector שימשוך ליבה (kernel) של gcov מדידות של הכיסוי מתוך ניפוי באגים ומחוץ למכשיר, ואז הן מתועדות כבדיקה. ארטיפקטים.  GranularRetriableTestWrapper.StartEndCollector עוזר/ת בכיתה לזהות נקודות התחלה וסיום חסרות לריצה.  HostStatsdMetricCollector IMetricCollector שאוסף מדדים סטטיסטיים מהצד המארח באמצעות נתונים סטטיסטיים פקודות.  ICommandScheduler.IScheduledInvocationListener האזנה לאירועי הפעלה בסיום ההפעלה.  ILogSaverListener ל-ITestInvocationListener תהיה אפשרות להאזין מתי קובצי יומן נשמרים.  IMetricCollector הממשק הזה יתווסף כעיצוב בזמן דיווח על תוצאות הבדיקה כדי לאסוף מדדים תואמים.  IPostProcessor השירות 'מעבדי פוסט' הוא אובייקט של איחוד שירותי הסחר, שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ודיווח על התוצאות לפני הבדיקה.  IShardableListener ITestInvocationListener שאפשר לפיצול.  תוצאות ISupportGranular ממשק שמציין אם ITestInvocationListener תומך בקבלת הנתונים המפורטים או לא.  ITestSummaryListener ממשק שמאפשר ל-ITestInvocationListener לשלוח ולקבל מידע מוגבל דרך עם סיכומים.  InvocationToJUnitUnitProcesser כיתה שמקשיבה לאירועים של ITestInvocationListener ומעבירה אותם TestListener.  JarHostTest.HostTestListener Wrapper שמעביר את כל האירועים מלבד testRunStarted() ו-testRunEnded() אל המוטמעים של ה-listener.  JavaCodeCoverCollector BaseDeviceMetricCollector שיאחזר את Java של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.  JsonHttpTestresultsReporter כתב תוצאות שמקודד תוצאות של מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST בנקודת קצה של שירות HTTP LUCIתוצאהReporter כתב תוצאות ששומר את תוצאות הבדיקה שנדרשות על ידי resultDB ו-LUCI בפורמט JSON (go/result-sink) ורושם את מיקום הקובץ במסוף.  LastShardDetector בעת הפעלת פיצול מקומי, לפעמים אנחנו רוצים לבצע חלק מהפעולות רק לאחר הפיצול האחרון מגיע אל invocationEnded(long).  LegacySubprocess ResultsReporter (דיווח על התוצאות של תהליכים שעברו תהליכים קודם) הטמעה קפואה של דיווח התוצאות של תהליך המשנה שאמורה להיות תואמת גרסאות קודמות של TF/CTS (למשל 8+ ), למרות שינויים במחלקה-העל.  LogSaverתוצאהForwarder ResultForwarder לשמירת יומנים באמצעות שומר הקבצים הגלובלי.  LogcatCrashresultForwarder האזנה מיוחדת: בכשלים (תהליך האינסטרומנטציה קורס) הוא ינסה לחלץ קובץ ה-Logcat של הקריסה ומוסיף אותה להודעת הכשל שמשויכת לבדיקה.  LogcatOnFailureCollector Collector שיתעד וירשום ביומן Logcat כשמקרה בדיקה נכשל.  LogcatTimingMetricCollector כלי לאיסוף מדדים שאוסף פרטי תזמון (למשל, זמן המעבר של המשתמש) מ-Logcat במהלך בדיקה חוזרת אחת או יותר על ידי שימוש בתבניות ביטויים רגולריים (regex) כדי לנתח אותות התחלה וסיום של אירוע משורות Logcat.  MetricFilePostProcessor משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה וההרצה.  MetricsXMLתוצאהReporter MetricsXMLתוצאהReporter כותבת מדדי בדיקה ומריצים מדדים בקובץ XML בתיקייה שצוינה לפי פרמטר של תיקיית המדדים בשלב invocationEnded הבדיקה.  ModuleListener ה-listener מצורף לכל IRemoteTest של כל מודול כדי לאסוף את הרשימה של תוצאות.  ModuleLogcatCollector גרסת אספן Logcat, אבל למודול.  NameMangleListener אוזן proxy לתרגום של שיטות בדיקה, שמות של מחלקות וחבילות, ככל שהתוצאות מדווחות.  PassingTestFileReporter ( PassingTestFileReporter) ITestInvocationListener ששומר בקובץ בדיקה את רשימת מקרי הבדיקה שעברו. PerfettoGeneralPostProcessor מעבד פוסט שמעבד קובץ פרוטו של טקסט/מדד בינארי לצמדי מפתח/ערך באמצעות מרחיב באופן רקורסיבי את ההודעות והשדות של הפרוטו עם ערכי מחרוזות עד לשדה עם המערכת נתקלה בערך מספרי.  PerfettoPullerMetricCollector ההטמעה הבסיסית של FilePullerDeviceMetricCollector שמאפשרת שולפת את הקבצים הקבועים מהמכשיר ואוספת ממנו את המדדים.  PrettyTestEventLogger רישום ביומן של התאמה לאירועים ורישום שלהם ביומן כדי להקל על ניפוי הבאגים.  ProtoresultsReporter כתב התוצאות יבנה אב-טיפוס של TestRecord שכולל את כל התוצאות.  PythonBinaryHostTest.PythonForwarder כלי להעברת התוצאות שיחליף את שם ההרצה בשם הבינארי.  להפעיל מחדש את האסיסטנט אוסף שאוסף הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהן לפי סיבה וספירה.  remoteTestTimeOutEnforcer מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה מסוימת ולהיכשל אם היא מצליחה על פני זמן קצוב נתון.  ReportPassedTests דיווח בקובץ מסננים אפשריים כדי לא לכלול את הבדיקה שעברה בהצלחה.  צבירת תוצאות העברה מיוחדת שצוברת את התוצאות במקרה הצורך, על סמך אסטרטגיית הניסיונות החוזרים נלקחו.  resultAndLogForwarder העברה לאירועים ולתוצאות ביומנים.  תוצאה להעברה ITestInvocationListener שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.  RetryLogSaverתוצאהForwarder העברה שמטפלת גם במעבר של הניסיון הנוכחי שאנחנו נמצאים בו.  RetryתוצאהForwarder תוסף של ResultForwarder שתמיד נדחף למספר ניסיון נתון.  RuntimeResumeCollector אוסף שאוסף חותמות זמן של הפעלות מחדש של סביבת זמן הריצה (קריסות של שרת המערכת) במהלך הבדיקה להפעיל, אם בכלל.  ScreenshotOnFailureCollector Collector שיצלם ויתעד צילום מסך כשמקרה בדיקה ייכשל.  ShardListener ITestInvocationListener שאוסף תוצאות מפיצול הפעלה (כלומר הפעלה של כמה משאבים במקביל), ומעבירה אותם לאחד מהמשאבים Listener.  ShardMainתוצאהForwarder ResultForwarder שמשלבת את התוצאות של הפעלות בדיקה מפוצלות.  ShowmapPullerMetricCollector הטמעת הבסיס של FilePullerDeviceMetricCollector שמאפשרת לשלוף את מפת התוכנית קבצים מהמכשיר ולאסוף ממנו את המדדים.  StatsdBeforeAfterGaugeMetricPostProcessor מעבד מידע שמעבד מדדי מדידה שנאספו בשיטת 'לפני/אחרי' גישה חופשית, כלומר StatsdEventMetricPostProcessor מעבד מידע שמעבד מדדי אירועים בדוחות של נתונים סטטיסטיים לצמדי מפתח/ערך, באמצעות הפונקציה שהוגדרו במעבד.  StatsdgenerativePostProcessor מעבד מידע (post-מעבד) שמעבד דוחות סטטיסטיים בינאריים מסוג אב-ערך לצמדי מפתח-ערך, על-ידי הרחבת הפונקציה בתור מבנה עץ.  StreamProtoresultReporter (דוח תוצאות של סטרימינג) הטמעה של ProtoResultReporter SubProcess ResultsReporter (דיווח על תוצאות בתהליך משנה) נעשה שימוש ב-ITestInvocationListener שיצוין בו כמדווח התוצאה ותתבצע העברה מ: לעבד את התוצאות של בדיקות, הרצות בדיקה והפעלות של בדיקות.  SuiteresultsReporter אוספים תוצאות בדיקה להפעלת החבילה כולה ומפיקים את התוצאות הסופיות.  TestTimeoutEnforcer מאזינים שמאפשרים לבדוק את זמן הביצוע של תרחיש בדיקה נתון ולהיכשל אם הוא מצליח על פני זמן קצוב נתון.  TextresultsReporter (דיווח על תוצאות טקסט) כתבי תוצאות בדיקה שמעבירים את התוצאות למדפסת תוצאות הטקסט של JUnit.  TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות מעקב cmd, ומתועד בהם בהפעלה.  TradeifiedSandboxRunner.StubScheduledInvocationListener דוגמית IScheduledInvocationListener שלא עושה כלום.  XmlFormattedGeneratorReporter הטמעת ה-FormattedGeneratorReporter שפורמט החבילה מוביל לקובץ xml הפורמט.  XmlProductReporter כותבת תוצאות של JUnit לקובצי XML בפורמט שתואם ל- XMLJUnitProductProductter של המפענח.

---

האזנה לתוצאות הבדיקה מהפעלת הבדיקה.

הפעלה של בדיקה יכולה לכלול בעצמה כמה הפעלות בדיקה, כך שרצף הקריאות

• invocationStarted(BuildInfo)
• בדיקת ההרצה
• הבדיקה התחילה
• [testנכשל]
• הבדיקה הסתיימה
• ...
• הבדיקה הסתיימה
• ...
• בדיקת ההרצה
• ...
• הבדיקה הסתיימה
• [ההפעלה נכשלה]
• [testLog+]
• ההפעלה הסתיימה
• getSummary

סיכום

שיטות ציבוריות
default TestSummary	getSummary() מאפשר ל-InvocationListener להחזיר סיכום.
default void	invocationEnded(long elapsedTime) דיווחים שההפעלה הסתיימה, בין אם בהצלחה או בגלל שגיאה כלשהי תנאי.
default void	invocationFailed(FailureDescription failure) מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.
default void	invocationFailed(Throwable cause) מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.
default void	invocationInterrupted() קריאה לכיבוי מתזמן הבקשות, נותנת להפעלה את ההזדמנות לעשות משהו לפני תאריך סיום.
default void	invocationSkipped(SkipReason reason) דיווח על הפעלה כתוכן שדילגת עליו
default void	invocationStarted(IInvocationContext context) מדווח על התחלת ההפעלה של הבדיקה.
default void	testModuleEnded() מדווח על סיום הרצת מודול.
default void	testModuleStarted(IInvocationContext moduleContext) מדווח על תחילת המודול שפועל.

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

getSummary

public TestSummary getSummary ()

מאפשר ל-InvocationListener להחזיר סיכום.

החזרות
TestSummary	TestSummary שמסכם את הריצה, או null

ההפעלה הסתיימה

public void invocationEnded (long elapsedTime)

דיווחים שההפעלה הסתיימה, בין אם בהצלחה או בגלל שגיאה כלשהי תנאי.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
elapsedTime	long: זמן ההפעלה שחלף באלפיות השנייה

ההפעלה נכשלה

public void invocationFailed (FailureDescription failure)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
failure	FailureDescription: FailureDescription שמתאר את הסיבה לכשל

ההפעלה נכשלה

public void invocationFailed (Throwable cause)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
cause	Throwable: הסיבה Throwable לכשל

ההפעלה הופסקה

public void invocationInterrupted ()

קריאה לכיבוי מתזמן הבקשות, נותנת להפעלה את ההזדמנות לעשות משהו לפני תאריך סיום.

המערכת דילגה על ההפעלה

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

פרמטרים
reason	SkipReason

ההפעלה התחילה

public void invocationStarted (IInvocationContext context)

מדווח על התחלת ההפעלה של הבדיקה.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation. המדווחים צריכים לשנות את ברירת המחדל בשיטה הזאת, יש תמיכה בדיווח על כמה מכשירים.

פרמטרים
context	IInvocationContext: מידע על ההפעלה

testModuleEnded

public void testModuleEnded ()

מדווח על סיום הרצת מודול.

TestModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

מדווח על תחילת המודול שפועל. הקריאה החוזרת הזו משויכת ל-testModuleEnded() והיא אופציונלית ברצף. נעשה בו שימוש רק במהלך הרצה שנעשה בה שימוש מודולים של הרצה בחבילות.

פרמטרים
moduleContext	IInvocationContext: ה-IInvocationContext של המודול.