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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

תתי-מחלקות עקיפות ידועות

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	האספן יחסום הגדרה מוגדרת מראש של מדד משך הזמן של הנתונים הסטטיסטיים במכשיר, ויאסוף משך החיבור של Bluetooth לכל פרופיל.
BluetoothConnectionStateCollector	האספן הזה יאסוף מדדי BluetoothConnectionStateChanged ויתעד את מצב החיבור המספר של כל פרופיל.
BluetoothConnectionSuccessRatePostProcessor	הטמעת מעבד לאחר מכן שמחשב את שיעור ההצלחה של פרופיל Bluetooth שימוש ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור של Bluetooth דוגמה למערך [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collector כדי להפעיל רישום snoop של Bluetooth HCI ב-DUT ולאסוף את היומן עבור כל בדיקה.
BugreportCollector	`ITestInvocationListener` של צדדים שלישיים שאוסף דוחות על באגים כשאירועים שניתנים להגדרה מתרחשת קריאה ל-`ITestInvocationListener#testLog` עבור הצאצאים שלו אחרי כל מתבצע איסוף של דוחות על באג.
BugreportzOnFailureCollector	איסוף דוח על באג אם מקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.
ClangCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך את Clang של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	אפליקציית handler עוזרת לעקוב אחרי סטטוס ההפעלה ולעדכן אותה.
ConditionFailureMonitor	לעקוב אחרי כשלים בהפעלה.
ConsoleמוצאReporter	כתב התוצאות ידפיס את תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה ודיווח על מספר מקרי הבדיקה של `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	Collector שיאסוף את היומנים בצד המארח וירשום אותם ביומן כאשר מתרחש כשל בתרחיש בדיקה.
DeviceReleaseReporter	הכלי לדיווח על הפצה של מכשירים שמטפל בתקשורת עם ההורה מתבצע עיבוד של המכשירים שוחרר.
DeviceTraceCollector	אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.
DeviceUnavailableMonitor	ה-listener הזה מנסה לתעד DNAE ברמת תרחיש הבדיקה בלבד.
EventsLoggerListener	ה-listener שמתעד בקובץ את כל האירועים שהוא מקבל.
FileProtoClaimReporter	כתב אב שמוסיף את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמזהה מפתח מדדים שמגיע מהמכשיר ומושך כקובץ מהמכשיר.
FilePullerLogCollector	יומן הרישום של הקובץ שדווח בצד המכשיר.
FilteredresultsForwarder	וריאנט של `ResultForwarder` שמאפשר להגדיר רק רשימת היתרים של `TestDescription` דווחו.
FormattedGeneratorReporter	כתב שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך gcov של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
GcovKernelCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך ליבה (kernel) של gcov מדידות של הכיסוי מתוך ניפוי באגים ומחוץ למכשיר, ואז הן מתועדות כבדיקה. ארטיפקטים.
GranularRetriableTestWrapper.StartEndCollector	עוזר/ת בכיתה לזהות נקודות התחלה וסיום חסרות לריצה.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדים סטטיסטיים מהצד המארח באמצעות נתונים סטטיסטיים פקודות.
ICommandScheduler.IScheduledInvocationListener	האזנה לאירועי הפעלה בסיום ההפעלה.
ILogSaverListener	ל-`ITestInvocationListener` תהיה אפשרות להאזין מתי קובצי יומן נשמרים.
IMetricCollector	הממשק הזה יתווסף כעיצוב בזמן דיווח על תוצאות הבדיקה כדי לאסוף מדדים תואמים.
IPostProcessor	השירות 'מעבדי פוסט' הוא אובייקט של איחוד שירותי הסחר, שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ודיווח על התוצאות לפני הבדיקה.
IShardableListener	`ITestInvocationListener` שאפשר לפיצול.
תוצאות ISupportGranular	ממשק שמציין אם `ITestInvocationListener` תומך בקבלת הנתונים המפורטים או לא.
ITestSummaryListener	ממשק שמאפשר ל-`ITestInvocationListener` לשלוח ולקבל מידע מוגבל דרך עם סיכומים.
InvocationToJUnitUnitProcesser	כיתה שמקשיבה לאירועים של `ITestInvocationListener` ומעבירה אותם `TestListener`.
JarHostTest.HostTestListener	Wrapper שמעביר את כל האירועים מלבד testRunStarted() ו-testRunEnded() אל המוטמעים של ה-listener.
JavaCodeCoverCollector	`BaseDeviceMetricCollector` שיאחזר את Java של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
JsonHttpTestresultsReporter	כתב תוצאות שמקודד תוצאות של מדדי בדיקה והסתעפות, פרטי מכשיר ל-JSON ו-POST בנקודת קצה של שירות HTTP
LUCIתוצאהReporter	כתב תוצאות ששומר את תוצאות הבדיקה שנדרשות על ידי resultDB ו-LUCI בפורמט JSON (go/result-sink) ורושם את מיקום הקובץ במסוף.
LastShardDetector	בעת הפעלת פיצול מקומי, לפעמים אנחנו רוצים לבצע חלק מהפעולות רק לאחר הפיצול האחרון מגיע אל `invocationEnded(long)`.
LegacySubprocess ResultsReporter (דיווח על התוצאות של תהליכים שעברו תהליכים קודם)	הטמעה קפואה של דיווח התוצאות של תהליך המשנה שאמורה להיות תואמת גרסאות קודמות של TF/CTS (למשל 8+ ), למרות שינויים במחלקה-העל.
LogSaverתוצאהForwarder	`ResultForwarder` לשמירת יומנים באמצעות שומר הקבצים הגלובלי.
LogcatCrashresultForwarder	האזנה מיוחדת: בכשלים (תהליך האינסטרומנטציה קורס) הוא ינסה לחלץ קובץ ה-Logcat של הקריסה ומוסיף אותה להודעת הכשל שמשויכת לבדיקה.
LogcatOnFailureCollector	Collector שיתעד וירשום ביומן Logcat כשמקרה בדיקה נכשל.
LogcatTimingMetricCollector	כלי לאיסוף מדדים שאוסף פרטי תזמון (למשל, זמן המעבר של המשתמש) מ-Logcat במהלך בדיקה חוזרת אחת או יותר על ידי שימוש בתבניות ביטויים רגולריים (regex) כדי לנתח אותות התחלה וסיום של אירוע משורות Logcat.
MetricFilePostProcessor	משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה וההרצה.
MetricsXMLתוצאהReporter	MetricsXMLתוצאהReporter כותבת מדדי בדיקה ומריצים מדדים בקובץ XML בתיקייה שצוינה לפי פרמטר תיקיית המדדים בשלב invocationEnded של הבדיקה.
ModuleListener	ה-listener מצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את הרשימה של תוצאות.
ModuleLogcatCollector	גרסת אספן Logcat, אבל למודול.
NameMangleListener	אוזן שרת proxy לתרגום שמות של שיטות בדיקה, מחלקות וחבילות, כפי שהתוצאות מדווחות.
PassingTestFileReporter ( PassingTestFileReporter)	`ITestInvocationListener` ששומר בקובץ בדיקה את רשימת מקרי הבדיקה שעברו.
PerfettoGeneralPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של טקסט/מדד בינארי לצמדי מפתח/ערך באמצעות מרחיב באופן רקורסיבי את ההודעות והשדות של הפרוטו עם ערכי מחרוזות עד לשדה עם המערכת נתקלה בערך מספרי.
PerfettoPullerMetricCollector	ההטמעה הבסיסית של `FilePullerDeviceMetricCollector` שמאפשרת שולפת את הקבצים הקבועים מהמכשיר ואוספת ממנו את המדדים.
PrettyTestEventLogger	רישום ביומן של התאמה לאירועים ורישום שלהם ביומן כדי להקל על ניפוי הבאגים.
ProtoresultsReporter	כתב התוצאות יבנה אב-טיפוס של `TestRecord` שכולל את כל התוצאות.
PythonBinaryHostTest.PythonForwarder	כלי להעברת התוצאות שיחליף את שם ההרצה בשם הבינארי.
להפעיל מחדש את האסיסטנט	אוסף שאוסף הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהן לפי סיבה וספירה.
remoteTestTimeOutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה מסוימת ולהיכשל אם היא מצליחה על פני זמן קצוב נתון.
ReportPassedTests	דיווח בקובץ מסננים אפשריים כדי לא לכלול את הבדיקה שעברה בהצלחה.
צבירת תוצאות	העברה מיוחדת שצוברת את התוצאות במקרה הצורך, על סמך אסטרטגיית הניסיונות החוזרים נלקחו.
resultAndLogForwarder	העברה לאירועים ולתוצאות ביומנים.
תוצאה להעברה	`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
RetryLogSaverתוצאהForwarder	העברה שמטפלת גם במעבר של הניסיון הנוכחי שאנחנו נמצאים בו.
RetryתוצאהForwarder	תוסף של `ResultForwarder` שתמיד נדחף למספר ניסיון נתון.
RuntimeResumeCollector	אוסף שאוסף חותמות זמן של הפעלות מחדש של סביבת זמן הריצה (קריסות של שרת המערכת) במהלך הבדיקה להפעיל, אם בכלל.
ScreenshotOnFailureCollector	Collector שיצלם ויתעד צילום מסך כשמקרה בדיקה ייכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מפיצול הפעלה (כלומר הפעלה של כמה משאבים במקביל), ומעבירה אותם לאחד מהמשאבים Listener.
ShardMainתוצאהForwarder	`ResultForwarder` שמשלבת את התוצאות של הפעלות בדיקה מפוצלות.
ShowmapPullerMetricCollector	הטמעת הבסיס של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את מפת התוכנית קבצים מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד מידע שמעבד מדדי מדידה שנאספו בשיטת 'לפני/אחרי' גישה חופשית, כלומר
StatsdEventMetricPostProcessor	מעבד מידע שמעבד מדדי אירועים בדוחות של נתונים סטטיסטיים לצמדי מפתח/ערך, באמצעות הפונקציה שהוגדרו במעבד.
StatsdgenerativePostProcessor	מעבד מידע (post-מעבד) שמעבד דוחות סטטיסטיים בינאריים מסוג אב-ערך לצמדי מפתח-ערך, על-ידי הרחבת הפונקציה בתור מבנה עץ.
StreamProtoresultReporter (דוח תוצאות של סטרימינג)	הטמעה של `ProtoResultReporter`
SubProcess ResultsReporter (דיווח על תוצאות בתהליך משנה)	נעשה שימוש ב-`ITestInvocationListener` שיצוין בו כ- result_reporter ותתבצע העברה מ- לעבד את התוצאות של בדיקות, הרצות בדיקה והפעלות של בדיקות.
SuiteresultsReporter	אוספים תוצאות בדיקה להפעלת החבילה כולה ומפיקים את התוצאות הסופיות.
TestTimeoutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של תרחיש בדיקה נתון ולהיכשל אם הוא מצליח על פני זמן קצוב נתון.
TextresultsReporter (דיווח על תוצאות טקסט)	כתבי תוצאות בדיקה שמעבירים את התוצאות למדפסת תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות מעקב cmd, ומתעד אותם בהפעלה.
TradeifiedSandboxRunner.StubScheduledInvocationListener	דוגמית `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	הטמעת ה-`FormattedGeneratorReporter` שפורמט החבילה מוביל לקובץ xml הפורמט.
XmlProductReporter	כותבת תוצאות של JUnit לקובצי XML בפורמט שתואם ל- XMLJUnitProductProductter של המפענח.

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

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

invocationStarted(BuildInfo)
בדיקת ההרצה
הבדיקה התחילה
[testנכשל]
הבדיקה הסתיימה
...
הבדיקה הסתיימה
...
בדיקת ההרצה
...
הבדיקה הסתיימה
[ההפעלה נכשלה]
[testLog+]
ההפעלה הסתיימה
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

ההפעלה הסתיימה

public void invocationEnded (long elapsedTime)

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

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

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

ההפעלה נכשלה

public void invocationFailed (FailureDescription failure)

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

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

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

ההפעלה נכשלה

public void invocationFailed (Throwable cause)

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

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

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

ההפעלה הופסק

public void invocationInterrupted ()

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

המערכת דילגה על ההפעלה

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

פרמטרים
`reason`	`SkipReason`

ההפעלה התחילה

public void invocationStarted (IInvocationContext context)

מדווח על התחלת ההפעלה של הבדיקה.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation. המדווחים צריכים לשנות את ברירת המחדל בשיטה הזאת, יש תמיכה בדיווח על כמה מכשירים.

פרמטרים
`context`	`IInvocationContext`: מידע על ההפעלה

testModuleEnded

public void testModuleEnded ()

מדווח על סיום הרצת מודול.

TestModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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