ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener
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 ואיסוף היומן לכל בדיקה. 
BugreportCollector ITestInvocationListener של העברה (pass-through) שמאגדת דוחות באגים כשמתרחשים אירועים שניתן להגדיר, ולאחר מכן קוראת ל-ITestInvocationListener.testLog על הצאצאים שלה אחרי כל דוח באגים שנאסף. 
BugreportzOnFailureCollector איסוף דוח bugreportz כשמקרה בדיקה נכשל. 
BugreportzOnTestCaseFailureCollector איסוף דוח על באג כשמקרה בדיקה נכשל בהרצה. 
ClangCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדה אותן כפריטי בדיקה. 
CodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי ב-Java ובקוד מקורי, ומתעדה אותן ביומן בתור ארטיפקטים של בדיקה. 
CollectingTestListener ITestInvocationListener שיאסוף את כל תוצאות הבדיקה. 
CommandStatusHandler טיפול שעוזר לעקוב אחרי הסטטוס של קריאה ולעדכן אותו. 
ConditionFailureMonitor בודקים אם יש כשלים בהפעלה. 
ConsoleResultReporter דיווח על תוצאות כדי להדפיס את תוצאות הבדיקה במסוף. 
CountTestCasesCollector ספירה של מספר תרחישי הבדיקה ודיווח עליהם עבור IRemoteTest נתון. 
DebugHostLogOnFailureCollector אוסף את היומנים בצד המארח ומתעדה אותם כשמתרחשת כשל בתרגיל הבדיקה. 
DeviceReleaseReporter דיווח על השקת מכשיר שמטפל בתקשורת עם תהליך ההורה של המכשירים שרוצים להשיק. 
DeviceTraceCollector אוסף נתונים שיתחיל מעקב של perfetto כשהרצת הבדיקה תתחיל, וירשום את קובץ המעקב ביומן בסיום. 
DeviceUnavailableMonitor המאזין הזה מנסה לתעד DNAE ברמת מקרה הבדיקה בלבד. 
EventsLoggerListener מאזין שמתעדה ביומן את כל האירועים שהוא מקבל בקובץ. 
FileProtoResultReporter דיווח על פרוטוקול שמפיק את TestRecord לקובץ. 
FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמאזין למפתח המדדים שמגיע מהמכשיר ושולח אותם כקובץ מהמכשיר. 
FilePullerLogCollector יומן של הקובץ שדווח בצד המכשיר. 
FilteredResultForwarder וריאנט של ResultForwarder שמאפשר לדווח רק על רשימת היתרים של TestDescription. 
FormattedGeneratorReporter כלי דיווח שמאפשר ליצור דוחות בפורמט מסוים. 
GcovCodeCoverageCollector BaseDeviceMetricCollector שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה. 
GcovKernelCodeCoverageCollector BaseDeviceMetricCollector שמושך מדידות כיסוי של הליבה של gcov מ-debugfs ומהמכשיר, ולאחר מכן מתעד אותן כפריטי מידע שנוצרו במהלך הבדיקה. 
GranularRetriableTestWrapper.StartEndCollector כלי עזר לכיתה לזיהוי תחילת ריצה וסיום ריצה חסרים. 
HostStatsdMetricCollector IMetricCollector שאוסף מדדי statsd מצד המארח באמצעות פקודות השירות של statsd. 
ICommandScheduler.IScheduledInvocationListener מאזין לאירועי קריאה כשהקריאה מסתיימת. 
ILogSaverListener מאפשר ל-ITestInvocationListener להאזין לאירועים של שמירת קובצי יומנים. 
IMetricCollector הממשק הזה יתווסף כקישוט בדיווח על תוצאות הבדיקות כדי לאסוף מדדים תואמים. 
IPostProcessor עיבוד נתונים לאחר הבדיקה הוא אובייקט של Trade Federation שמאפשר עיבוד של מדדים ורשומות ביומן אחרי הבדיקה ולפני הדיווח על התוצאות. 
IShardableListener ITestInvocationListener שאפשר לפצל. 
ISupportGranularResults ממשק שמציין אם ITestInvocationListener תומך בקבלת התוצאות המפורטות או לא. 
ITestSummaryListener ממשק שמאפשר ל-ITestInvocationListener להחליף מידע מוגבל באמצעות סיכומים. 
InvocationProtoResultReporter דיווחים לאחסון מידע על שמירת נתונים במטמון ברמת ההפעלה ואת רשימת המודולים שלה 
InvocationToJUnitResultForwarder מחלקה שמקשיבה לאירועים מסוג ITestInvocationListener ומעבירה אותם ל-TestListener. 
JarHostTest.HostTestListener מאזין מעטפת שמעביר את כל האירועים, מלבד testRunStarted() ו-testRunEnded(), למאזין המוטמע. 
JavaCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי Java ומתעדה אותן כפריטי בדיקה. 
JsonHttpTestResultReporter דיווח על תוצאות שמקודד את תוצאות מדדי הבדיקה ואת הענף, פרטי המכשיר ל-JSON ושולח את ה-POST לנקודת קצה של שירות HTTP. 
LUCIResultReporter דיווח על תוצאות שמציל את תוצאות הבדיקה שנדרשות ל-ResultDB ול-LUCI בפורמט JSON‏ (go/result-sink) ומתעדה את מיקום הקובץ במסוף. 
LastShardDetector כשמריצים חלוקה לקטעים מקומית, לפעמים רוצים לבצע פעולות מסוימות רק כשהקטע האחרון מגיע ל-invocationEnded(long). 
LegacySubprocessResultsReporter הטמעה קפואה של הכלי לדיווח על תוצאות של תהליך משנה, שצריכה להישאר תואמת לגרסאות קודמות של TF/CTS (למשל 8 ואילך), למרות השינויים במחלקה האב שלו. 
LogSaverResultForwarder ResultForwarder לשמירת יומנים באמצעות שומר הקבצים הגלובלי. 
LogcatCrashResultForwarder מאזין מיוחד: במקרה של כשלים (קריסה של תהליך המדידה) הוא ינסה לחלץ מה-logcat את הנתונים של הקריסה ולהוסיף אותם להודעת הכשל שמשויכת לבדיקה. 
LogcatOnFailureCollector אוסף שיאגר logcat ויתעדה אותו ביומן כשמקרה בדיקה נכשל. 
LogcatTimingMetricCollector אוסף מדדים שאוסף מידע על תזמון (למשל, זמן המעבר של המשתמש) מ-logcat במהלך בדיקה אחת או כמה בדיקות חוזרות, באמצעות דפוסי ביטוי רגולרי נתונים כדי לנתח אותות התחלה וסיום של אירוע משורות logcat. 
MetricFilePostProcessor משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה. 
MetricsXMLResultReporter MetricsXMLResultReporter כותב מדדי בדיקה ומדדי ריצה לקובץ XML בתיקייה שצוינה על ידי הפרמטר metrics-folder בשלב invocationEnded של הבדיקה. 
ModuleListener מאזין שמצורף לכל IRemoteTest של כל מודול כדי לאסוף את רשימת התוצאות. 
ModuleLogcatCollector גרסת האוסף של logcat, אבל למודול. 
ModuleProtoResultReporter דיווח על תוצאות שמיועד לדיווח רק על התוצאות ברמת המודול. 
NameMangleListener מאזין proxy לתרגום שמות של שיטות בדיקה, כיתות וחבילות בזמן הדיווח על התוצאות. 
PassingTestFileReporter ITestInvocationListener ששומר את רשימת מקרי הבדיקה שעברו קובץ בדיקה. 
PerfettoGenericPostProcessor מעבד פוסט שממיר קובץ proto של מדד טקסט/בינארי ב-Perfetto לזוגות מפתח/ערך על ידי הרחבה רפרסיבית של הודעות ה-proto והשדות עם ערכי מחרוזות, עד שמגיעים לשדה עם ערך מספרי. 
PerfettoPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את קובצי perfetto מהמכשיר ולאסוף ממנו את המדדים. 
PrettyTestEventLogger יומן שמתאים את האירועים ומתעדים אותם כדי להקל על ניפוי הבאגים. 
ProtoResultReporter דיווח על תוצאות יוצר protobuf של TestRecord עם כל התוצאות בפנים. 
PythonBinaryHostTest.PythonForwarder מעביר תוצאות כדי להחליף את שם ההרצה בשם הבינארי. 
RebootReasonCollector אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר. 
RemoteTestTimeOutEnforcer מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה נתונה ולפסול אותה אם היא חורגת מזמן קצוב מראש. 
ReportPassedTests דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה. 
ResultAggregator שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה. 
ResultAndLogForwarder שירות העברה של תוצאות ואירועים ביומן. 
ResultDBReporter דיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB. 
ResultForwarder ITestInvocationListener שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים. 
RetryLogSaverResultForwarder שרת העברה שמטפל גם בהעברת הניסיון הנוכחי. 
RetryResultForwarder תוסף של ResultForwarder שתמיד דוחף למספר ניסיון נתון. 
RuntimeRestartCollector אגרגטור שאוסף חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה. 
ScreenshotOnFailureCollector אסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשמקרה בדיקה נכשל. 
ShardListener ITestInvocationListener שאוסף תוצאות מחלקיק של קריאה (קריאה שמפוצלת לצורך הפעלה בכמה משאבים בו-זמנית) ומעביר אותן למאזין אחר. 
ShardMainResultForwarder ResultForwarder שמאחד את התוצאות של הקריאות לבדיקה שמחולקות למקטעים. 
ShowmapPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים. 
StatsdBeforeAfterGaugeMetricPostProcessor מעבד נתונים לאחר העיבוד שמטפל במדדי מדדים שנאספים בגישה של 'לפני/אחרי', כלומר: 
StatsdEventMetricPostProcessor מעבד פוסט שממיר מדדי אירועים בדוחות של statsd לצמדי מפתח/ערך, באמצעות הפורמטרים שצוינו במעבד. 
StatsdGenericPostProcessor מעבד פוסט שממיר דוחות בינאריים של proto statsd לזוגות מפתח/ערך על ידי הרחבת הדוח כמבנה עץ. 
StreamProtoResultReporter הטמעה של ProtoResultReporter 
SubprocessResultsReporter הטמעת ITestInvocationListener כדי לציין אותו בתור result_reporter, ולהעביר מהתהליך המשני את התוצאות של הבדיקות, הפעלות הבדיקות והפעלות הבדיקה. 
SuiteResultReporter איסוף תוצאות הבדיקה של הרצת חבילה שלמה והצגת התוצאות הסופיות בפלט. 
TestRunResultListener מאזין שמאפשר לקרוא את סטטוס ההרצה הסופית של הבדיקה. 
TestTimeoutEnforcer מאזינים שמאפשרים לבדוק את זמן הביצוע של מקרה בדיקה נתון ולפסול אותו אם הוא חורג מזמן קצוב מראש. 
TextResultReporter דיווח על תוצאות בדיקה שמעביר את התוצאות למדפסת התוצאות בטקסט של JUnit. 
TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעדה אותם ביומן של ההפעלה. 
TradefedSandboxRunner.StubScheduledInvocationListener stub IScheduledInvocationListener שלא עושה כלום. 
XmlFormattedGeneratorReporter הטמעה של FormattedGeneratorReporter שמעבירה את תוצאות הבדיקה בפורמט xml. 
XmlResultReporter כתיבת תוצאות JUnit לקובצי XML בפורמט תואם ל-XMLJUnitResultFormatter של Ant. 

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

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

  • invocationStarted(BuildInfo)
  • testRunStarted
  • testStarted
  • [testFailed]
  • testEnded
  • ...
  • testRunEnded
  • ...
  • testRunStarted
  • ...
  • testRunEnded
  • [invocationFailed]
  • [testLog+]
  • invocationEnded
  • 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

invocationEnded

public void invocationEnded (long elapsedTime)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

דיווח על קריאה חלקית עקב תנאי שגיאה כלשהו.

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

דיווח על קריאה חלקית עקב תנאי שגיאה כלשהו.

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

invocationInterrupted

public void invocationInterrupted ()

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על קריאה כ'דילוג'

פרמטרים
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation. דיווחים צריכים לשנות את השיטה הזו כדי לתמוך בדיווח ממספר מכשירים.

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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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