דף זה תורגם על ידי 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` שאוסף דוחות באגים כשמתרחשים אירועים שניתן להגדיר, ולאחר מכן קורא ל-`ITestInvocationListener#testLog` על הצאצאים שלו אחרי שכל דוח באגים נאסף.
BugreportzOnFailureCollector	איסוף דוח bugreportz כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף דוח על באג כשמקרה בדיקה נכשל במהלך הרצה.
ClangCodeCoverCollector	`BaseDeviceMetricCollector` שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדות אותן ביומן כפריטי בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	אפליקציית handler עוזרת לעקוב אחרי סטטוס ההפעלה ולעדכן אותה.
ConditionFailureMonitor	בודקים אם יש כשלים בהפעלה.
ConsoleResultReporter	כתב התוצאות ידפיס את תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה ודיווח על מספר מקרי הבדיקה של `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	אוסף יומנים בצד המארח ומתעדה אותם כשמתרחשת כשל בתרגיל הבדיקה.
DeviceReleaseReporter	דיווח על השקת מכשירים שמטפל בתקשורת עם תהליך ההורה של המכשירים שרוצים להשיק.
DeviceTraceCollector	אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.
DeviceUnavailableMonitor	המאזין הזה מנסה לתעד DNAE ברמת מקרה הבדיקה בלבד.
EventsLoggerListener	האזנה שמתעדת בקובץ את כל האירועים שהוא מקבל
FileProtoProductReporter	דיווח על פרוטוקול שמפיק את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמזהה את מפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	יומן הרישום של הקובץ שדווח בצד המכשיר.
FilteredResultForwarder	וריאנט של `ResultForwarder` שמאפשר לדווח רק על רשימת היתרים של `TestDescription`.
FormattedGeneratorReporter	כלי דיווח שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` שיאחזר את מדידות הכיסוי של gcov מהמכשיר ותרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
GcovKernelCodeCoverCollector	`BaseDeviceMetricCollector` שמושך מדידות כיסוי של הליבה של gcov מ-debugfs ומהמכשיר, ולאחר מכן מתעד אותן כפריטי מידע שנוצרו במהלך הבדיקה.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לכיתה לזיהוי תחילת ריצה וסיום ריצה חסרים.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדים סטטיסטיים מהצד המארח באמצעות פקודות של נתונים סטטיסטיים.
ICommandScheduler.IScheduledInvocationListener	מאזין לאירועי קריאה כשהקריאה מסתיימת.
ILogSaverListener	מאפשר ל-`ITestInvocationListener` להאזין לאירועים של שמירת קובצי יומנים.
IMetricCollector	הממשק הזה יתווסף כקישוט בדיווח על תוצאות הבדיקות כדי לאסוף מדדים תואמים.
IPostProcessor	מעבדי דואר הם אובייקט של איחוד שירותי הסחר, שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ודיווח על התוצאות.
IShardableListener	`ITestInvocationListener` שאפשר לפצל.
ISupportGranularResults	ממשק שמציין אם `ITestInvocationListener` תומך בקבלת התוצאות המפורטות או לא.
ITestSummaryListener	ממשק שמאפשר ל-`ITestInvocationListener` להחליף מידע מוגבל באמצעות סיכומים.
InvocationToJUnitResultForwarder	מחלקה שמקשיבה לאירועים מסוג `ITestInvocationListener` ומעבירה אותם ל-`TestListener`.
JarHostTest.HostTestListener	מאזין מעטפת שמעביר את כל האירועים, מלבד testRunStarted() ו-testRunEnded(), למאזין המוטמע.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` שיאחזר את מדידות הכיסוי של Java מהמכשיר ותרשום אותן כארטיפקטים של הבדיקה.
JsonHttpTestResultReporter	כתב תוצאות שמקודד תוצאות של מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST לנקודת קצה של שירות HTTP
LUCIתוצאהReporter	דיווח על תוצאות שמציל את תוצאות הבדיקה שנדרשות ל-ResultDB ול-LUCI בפורמט JSON (go/result-sink) ומתעדה את מיקום הקובץ במסוף.
LastShardDetector	כשמריצים חלוקה לקטעים מקומית, לפעמים רוצים לבצע פעולות מסוימות רק כשהקטע האחרון מגיע ל-`invocationEnded(long)`.
LegacySubprocessResultsReporter	הטמעה קפואה של הכלי לדיווח על תוצאות של תהליך משנה, שצריכה להישאר תואמת לגרסאות קודמות של TF/CTS (למשל 8 ואילך), למרות השינויים במחלקה האב שלו.
LogSaverResultForwarder	`ResultForwarder` לשמירת יומנים באמצעות שומר הקבצים הגלובלי.
LogcatCrashResultForwarder	מאזין מיוחד: במקרה של כשלים (קריסה של תהליך המדידה) הוא ינסה לחלץ מה-logcat את הנתונים של הקריסה ולהוסיף אותם להודעת הכשל שמשויכת לבדיקה.
LogcatOnFailureCollector	אוסף שיאגר logcat ויתעדה אותו ביומן כשמקרה בדיקה נכשל.
LogcatTimingMetricCollector	אוסף מדדים שאוסף מידע על תזמון (למשל, זמן המעבר של המשתמש) מ-logcat במהלך בדיקה אחת או כמה בדיקות חוזרות, באמצעות דפוסי ביטוי רגולרי נתונים כדי לנתח את אותות ההתחלה והסיום של אירוע משורות logcat.
MetricFilePostProcessor	משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה וההרצה.
MetricsXMLResultReporter	MetricsXMLתוצאהReporter כותב מדדי בדיקה ומריצים מדדים לקובץ XML בתיקייה שצוינה בפרמטר של תיקיית המדדים בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין שמצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסת אספן Logcat, אבל למודול.
ModuleProtoResultReporter	כתבי תוצאות נועדו לדווח רק על התוצאות ברמת המודול.
NameMangleListener	מאזין proxy לתרגום שמות של שיטות בדיקה, כיתות וחבילות בזמן הדיווח על התוצאות.
PassingTestFileReporter	`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה שעברו קובץ בדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שממיר קובץ proto של מדד טקסט/בינארי ב-perfetto לזוגות מפתח/ערך על ידי הרחבה רפרסיבית של הודעות ה-proto והשדות עם ערכי מחרוזות, עד שמגיעים לשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את קובצי Perfoto מהמכשיר ולאסוף ממנו את המדדים.
PrettyTestEventLogger	רישום ביומן של התאמה לאירועים ורישום שלהם ביומן כדי להקל על ניפוי הבאגים.
ProtoResultReporter	דיווח על תוצאות יוצר protobuf של `TestRecord` עם כל התוצאות בפנים.
PythonBinaryHostTest.PythonForwarder	מעביר תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
RebootReasonCollector	אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר.
remoteTestTimeOutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה נתונה ולפסול אותה אם היא חורגת מזמן קצוב מראש.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה.
ResultAggregator	שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה.
ResultAndLogForwarder	שירות העברה של תוצאות ואירועים ביומן.
ResultForwarder	`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
RetryLogSaverResultForwarder	שרת העברה שמטפל גם בהעברת הניסיון הנוכחי.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	אוסף שמאגר חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenshotOnFailureCollector	אמצעי איסוף נתונים שצילום מסך יתועד ויירשם ביומן כאשר מקרה בדיקה נכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מפיצול הפעלה (כלומר, חלוקת הפעלה להרצה במספר משאבים במקביל), ומעביר אותן למאזינים אחרים.
ShardMainתוצאהForwarder	`ResultForwarder` שמאחד את התוצאות של הקריאות לבדיקה שמחולקות למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי מפת התוכנית מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד נתונים לאחר האיסוף, שמטפל במדדי מדדים שנאספים בשיטה של 'לפני/אחרי', כלומר:
StatsdEventMetricPostProcessor	מעבד פוסט שממיר מדדי אירועים בדוחות של statsd לצמדי מפתח/ערך, באמצעות הפורמטרים שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שממיר דוחות בינאריים של proto statsd לזוגות מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoresultReporter (דוח תוצאות של סטרימינג)	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	`ITestInvocationListener` מיושם כך שיצוין כ- result_reporter, ומועבר לעיבוד המשנה בתוצאות של בדיקות, הפעלות בדיקות והפעלות של בדיקות.
SuiteresultsReporter	איסוף תוצאות הבדיקה של הרצת חבילה שלמה והצגת התוצאות הסופיות בפלט.
TestRunResultListener	מאזין שמאפשר לקרוא את סטטוס ההרצה הסופית של הבדיקה.
TestTimeoutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של מקרה בדיקה נתון ולפסול אותו אם הוא חורג מזמן קצוב מראש.
TextResultReporter	דיווח על תוצאות בדיקה שמעביר את התוצאות למדפסת התוצאות בטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעדה אותם ביומן של ההפעלה.
TradeifiedSandboxRunner.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)

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

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

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

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

invocationFailed

public void invocationFailed (Throwable cause)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

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

ההפעלה הופסקה

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` של המודול.