החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

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

ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder
		↳	com.android.tradefed.result.ModuleResultsAndMetricsForwarder

תוסף של ResultAndLogForwarder שמוסיף מדדים נוספים שקשורים למודול לתוצאות הבדיקה.

סיכום

קונסטרוקטורים גלויים לכולם
`ModuleResultsAndMetricsForwarder(ITestInvocationListener... listeners)`

שיטות ציבוריות
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` מגדיר אם הניסיון ידווח כאירוע בודד או לא.
`void`	`setModuleId(String moduleId)`
`void`	`setTestMappingSources( testMappingSources)` מגדיר מקורות למיפוי בדיקות שיוזנו למדדים.
`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`	`testRunEnded(long elapsedTimeMillis, runMetrics)` דיווח על סיום הרצת הבדיקה.
`void`	`testRunFailed(FailureDescription failure)` הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-`FailureDescription`.
`void`	`testRunFailed(String errorMessage)` הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` דיווח על התחלת הרצה של בדיקה.
`void`	`testRunStarted(String runName, int testCount)` דיווח על התחלת הרצה של בדיקה.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` דיווח על התחלת הרצה של בדיקה.
`void`	`testStarted(TestDescription test, long startTime)` חלופה ל-`testStarted(com.android.tradefed.result.TestDescription)` שבה מציינים גם את מועד ההתחלה של הבדיקה, בשילוב עם `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` למדידה מדויקת.
`void`	`testStarted(TestDescription test)` דיווח על התחלת מקרה בדיקה ספציפי.

קונסטרוקטורים גלויים לכולם

ModuleResultsAndMetricsForwarder

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

פרמטרים
`listeners`	`ITestInvocationListener`

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

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

setModuleId

public void setModuleId (String moduleId)

פרמטרים
`moduleId`	`String`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

מגדיר מקורות למיפוי בדיקות שיוזנו למדדים.

פרמטרים
`testMappingSources`

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)` של המדדים שמונפקים

testFailed

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`: סטאק טריי של הכישלון

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

פרמטרים
`elapsedTimeMillis`	`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 runName, 
                int testCount, 
                int attemptNumber)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

פרמטרים
`runName`	`String`: שם ההרצה לניסיון
`testCount`	`int`: המספר הכולל של הבדיקות בהרצה לניסיון

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

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

testStarted

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()`

testStarted

public void testStarted (TestDescription test)

דיווח על התחלת מקרה בדיקה ספציפי. ממשק ישן יותר, עדיף להשתמש ב-testStarted(com.android.tradefed.result.TestDescription) כשהדבר אפשרי.

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