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

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

מאזין שמצורף לכל IRemoteTest של כל מודול כדי לאסוף את רשימת התוצאות.

סיכום

יוצרים ציבוריים
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` ה-constructor.

שיטות ציבוריות
`boolean`	`hasLastAttemptFailed()` הפונקציה מחזירה אם ניסיון הניסיון האחרון של המאזין נכשל או לא.
`void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן הדוק למקרים של בדיקות, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` מגדיר אם הניסיון ידווח כאירוע בודד או לא.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` ההגדרה קובעת אם אנחנו אוספים רק את הבדיקות או לא.
`void`	`setMarkTestsSkipped(boolean skip)` האם לסמן את כל תרחישי הבדיקה שנדחו.
`void`	`setTestMappingSources( testMappingSources)` הגדרת מקורות למיפוי בדיקות שיתווספו למדדים.
`void`	`testAssumptionFailure(TestDescription test, String trace)` הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` חלופה ל-`ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, שבה אפשר לציין את שעת הסיום ישירות.
`void`	`testEnded(TestDescription test, testMetrics)` דיווח על סיום הביצוע של מקרה בדיקה ספציפי.
`void`	`testFailed(TestDescription test, FailureDescription failure)` דיווח על כשל של מקרה בדיקה ספציפי.
`void`	`testFailed(TestDescription test, String trace)` דיווח על כשל במקרה בדיקה ספציפי.
`void`	`testIgnored(TestDescription test)` נשלחת קריאה כאשר לא תבוצע בדיקה, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, runMetrics)` דיווח על סיום הרצת הבדיקה.
`void`	`testRunFailed(FailureDescription failure)` הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-`FailureDescription`.
`void`	`testRunFailed(String errorMessage)` הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` מדווח על התחלה של הרצת בדיקה.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` דיווח על התחלת הרצה של בדיקה.
`void`	`testSkipped(TestDescription test, SkipReason reason)` מוצגת קריאה כשמדלגים על בדיקה והיא לא בוצעה מסיבה שבדרך כלל לא צפויה.
`void`	`testStarted(TestDescription test, long startTime)` חלופה ל-`testStarted(com.android.tradefed.result.TestDescription)`, שבה מציינים גם מתי הבדיקה התחילה, בשילוב עם `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` למדידה מדויקת.

יוצרים ציבוריים

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

בונה.

פרמטרים
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

שיטות ציבוריות

hasLastניסיוןנכשל

public boolean hasLastAttemptFailed ()

הפונקציה מחזירה אם ניסיון הניסיון האחרון של המאזין נכשל או לא.

החזרות
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן הדוק למקרים של בדיקות, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). כך, קריאה חוזרת (callback) מאפשרת לספק באופן מפורש שיוך חזק.

פרמטרים
`dataName`	`String`: שם הנתונים
`logFile`	`LogFile`: ה-`LogFile` שרשום ביומן קודם וצריך לשייך למקרה הבדיקה.

setלנסותIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

מגדיר אם הניסיון ידווח כאירוע בודד או לא.

פרמטרים
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

קובע אם אנחנו אוספים רק את הבדיקות או לא.

פרמטרים
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

האם לסמן את כל תרחישי הבדיקה שנדחו.

פרמטרים
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

הגדרת מקורות למיפוי בדיקות שיתווספו למדדים.

פרמטרים
`testMappingSources`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`trace`	`String`: סטאק טריי של הכישלון

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`failure`	`FailureDescription`: `FailureDescription` מתאר את הכשל ואת ההקשר שלו.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), שבה אפשר לציין את שעת הסיום ישירות. כדי לקבל מדידה מדויקת, יש לשלב את הפונקציה עם testStarted(com.android.tradefed.result.TestDescription, long).

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`endTime`	`long`: השעה שבה הסתיים הבדיקה, נמדדת באמצעות `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` של המדדים שמונפקים

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

מדווח על סיום ההפעלה של מקרה בדיקה ספציפי.

אם לא הופעל testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים מסוג מפתח/ערך שעשויים להופיע במהלך ביצוע מקרה הבדיקה.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`testMetrics`	: `ERROR(/Map)` של המדדים שמונפקים

הבדיקה נכשלה

public void testFailed (TestDescription test, 
                FailureDescription failure)

דיווח על כשל של מקרה בדיקה ספציפי.

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`failure`	`FailureDescription`: `FailureDescription` שמתאר את התקלה ואת ההקשר שלה.

testFailed

public void testFailed (TestDescription test, 
                String trace)

דיווח על כשל של מקרה בדיקה ספציפי.

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`trace`	`String`: סטאק טריי של הכישלון

התעלמות מבדיקה

public void testIgnored (TestDescription test)

נשלחת קריאה כאשר לא תבוצע בדיקה, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

פרמטרים
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

פרמטרים
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

פרמטרים
`elapsedTime`	`long`: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
`runMetrics`	: צמדי מפתח/ערך שמדווחים בסוף הרצה של בדיקה

testRunFailed

public void testRunFailed (FailureDescription failure)

הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription.

פרמטרים
`failure`	`FailureDescription`: `FailureDescription` מתאר את הכשל ואת ההקשר שלו.

testRunFailed

public void testRunFailed (String errorMessage)

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

פרמטרים
`errorMessage`	`String`: `String` מתארת את הסיבה לכשל בהפעלה.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

דיווח על התחלת הרצה של בדיקה.

פרמטרים
`name`	`String`: שם ההרצה לניסיון
`numTests`	`int`: המספר הכולל של הבדיקות בהרצה לניסיון
`attemptNumber`	`int`: מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שרצים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3.

בדיקת ההרצה

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

דיווח על התחלת הרצה של בדיקה.

פרמטרים
`name`	`String`: שם ההרצה לניסיון
`numTests`	`int`: המספר הכולל של הבדיקות בהרצה לניסיון
`attemptNumber`	`int`: מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שמוצגים כמה פעמים. ה-TryNumber כולל 0 אינדקס, והוא אמור לגדול בכל פעם שמתרחשת הפעלה חדשה. למשל, בדיקה מפורטת מתבצעת שוב 3 פעמים, והבדיקה צריכה לכלול 4 הפעלות בסך הכל תחת אותו runName, ו-TryNumber הוא בין 0 ל-3.
`startTime`	`long`: משך הזמן שבו התחילה הריצה, שנמדדת באמצעות `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

הקריאה מתבצעת כשבדיקה מועברת ולא מתבצעת מסיבה שלא צפויה בדרך כלל. המערכת תנסה לבצע שוב את הבדיקות האלה כדי להוציא לפועל כמו שצריך.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`reason`	`SkipReason`: `SkipReason`

הבדיקה התחילה

public void testStarted (TestDescription test, 
                long startTime)

חלופה ל-testStarted(com.android.tradefed.result.TestDescription), שבה מציינים גם מתי הבדיקה התחילה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`startTime`	`long`: השעה שבה התחילה הבדיקה, שנמדדת באמצעות `System.currentTimeMillis()`