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

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IConfigurationReceiver, IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

מחלקות משנה ישירות ידועות

‫AggregatePostProcessor, ‏ AveragePostProcessor, ‏ BluetoothConnectionSuccessRatePostProcessor, ‏ GeminiDebuggingPostProcessor, ‏ MetricFilePostProcessor, ‏ PerfettoGenericPostProcessor, ‏ PerfettoTracePostProcessor, ‏ SimpleperfProfilePostProcessor, ‏ StatsdGenericPostProcessor

AggregatePostProcessor	מצבר מדדים שמציג את הערכים הבאים: מינימום, מקסימום, ממוצע, שונות, סטיית תקן, סה"כ, ספירה ואחוזונים (אופציונלי) של מדדים מספריים שנאספו במהלך הפעלות בדיקה מרובות איטרציות, תוך התייחסות אליהם כאל מספרים ממשיים.
AveragePostProcessor	הטמעה של מעבד פוסט שחישב את הממוצע של רשימת המדדים.
BluetoothConnectionSuccessRatePostProcessor	הטמעה של מעבד שאחרי העיבוד שמחשב את שיעור ההצלחה של פרופיל Bluetooth משתמשים ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור Bluetooth במערך מספרי. דוגמה [0, 1, 2, 3, 0, 1, 2, 3].
‫GeminiDebuggingPostProcessor	מעבד פוסטים שיוצר שאילתות הנחיה לניפוי שגיאות.
MetricFilePostProcessor	הקובץ משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קבצים של מעקב perfetto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של perfetto.
SimpleperfProfilePostProcessor	מעבד פוסט שמוצא נתוני פרופיל של simpleperf ויוצר פרופיל pprof.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות בינאריים של proto statsd לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.

מחלקות משנה לא ישירות מוכרות

‫StatsdBeforeAfterGaugeMetricPostProcessor, ‏ StatsdEventMetricPostProcessor

StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד שאחרי העיבוד, שמטפל במדדי אירועים בדוחות של statsd והופך אותם לצמדי מפתח/ערך באמצעות מעצבי הפורמט שצוינו במעבד.

מחלקת הבסיס IPostProcessor שכל הטמעה צריכה להרחיב. חשוב לוודא שהשיטות של post processing נקראות לפני הדוחות של התוצאה הסופית.

סיכום

‫constructors ציבוריים
`BasePostProcessor()`

