החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ResultAggregator

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator

מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שננקטה.

סיכום

‫constructors ציבוריים
`ResultAggregator(List<ITestInvocationListener> listeners, RetryStrategy strategy)`

‫methods ציבוריים
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` מעבירים את כל היומנים ברמת ההפעלה לדיווחים על תוצאות שלא תומכים בתוצאות מפורטות.
`void`	`invocationEnded(long elapsedTime)` הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.
`void`	`invocationSkipped(SkipReason reason)` דיווח על הפעלה שנדלגה
`void`	`invocationStarted(IInvocationContext context)` הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.
`void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`void`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` הגדרת הדיווח החדש.
`void`	`testAssumptionFailure(TestDescription test, String trace)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` חלופה ל-`testEnded(TestDescription,Map)` שבה אפשר לציין את שעת הסיום ישירות.
`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`	`testModuleEnded()` הפונקציה מדווחת על סיום של הרצת מודול.
`void`	`testModuleStarted(IInvocationContext moduleContext)` האירוע הזה מדווח על תחילת ההפעלה של מודול.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` דוחות על סיום הרצת הבדיקה.
`void`	`testRunFailed(FailureDescription failure)` הפעלת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-`FailureDescription`.
`void`	`testRunFailed(String errorMessage)` הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה.
`void`	`testRunStarted(String name, int testCount, int attemptNumber, long startTime)` הפונקציה מדווחת על התחלה של הרצת בדיקה.
`void`	`testSkipped(TestDescription test, SkipReason reason)` הפונקציה מופעלת כשמדלגים על בדיקה ולא מבצעים אותה מסיבה שבדרך כלל לא צפויה.
`void`	`testStarted(TestDescription test, long startTime)` חלופה ל-`testStarted(TestDescription)` שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם `testEnded(TestDescription,long,Map)` למדידה מדויקת.

שיטות מוגנות
`File[]`	`getEventsLogs()`

‫constructors ציבוריים

ResultAggregator

public ResultAggregator (List<ITestInvocationListener> listeners, 
                RetryStrategy strategy)

פרמטרים
`listeners`	`List`
`strategy`	`RetryStrategy`

‫methods ציבוריים

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

מעבירים את כל היומנים ברמת ההפעלה לדיווחים על תוצאות שלא תומכים בתוצאות מפורטות.

invocationEnded

public void invocationEnded (long elapsedTime)

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

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

פרמטרים
`failure`	`FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה שנדלגה

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

פרמטרים
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

הגדרת הדיווח החדש.

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

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

חלופה ל-testEnded(TestDescription,Map) שבה אפשר לציין את שעת הסיום ישירות. אפשר לשלב עם testStarted(TestDescription,long) כדי לקבל מדידה מדויקת.

פרמטרים
`test`	‫`TestDescription`: מזהה את הבדיקה
`endTime`	‫`long`: השעה שבה הבדיקה הסתיימה, נמדדת באמצעות `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `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`: דוח קריסות של הכשל

testIgnored

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`

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

דוחות על סיום הרצת הבדיקה. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

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 testCount, 
                int attemptNumber, 
                long startTime)

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

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

חלופה ל-testStarted(TestDescription) שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם testEnded(TestDescription,long,Map) למדידה מדויקת.

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

שיטות מוגנות

getEventsLogs

protected File[] getEventsLogs ()

החזרות
`File[]`