ITestInvocationListener | Android Open Source Project

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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

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

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostHProcessor , Bugrez Collector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener ו -73 אחרים .

AggregatePostProcessor	צובר מדדים שנותן את המינימום, המקסימום, הממוצע, השונות, סטיית התקן, סך הכל, הספירה ואחוזונים אופציונליים עבור מדדים מספריים שנאספו במהלך ריצות בדיקה מרובות איטרציות, ומתייחס אליהם ככפולים.
AtraceCollector	`IMetricCollector` שמריץ atrace במהלך בדיקה ואוסף את התוצאה ומחבר אותם ל-invocation.
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	הטמעת postprocessor שמחשב את אחוזי ההצלחה עבור פרופיל Bluetooth השתמש ב-"metric-key-match" כדי לציין מדדים המכילים מצבי חיבור Bluetooth בדוגמה של מערך מספרי [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	אספן כדי לאפשר רישום סנופ של Bluetooth HCI ב-DUT ולאסוף את היומן עבור כל בדיקה.
BugreportCollector	`ITestInvocationListener` עובר דרך שאוסף דיווחי באגים כאשר מתרחשים אירועים הניתנים להגדרה ולאחר מכן קורא `ITestInvocationListener#testLog` על הילדים שלו לאחר איסוף כל דוח באג.
BugreportzOnFailureCollector	אסוף דיווח באג כאשר מקרה מבחן נכשל.
BugreportzOnTestCaseFailureCollector	אסוף דיווח באג כאשר מקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך מדידות כיסוי Clang מהמכשיר וירשום אותן כחפצי בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	מטפל עוזר לנטר ולעדכן את סטטוס הפניה.
ConditionFailureMonitor	עקוב אחר כשלים מההפניה.
ConsoleResultReporter	כתב תוצאות כדי להדפיס את תוצאות הבדיקה למסוף.
CountTestCasesCollector	ספור ודווח על מספר מקרי הבדיקה עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	אספן שיאסוף וירשום את היומנים בצד המארח כאשר מתרחש כשל של מקרה בדיקה.
DeviceReleaseReporter	כתב שחרור מכשיר המטפל בתקשורת עם תהליך ההורה את המכשיר/ים שיש לשחרר.
DeviceTraceCollector	אספן שיתחיל מעקב פרפטו כשתתחיל ריצת בדיקה וקובץ מעקב יומן בסוף.
DeviceUnavailableMonitor	מאזין זה מנסה ללכוד DNAE ברמת מקרה בדיקה בלבד.
EventsLoggerListener	מאזין שמתעד את כל האירועים שהוא מקבל לקובץ
FileProtoResultReporter	כתב פרוטו שמטיל את ה- `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמאזין למפתח מדדים המגיע מהמכשיר ומושך אותם כקובץ מהמכשיר.
FilePullerLogCollector	לוגר של הקובץ שדווח על ידי צד המכשיר.
FilteredResultForwarder	וריאנט של `ResultForwarder` המאפשר רק לדווח על רשימת היתרים של `TestDescription` .
FormattedGeneratorReporter	כתב המאפשר להפיק דוחות בפורמט מסוים.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך מדידות כיסוי gcov מהמכשיר וירשום אותם כחפצי בדיקה.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך מדידות כיסוי ליבת gcov מתוך באגפים ומחוץ למכשיר, ואז לבסוף ירשום אותם כחפצי בדיקה.
GranularRetriableTestWrapper.StartEndCollector	עוזר כיתה לתפוס ריצה חסרה התחלה וסיום.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדי statsd מהצד המארח באמצעות פקודות השירות statsd.
ICommandScheduler.IScheduledInvocationListener	מאזין לאירועי קריאה כאשר ההתקשרות מסתיימת.
ILogSaverListener	מאפשר ל- `ITestInvocationListener` להאזין כאשר קבצי יומן נשמרים.
IMetricCollector	ממשק זה יתווסף כמעצב בעת דיווח על תוצאות בדיקות על מנת לאסוף מדדים תואמים.
IPostProcessor	Post Processers הוא אובייקט של 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)` .
מדור קודם SubprocessResultsReporter	יישום קפוא של מדווח תוצאות המשנה שאמור להישאר תואם לגרסאות קודמות של TF/CTS (למשל 8+), למרות שינויים במחלקת העל שלו.
LogSaverResultForwarder	`ResultForwarder` לשמירת יומנים עם שומר הקבצים הגלובלי.
LogcatCrashResultForwarder	מאזין מיוחד: בכשלים (קריסת תהליך המכשור) הוא ינסה לחלץ מה-logcat את הקריסה ויוסיף אותו להודעת הכשל הקשורה לבדיקה.
LogcatOnFailureCollector	אספן שילכוד ויועד logcat כאשר מקרה בדיקה נכשל.
LogcatTimingMetricCollector	אספן מדדים שאוסף מידע תזמון (למשל זמן החלפת משתמש) מ-logcat במהלך בדיקה חוזרת אחת או מרובות על ידי שימוש בתבניות רגקס נתונות כדי לנתח אותות התחלה וסיום של אירוע משורות logcat.
MetricFilePostProcessor	משמש להעלאת קובץ יומן המדדים שנאסף במהלך רמת הבדיקה והריצה.
MetricsXMLResultReporter	MetricsXMLResultReporter כותב מדדי בדיקה ומריץ מדדים לקובץ XML בתיקייה שצוינה על ידי פרמטר metrics-folder בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין מצורף לכל `IRemoteTest` של כל מודול על מנת לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסה של אספן logcat אבל עבור מודול.
NameMangleListener	מאזין פרוקסי לתרגום שיטות בדיקה, מחלקות וחבילות כפי שמדווחות התוצאות.
PassingTestFileReporter	`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה העוברים לקובץ בדיקה
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו טקסט/מטרי בינארי לצמדי מפתח-ערך על ידי הרחבה רקורסיבית של הודעות הפרוטו והשדות עם ערכי מחרוזת עד להיתקל בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	יישום בסיס של `FilePullerDeviceMetricCollector` המאפשר משיכת קבצי הפרפטו מהמכשיר ואיסוף המדדים ממנו.
PrettyTestEventLogger	לוגר התאמת האירועים ורישום אותם על מנת להקל על ניפוי הבאגים.
ProtoResultReporter	כתב תוצאות בנה פרוטובוף `TestRecord` עם כל התוצאות בפנים.
PythonBinaryHostTest.PythonForwarder	מעביר תוצאות כדי להחליף את שם הריצה בשם הבינארי.
RebootReasonCollector	אספן שאוסף אתחול מחדש של המכשיר במהלך הפעלת הבדיקה ומדווח עליהם לפי סיבה וספירות.
RemoteTestTimeOutEnforcer	מאזינים המאפשרים לבדוק את זמן הביצוע של תצורת בדיקה נתונה ולהכשל בה אם היא עוברת זמן קצוב נתון.
ReportPassedTests	דווח בקובץ על מסננים אפשריים כדי לא לכלול מבחן שעבר.
ResultAggregator	משלח מיוחד שמגבש את התוצאות בעת הצורך, בהתבסס על אסטרטגיית הניסיון החוזר שננקטה.
ResultAndLogForwarder	משלח לתוצאות ואירועי יומן.
ResultForwarder	`ITestInvocationListener` המעביר את תוצאות ההתקשרות לרשימה של מאזינים אחרים.
RetryLogSaverResultForwarder	משלח שמטפל גם בהעברת הניסיון הנוכחי בו אנו נמצאים.
RetryResultForwarder	הרחבה של `ResultForwarder` שתמיד דוחפת למספר ניסיון נתון.
RuntimeRestartCollector	אספן שאוסף חותמות זמן של הפעלה מחדש של זמן ריצה (קריסת שרת מערכת) במהלך ריצת הבדיקה, אם בכלל.
צילום מסךOnFailureCollector	אספן שיצלם ויועד צילום מסך כאשר מקרה מבחן נכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מ-Shard (הידוע גם בשם פיצול הזמנה להפעלה על מספר משאבים במקביל), ומעביר אותם למאזין אחר.
ShardMainResultForwarder	`ResultForwarder` המשלב את התוצאות של קריאות בדיקה מפוצלות.
הצג מפהPullerMetricCollector	יישום בסיס של `FilePullerDeviceMetricCollector` המאפשר משיכת קבצי ה-showmap מהמכשיר ואיסוף המדדים ממנו.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט המעבד מדדי מד הנאספים בגישת "לפני/אחרי", כלומר
StatsdEventMetricPostProcessor	מעבד לאחר המעבד מדדי אירועים בדוחות סטטיסטיים לזוגות מפתח-ערך, תוך שימוש בפורמטים שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט המעבד דוחות פרוטו סטטיסטיים בינאריים לזוגות מפתח-ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	יישום של `ProtoResultReporter`
SubprocessResultsReporter	מיישמת `ITestInvocationListener` שיצוין כ-Result_reporter ומעבירה מתהליך התוצאות של בדיקות, ריצות בדיקה, קריאות בדיקה.
SuiteResultReporter	אסוף תוצאות בדיקה עבור הזמנה של חבילה שלמה והוציא את התוצאות הסופיות.
TestFailureListener	מאזין נהג לנקוט בפעולה כגון צילום מסך, דיווח באג, איסוף logcat בעת כשל בבדיקה כאשר התבקש.
TestTimeoutEnforcer	מאזינים המאפשרים לבדוק את זמן הביצוע של מקרה בדיקה נתון ולהכשל בו אם הוא עובר פסק זמן נתון.
TextResultReporter	כתב תוצאות בדיקה המעביר תוצאות למדפסת תוצאות טקסט JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ורושמת אותם ל-invocation.
TradefedSandboxRunner.StubScheduledInvocationListener	סטאב `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	יישום של `FormattedGeneratorReporter` אשר פורמט את החבילה מביא לפורמט xml.
XmlResultReporter	כותב תוצאות JUnit לקובצי XML בפורמט התואם ל-XMLJUnitResultFormatter של Ant.

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

הזמנת בדיקה יכולה בעצמה לכלול ריצות בדיקה מרובות, כך שרצף השיחות יהיה

invocationStarted(BuildInfo)
testRunStarted
הבדיקה התחילה
[מבחן נכשל]
הבדיקה הסתיים
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[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)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`elapsedTime`	`long` : הזמן שחלף של הקריאה ב-ms

הפניה נכשלה

public void invocationFailed (FailureDescription failure)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

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

הפניה נכשלה

public void invocationFailed (Throwable cause)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`cause`	`Throwable` : הגורם `Throwable` לכשל

הקראה הופסקה

public void invocationInterrupted ()

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

הקריאה דילגה

public void invocationSkipped (SkipReason reason)

מדווח על הזמנה כדילוג

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

התראה התחילה

public void invocationStarted (IInvocationContext context)

מדווח על תחילת הזמנת הבדיקה.

ייקרא אוטומטית על ידי מסגרת TradeFederation. כתבים צריכים לעקוף שיטה זו כדי לתמוך בדיווח על מספר מכשירים.

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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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