החל משנת 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.

ModuleListener

public class ModuleListener
extends CollectingTestListener

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

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

סיכום

‫constructors ציבוריים
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Constructor.‎

‫methods ציבוריים
`boolean`	`hasLastAttemptFailed()` הפונקציה מחזירה את הערך True אם הניסיון האחרון של המאזין להפעיל את הסשן נכשל, ואת הערך False אם הוא הצליח.
`void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` מגדירים אם הניסיון צריך להיות מדווח כמבודד.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` הגדרה שקובעת אם אנחנו אוספים רק את הבדיקות.
`void`	`setMarkTestsSkipped(boolean skip)` האם לסמן את כל תרחישי הבדיקה כתרחישים שדילגו עליהם.
`void`	`setTestMappingSources(List<String> testMappingSources)` הגדרת מקורות למיפוי בדיקות שיוכנסו למדדים.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`void`	`testAssumptionFailure(TestDescription test, String trace)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.
`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`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> 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(TestDescription)` שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם `testEnded(TestDescription,long,Map)` למדידה מדויקת.

‫constructors ציבוריים

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Constructor.‎

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

‫methods ציבוריים

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

הפונקציה מחזירה את הערך True אם הניסיון האחרון של המאזין להפעיל את הסשן נכשל, ואת הערך False אם הוא הצליח.

החזרות
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setAttemptIsolation

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 (List<String> testMappingSources)

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

פרמטרים
`testMappingSources`	`List`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

פרמטרים
`useModuleResultsForwarder`	`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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

פרמטרים
`test`	‫`TestDescription`: מזהה את הבדיקה
`testMetrics`	`HashMap`: `Map` של המדדים שנפלטים

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`

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 numTests, 
                int attemptNumber)

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

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

testRunStarted

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

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

פרמטרים
`name`	‫`String`: השם של הרצת הבדיקה
`numTests`	‫`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()`