החל מ-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, ועוד 81 אחרים.

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	הכלי לאיסוף נתונים ישלח למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך החיבור ב-Bluetooth לכל פרופיל.
‫BluetoothConnectionStateCollector	הכלי הזה יאסוף מדדים של BluetoothConnectionStateChanged ויתעד את מספר מצב החיבור לכל פרופיל.
BluetoothConnectionSuccessRatePostProcessor	הטמעה של מעבד שאחרי העיבוד שמחשב את שיעור ההצלחה של פרופיל Bluetooth משתמשים ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור Bluetooth במערך מספרי. דוגמה [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	כלי איסוף להפעלת רישום Snoop עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה.
BugreportCollector	רכיב `ITestInvocationListener` מסוג pass-through שאוסף דוחות על באגים כשמתרחשים אירועים שאפשר להגדיר, ואז קורא ל-`ITestInvocationListener.testLog` ברכיבי הצאצא שלו אחרי שכל דוח על באג נאסף.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java ושל קוד מקורי מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	רכיב Handler שעוזר לעקוב אחרי הסטטוס של הפעלה ולעדכן אותו.
ConditionFailureMonitor	עוקבים אחרי כל הכשלים מהקריאה.
ConsoleResultReporter	כלי לדיווח על תוצאות, להדפסת תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה ודיווח של מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
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 ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
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	מחלקה שמקשיבה לאירועים מסוג `ITestInvocationListener` ומעבירה אותם אל `TestListener`.
JarHostTest.HostTestListener	מאזין עוטף שמעביר את כל האירועים, למעט testRunStarted()‎ ו-testRunEnded()‎, אל המאזין המוטמע.
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
JsonHttpTestResultReporter	כלי לדיווח על תוצאות שמקודד את תוצאות המדדים של הבדיקה ואת פרטי הענף והמכשיר ל-JSON, ושולח אותם לנקודת קצה של שירות 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	כלי לדיווח על תוצאות שנועד לדווח רק על תוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	תוסף של `ResultAndLogForwarder` שמוסיף לממצאי הבדיקה מדדים נוספים שקשורים למודול.
NameMangleListener	מאזין פרוקסי לתרגום של שמות שיטות, מחלקות וחבילות של בדיקות בזמן הדיווח על התוצאות.
PassingTestFileReporter	`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה שעברו בהצלחה בקובץ בדיקה
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קובצי מעקב של Perfecto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של Perfecto.
PrettyTestEventLogger	הכלי Logger מתאים לאירועים ומתעד אותם כדי להקל על ניפוי הבאגים.
ProtoResultReporter	הכלי Result reporter יוצר `TestRecord` protobuf עם כל התוצאות.
PythonBinaryHostTest.PythonForwarder	העברת תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
‫RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה מסוימת, ולגרום לכך שהבדיקה תיכשל אם היא חורגת מזמן קצוב מסוים.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגה של בדיקה שעברה.
ResultAggregator	מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שנבחרה.
ResultAndLogForwarder	מעביר תוצאות ואירועים ביומן.
ResultDBReporter	כלי לדיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB.
ResultForwarder	‫`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
ResultReporter
RetryLogSaverResultForwarder	העברה שמטפלת גם בהעברת הניסיון הנוכחי שאנחנו נמצאים בו.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	כלי לאיסוף נתונים שאוסף חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשהתרחיש לבדיקה ייכשל.
ShardListener	‫`ITestInvocationListener` שאוסף תוצאות משבר הפעלה (כלומר, פיצול של הפעלה להרצה במקביל בכמה משאבים) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	‫`ResultForwarder` שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד פוסט שמעבד מדדי אירועים בדוחות statsd לצמדי מפתח/ערך, באמצעות מעצבי הפורמט שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות statsd של פרוטוקול בינארי לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	מטמיע את `ITestInvocationListener` כדי לציין אותו כ-result_reporter ולהעביר מתהליך המשנה את תוצאות הבדיקות, הרצות הבדיקות והפעלות הבדיקות.
SuiteResultReporter	איסוף תוצאות הבדיקה עבור הפעלה של חבילה שלמה והצגת התוצאות הסופיות.
TestRunResultListener	מאזין שמאפשר לקרוא את הסטטוס הסופי של הרצת הבדיקה.
TestTimeoutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן הביצוע של תרחיש בדיקה מסוים ולסמן אותו כנכשל אם הוא חורג מזמן קצוב מסוים.
TextResultReporter	כלי לדיווח על תוצאות בדיקה שמעביר את התוצאות למדפיס תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותם ביומן של הקריאה.
TradefedSandboxRunner.StubScheduledInvocationListener	פונקציית placeholder‏ `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` באיזה פורמט התוצאות של החבילה בפורמט xml
XmlResultReporter	כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

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

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

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() והיא אופציונלית ברצף. הוא נמצא בשימוש רק במהלך הרצה שמשתמשת במודולים: רצים מבוססי-חבילה.

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