ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener


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

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

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