החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

מחלקות משנה לא ישירות מוכרות

‫AggregatePostProcessor,‏ AndroidBuildResultReporter,‏ AtraceCollector,‏ AtraceRunMetricCollector,‏ AveragePostProcessor,‏ BaseDeviceMetricCollector,‏ BasePostProcessor,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothConnectionSuccessRatePostProcessor,‏ BluetoothHciSnoopLogCollector,‏ BugreportCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector ועוד 87 אחרים.

AggregatePostProcessor	מצבר מדדים שמציג את הערכים הבאים: מינימום, מקסימום, ממוצע, שונות, סטיית תקן, סה"כ, ספירה ואחוזונים (אופציונלי) של מדדים מספריים שנאספו במהלך הפעלות בדיקה מרובות איטרציות, תוך התייחסות אליהם כאל מספרים ממשיים.
‫AndroidBuildResultReporter	התוצאות של הבדיקה מדווחות ל-Android Build API.
AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
AtraceRunMetricCollector	הפקודה אוספת את העקבות מכל ספריית הבדיקה בספרייה הנתונה ממכשיר הבדיקה, מתעדת את ספריית הבדיקה ומבצעת עיבוד לאחר העיבוד של קובצי העקבות בספריית הבדיקה ומצטברת את המדדים.
AveragePostProcessor	הטמעה של מעבד פוסט שחישב את הממוצע של רשימת המדדים.
BaseDeviceMetricCollector	יישום בסיסי של `IMetricCollector` שמאפשר להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(DeviceMetricData)` וב-`onTestRunEnd(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 עבור HCI של Bluetooth במכשיר הנבדק ולאסוף את היומן לכל בדיקה.
BugreportCollector	‫`ITestInvocationListener` מסוג pass-through שאוסף דוחות על באגים כשמתרחשים אירועים שאפשר להגדיר, ואז קורא ל-`ITestInvocationListener.testLog` ברכיבי הצאצא שלו אחרי שכל דוח על באג נאסף.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך מדידות של כיסוי Java וכיסוי מקורי מהמכשיר וירשום אותן כארטיפקטים של בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	רכיב Handler שעוזר לעקוב אחרי סטטוס ההפעלה ולעדכן אותו.
ConditionFailureMonitor	עוקבים אחרי כל הכשלים מההפעלה.
ConsoleResultReporter	כלי לדיווח על תוצאות, להדפסת תוצאות הבדיקה במסוף.
CountTestCasesCollector	לספור ולדווח על מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
CoverageMetadataCollector	‫`ILogSaverListener` שאוסף מדדי כיסוי שנרשמו ביומן ויוצר CoverageMetadataProto לעיבוד על ידי שירות כיסוי הקוד של Android.
DebugHostLogOnFailureCollector	אספן שיאסוף ויתעד את היומנים בצד המארח כשמתרחשת שגיאה בתרחיש בדיקה.
DeviceReleaseReporter	כלי לדיווח על שחרור מכשירים שמטפל בתקשורת עם תהליך האב של המכשירים שצריך לשחרר.
DeviceTraceCollector	כלי לאיסוף נתונים שיפעיל מעקב ב-Perfetto כשמתחילים בהרצת בדיקה, ויתעד את קובץ המעקב בסוף.
DeviceUnavailableMonitor	המאזין הזה מנסה לתעד רק DNAE ברמת תרחיש הבדיקה.
EventsLoggerListener	פונקציית listener שמתעדת את כל האירועים שהיא מקבלת בקובץ
FileProtoResultReporter	כלי ליצירת דוחות בפורמט Proto שמייצא את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמקשיב למפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
FilteredResultForwarder	וריאציה של `ResultForwarder` שמאפשרת לדווח רק על `TestDescription` שנמצאים ברשימת ההיתרים.
FormattedGeneratorReporter	כלי ליצירת דוחות שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של gcov מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
GcovKernelCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של ליבת gcov מ-debugfs ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
‫GeminiDebuggingPostProcessor	מעבד פוסטים שיוצר שאילתות הנחיה לניפוי שגיאות.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לשיעור שיעזור לכם לזהות מקרים שבהם חסרים נתוני התחלה וסיום של ריצה.
HostStatsdMetricCollector	‫`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות של כלי statsd.
ICommandScheduler.IScheduledInvocationListener	פונקציית listener לאירועי הפעלה כשההפעלה מסתיימת.
ILogSaverListener	מאפשר ל-`ITestInvocationListener` להאזין למצב שבו קובצי יומן נשמרים.
IMetricCollector	הממשק הזה יתווסף כ-decorator כשמדווחים על תוצאות של בדיקות, כדי לאסוף מדדים תואמים.
IPostProcessor	מעבדי פוסט הם אובייקט של Trade Federation שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ולפני דיווח התוצאות.
IShardableListener	`ITestInvocationListener` שאפשר לפצל.
ISupportGranularResults	ממשק שמציין אם `ITestInvocationListener` תומך בקבלת התוצאות הגרנולריות או לא.
ITestSummaryListener	ממשק שמאפשר ל-`ITestInvocationListener` להחליף מידע מוגבל באמצעות סיכומים.
InvocationProtoResultReporter	הכלי Reporters לאחסון מידע על שמירת נתונים במטמון ברמת ההפעלה ורשימת המודולים שלו
InvocationToJUnitResultForwarder	מחלקת listener שמקשיבה לאירועי `ITestInvocationListener` ומעבירה אותם אל `TestListener`.
JarHostTest.HostTestListener	פונקציית listener של Wrapper שמעבירה את כל האירועים, למעט testRunStarted()‎ ו-testRunEnded()‎, אל ה-listener המוטמע.
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 collector אבל למודול.
ModulePerfettoCollector	כלי לאיסוף נתונים שיתחיל את המעקב של perfetto כשמודול בדיקה יתחיל ויסתיים, וכשהמכשיר יופעל מחדש.
ModuleProtoResultReporter	כלי לדיווח על תוצאות שנועד לדווח רק על תוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	הרחבה של `ResultAndLogForwarder` שמוסיפה מדדים נוספים שקשורים למודול לתוצאות הבדיקה.
NameMangleListener	מאזין פרוקסי לתרגום של שמות שיטות, מחלקות וחבילות של בדיקות בזמן שהתוצאות מדווחות.
PassingTestFileReporter	‫`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה שעברו בהצלחה בקובץ בדיקה
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קבצים של מעקב perfetto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של perfetto.
PrettyTestEventLogger	הכלי Logger מתאים לאירועים ומתעד אותם כדי להקל על ניפוי הבאגים.
ProtoResultReporter	הכלי Result reporter יוצר `TestRecord` protobuf עם כל התוצאות.
PythonBinaryHostTest.PythonForwarder	העברת תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן ההרצה של הגדרת בדיקה מסוימת, ולגרום לכך שהבדיקה תיכשל אם היא חורגת מזמן קצוב לתפוגה מסוים.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגה של בדיקה שעברה.
ResultAggregator	מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שננקטה.
ResultAndLogForwarder	מעביר תוצאות ואירועים ביומן.
ResultDBReporter	כלי לדיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB.
ResultForwarder	‫`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
ResultReporter
RetryLogSaverResultForwarder	העברה שמטפלת גם בהעברת הניסיון הנוכחי שאנחנו נמצאים בו.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	אוסף שמקבל חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenRecordOnFailureCollector	כלי לאיסוף נתונים שיצלם וישמור יומן של הקלטת מסך כשמקרה בדיקה נכשל.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך ויתעד אותו ביומן כשמקרה בדיקה ייכשל.
ShardListener	‫`ITestInvocationListener` שאוסף תוצאות משבר הפעלה (כלומר, הפעלה שפוצלה כדי לפעול במקביל בכמה משאבים) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	‫`ResultForwarder` שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים.
ShowmapPullerMetricCollector	יישום בסיסי של `FilePullerDeviceMetricCollector` שמאפשר לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
SimpleperfProfilePostProcessor	מעבד פוסט שמוצא נתוני פרופיל של simpleperf ויוצר פרופיל pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד שאחרי העיבוד, שמטפל במדדי אירועים בדוחות של statsd והופך אותם לצמדי מפתח/ערך באמצעות מעצבי הפורמט שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות בינאריים של proto statsd לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	מטמיע את `ITestInvocationListener` כדי לציין אותו כ-result_reporter ולהעביר מהתהליך המשני את התוצאות של הבדיקות, הרצות הבדיקות והפעלות הבדיקות.
SuiteResultReporter	איסוף תוצאות הבדיקה עבור הפעלה של חבילה שלמה והצגת התוצאות הסופיות.
‫TestRunResultListener	פונקציית Listener שמאפשרת לקרוא את הסטטוס הסופי של הרצת הבדיקה.
TestTimeoutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן ההרצה של מקרה בדיקה מסוים ולגרום לכך שהוא ייכשל אם הוא חורג מזמן קצוב לתפוגה מסוים.
TextResultReporter	כלי לדיווח על תוצאות בדיקה שמעביר את התוצאות למדפיס תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותן ביומן של הקריאה.
TradefedSandboxRunner.StubScheduledInvocationListener	‫stub `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` באיזה פורמט התוצאות של החבילה בפורמט xml
XmlResultReporter	כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

רכיב Listener לתוצאות בדיקה מהפעלת הבדיקה.

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

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

סיכום

‫methods ציבוריים
`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)` האירוע הזה מדווח על תחילת ההפעלה של מודול.

‫methods ציבוריים

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)

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

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