החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

תת-כיתות עקיפות ידועות

AggregatePostProcessor,‏ AtraceCollector,‏ AtraceRunMetricCollector,‏ AveragePostProcessor,‏ BaseDeviceMetricCollector,‏ BasePostProcessor,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothConnectionSuccessRatePostProcessor,‏ BluetoothHciSnoopLogCollector,‏ BugreportCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector,‏ CodeCoverageCollector ו-78 אחרים.

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 collector, אבל למודול.
ModuleProtoResultReporter	דיווח על תוצאות שמיועד לדיווח רק על התוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	תוסף של `ResultAndLogForwarder` שמוסיף מדדים נוספים שקשורים למודול לתוצאות הבדיקה.
NameMangleListener	מאזין proxy לתרגום שמות של שיטות בדיקה, כיתות וחבילות בזמן הדיווח על התוצאות.
PassingTestFileReporter	`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה שעברו קובץ בדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שממיר קובץ proto של מדד טקסט/בינארי ב-perfetto לזוגות מפתח/ערך על ידי הרחבה רפרסיבית של הודעות ה-proto והשדות עם ערכי מחרוזות, עד שמגיעים לשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את קובצי perfetto מהמכשיר ולאסוף ממנו את המדדים.
PrettyTestEventLogger	יומן שמתאים את האירועים ומתעדת אותם כדי שיהיה קל יותר לנפות באגים.
ProtoResultReporter	דיווח על תוצאות יוצר protobuf של `TestRecord` עם כל התוצאות בפנים.
PythonBinaryHostTest.PythonForwarder	מעביר תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
RebootReasonCollector	אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה נתונה ולפסול אותה אם היא חורגת מזמן קצוב מראש.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה.
ResultAggregator	שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה.
ResultAndLogForwarder	שירות העברה של תוצאות ואירועים ביומן.
ResultDBReporter
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` של המודול.