‫methods ציבוריים
`IConfiguration`	`getConfiguration()`
`final ITestInvocationListener`	`init(ITestInvocationListener listener)` שלב האתחול של מעבד הפוסט.
`final void`	`invocationEnded(long elapsedTime)` הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.
`final void`	`invocationFailed(FailureDescription failure)` הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.
`final void`	`invocationFailed(Throwable cause)` הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.
`void`	`invocationSkipped(SkipReason reason)` דיווח על הפעלה שנדלגה
`final void`	`invocationStarted(IInvocationContext context)` ‫Invocation Listeners להעברה
`final boolean`	`isDisabled()` הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל הניקוי).
`final void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`. מעדכן את השיוך של היומן לבדיקה.
`Map<String, MetricMeasurement.Metric.Builder>`	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)` כדאי להטמיע את השיטה הזו כדי לצבור מדדים ויומנים בכל הבדיקות.
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)` כדי ליצור קבוצה של מדדים חדשים מהמדדים ומהיומנים הקיימים, צריך להטמיע את השיטה הזו.
`Map<String, MetricMeasurement.Metric.Builder>`	`processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)` כדאי להטמיע את השיטה הזו כדי לבצע פוסט-פרוססינג של מדדים ויומנים מכל בדיקה.
`void`	`setConfiguration(IConfiguration configuration)` הוספת ה-`IConfiguration` שנמצא בשימוש.
`final void`	`setLogSaver(ILogSaver logSaver)` מגדירים את `ILogSaver` כדי לאפשר למטמיע לשמור קבצים.
`void`	`setUp()` אפשר לבטל את השיטה הזו במעבדי הפוסט של הילדים כדי לבצע אתחול לפני הפעלת הבדיקה.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` חלופה ל-`testEnded(TestDescription,Map)` שבה אפשר לציין את שעת הסיום ישירות.
`final void`	`testEnded(TestDescription test, Map<String, String> testMetrics)` הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.
`final void`	`testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)` חלופה ל-`testEnded(TestDescription,Map)` שבה אפשר לציין את שעת הסיום ישירות.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` הודעה על כשל במקרה בדיקה ספציפי.
`final void`	`testFailed(TestDescription test, String trace)` הודעה על כשל במקרה בדיקה ספציפי.
`final void`	`testIgnored(TestDescription test)` הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` משתמשים בשיטה הזו כדי לרשום קובץ ביומן מההטמעה של PostProcessor.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` מופעל כשיומן הבדיקה נשמר.
`final void`	`testModuleEnded()` הפונקציה מדווחת על סיום של הרצת מודול.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` האירוע הזה מדווח על תחילת ההפעלה של מודול.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` דוחות על סיום הרצת הבדיקה.
`final void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)` דוחות על סיום הרצת הבדיקה.
`final void`	`testRunFailed(FailureDescription failure)` הפעלת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-`FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` הפונקציה מדווחת על התחלה של הרצת בדיקה.
`final void`	`testRunStarted(String runName, int testCount)` בדיקת התקשרות חזרה
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` הפונקציה מדווחת על התחלה של הרצת בדיקה.
`final void`	`testRunStopped(long elapsedTime)` הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` הפונקציה מופעלת כשמדלגים על בדיקה ולא מבצעים אותה מסיבה שבדרך כלל לא צפויה.
`final void`	`testStarted(TestDescription test, long startTime)` חלופה ל-`testStarted(TestDescription)` שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם `testEnded(TestDescription,long,Map)` למדידה מדויקת.
`final void`	`testStarted(TestDescription test)` מקרי בדיקה של התקשרות חזרה

שיטות מוגנות
`void`	`cleanUp()`
`MetricMeasurement.DataType`	`getMetricType()` אפשר לבטל את השיטה הזו כדי לשנות את סוג המדד אם צריך.
`String`	`getRunName()`
`final String`	`getStackTrace()`
`final boolean`	`isTestFailed()`

‫constructors ציבוריים

BasePostProcessor

public BasePostProcessor ()

‫methods ציבוריים

getConfiguration

public IConfiguration getConfiguration ()

החזרות
`IConfiguration`

init

public final ITestInvocationListener init (ITestInvocationListener listener)

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

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

החזרות
`ITestInvocationListener`

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public final void invocationFailed (FailureDescription failure)

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

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

פרמטרים
`failure`	‫`FailureDescription`: `FailureDescription` שמתאר את הסיבה לכשל

invocationFailed

public final void invocationFailed (Throwable cause)

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

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

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

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

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

invocationStarted

public final void invocationStarted (IInvocationContext context)

‫Invocation Listeners להעברה

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

isDisabled

public final boolean isDisabled ()

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

החזרות
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

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

מעדכן את השיוך של היומן לבדיקה. אם מפעילים את ה-method הזו במהלך בדיקה, היומן שייך לבדיקה. אחרת, זה יהיה יומן הפעלה.

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

processAllTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                Map<TestDescription, Map<String, LogFile>> allTestLogs)

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

פרמטרים
`allTestMetrics`	‫`ListMultimap`: HashMultimap שבו מאוחסנים המדדים מכל בדיקה, מקובצים לפי שמות המדדים.
`allTestLogs`	‫`Map`: מפה שמאחסנת את המפה של כל בדיקה של קובצי יומן, עם מפתחות לפי שמות הנתונים שלהם, באמצעות `TestDescription` של כל בדיקה כמפתחות.

