דף זה תורגם על ידי 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,‏ CollectingTestListener ו-74 אחרים.

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 ומתעדה אותן כפריטי בדיקה.
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` להחליף מידע מוגבל באמצעות סיכומים.
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	שירות העברה של תוצאות ואירועים ביומן.
ResultForwarder	`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
RetryLogSaverResultForwarder	שרת העברה שמטפל גם בהעברת הניסיון הנוכחי.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	אוסף שמאגר חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenshotOnFailureCollector	אסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשמקרה בדיקה נכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מחלקיק של קריאה (קריאה שמפוצלת לצורך הפעלה בכמה משאבים בו-זמנית) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	`ResultForwarder` שמאחד את התוצאות של קריאות בדיקה מחולקות.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד נתונים לאחר האיסוף, שמטפל במדדי מדדים שנאספים בשיטה של 'לפני/אחרי', כלומר:
StatsdEventMetricPostProcessor	מעבד פוסט שממיר מדדי אירועים בדוחות של statsd לצמדי מפתח/ערך, באמצעות הפורמטרים שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שממיר דוחות בינאריים של proto statsd לזוגות מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	הטמעת `ITestInvocationListener` כדי לציין אותו בתור דיווח על תוצאות, והעברה מהתהליך המשני של תוצאות הבדיקות, הפעלות הבדיקות והפעלות הבדיקה.
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` של המודול.