החזרות
`Map<String, MetricMeasurement.Metric.Builder>`	קבוצת המדדים החדשים שנוצרו מכל מדדי הבדיקה.

processRunMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics, 
                Map<String, LogFile> runLogs)

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

פרמטרים
`rawMetrics`	‫`HashMap`: קבוצת המדדים הגולמיים שזמינים להרצה.
`runLogs`	‫`Map`: קבוצת קובצי היומן של הרצת הבדיקה.

החזרות
`Map<String, MetricMeasurement.Metric.Builder>`	קבוצת המדדים החדשים שנוצרו מהמדדים של הריצה.

processTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, 
                HashMap<String, MetricMeasurement.Metric> testMetrics, 
                Map<String, LogFile> testLogs)

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

פרמטרים
`testDescription`	‫`TestDescription`: אובייקט TestDescription שמתאר את הבדיקה.
`testMetrics`	`HashMap`: קבוצת המדדים מהבדיקה.
`testLogs`	`Map`: קבוצת הקבצים שנרשמו במהלך הבדיקה.

החזרות
`Map<String, MetricMeasurement.Metric.Builder>`	קבוצת המדדים החדשים שנוצרו ממדדי הבדיקה.

setConfiguration

public void setConfiguration (IConfiguration configuration)

הוספת ה-IConfiguration שנמצא בשימוש.

פרמטרים
`configuration`	`IConfiguration`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.

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

setUp

public void setUp ()

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

public final 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` של המדדים שנפלטים

testEnded

public final void testEnded (TestDescription test, 
                Map<String, String> testMetrics)

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

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

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

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                Map<String, String> testMetrics)

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

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

הפונקציה הזו תופעל בין testStarted לבין testEnded.

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

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

הפונקציה הזו תופעל בין testStarted לבין testEnded.

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

testIgnored

public final void testIgnored (TestDescription test)

הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.

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

testLog

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

משתמשים בשיטה הזו כדי לרשום קובץ ביומן מההטמעה של PostProcessor.

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat.`String` הערה יכול להיות ש-dataName לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו dataName
`dataType`	‫`LogDataType`: `LogDataType` הנתונים
`dataStream`	`InputStreamSource`: `InputStreamSource` הנתונים. מיישמים צריכים להפעיל את הפונקציה createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהם סוגרים את InputStream שמתקבל בסיום. המתקשרים צריכים לוודא שמקור הנתונים נשאר נוכח ונגיש עד לסיום השיטה testLog.

testLogSaved

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

מופעל כשיומן הבדיקה נשמר.

צריך להשתמש במקומה במדיניות ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat.`String` הערה יכול להיות ש-dataName לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו dataName
`dataType`	‫`LogDataType`: `LogDataType` הנתונים
`dataStream`	`InputStreamSource`: `InputStreamSource` הנתונים. מטמיעים צריכים להפעיל את הפונקציה createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שסוגרים את InputStream שמתקבל בסיום.
`logFile`	‫`LogFile`: `LogFile` שמכיל את המטא-נתונים של הקובץ שנשמר.

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final 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`.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

פרמטרים
`errorMessage`	‫`String`: `String` תיאור הסיבה לכישלון ההרצה.

testRunStarted

public final 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 final void testRunStarted (String runName, 
                int testCount)

בדיקת התקשרות חזרה

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

testRunStarted

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

testRunStopped

public final void testRunStopped (long elapsedTime)

הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש.

TODO: currently unused, consider removing

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

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

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

testStarted

public final void testStarted (TestDescription test)

מקרי בדיקה של התקשרות חזרה

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

שיטות מוגנות

cleanUp

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

החזרות
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

החזרות
`String`

getStackTrace

protected final String getStackTrace ()

החזרות
`String`

isTestFailed

protected final boolean isTestFailed ()

החזרות
`boolean`