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

TestRunResult

public class TestRunResult
extends Object

java.lang.Object
↳	com.android.tradefed.result.TestRunResult

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

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

Not thread safe! צריך להפעיל את ההתקשרות חזרה* לבדיקה בסדר מסוים

סיכום

ערכים קבועים
`String`	`ERROR_DIVIDER`

‫constructors ציבוריים
`TestRunResult()` יוצרים `TestRunResult` ריק.

‫methods ציבוריים
`void`	`addTestResult(TestDescription test, TestResult testResult)`
`Set<TestDescription>`	`getCompletedTests()` מחזירה את קבוצת הבדיקות שהושלמו.
`long`	`getElapsedTime()` הפונקציה מחזירה את משך הזמן שחלף מההפעלה הנוכחית.
`int`	`getExpectedTestCount()` מחזירה את מספר מקרי הבדיקה שהתוצאה הזו של TestRunResult צפויה להכיל.
`Set<TestDescription>`	`getFailedTests()` מחזירה את קבוצת הבדיקות שנכשלו.
`String`	`getName()`
`int`	`getNumAllFailedTests()` החזרת המספר הכולל של הבדיקות במצב כשל (נכשלו, כשל בהנחה)
`int`	`getNumCompleteTests()` מחזירה את מספר הבדיקות שהושלמו בהרצה הזו, כלומר עם סטטוס שונה מ-incomplete.
`int`	`getNumTests()` מחזירה את מספר הבדיקות בהרצה הזו.
`int`	`getNumTestsInState(TestStatus status)` מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` לצורך תאימות לסטטוסים ישנים יותר.
`Set<TestDescription>`	`getPassedTests()` הפונקציה מחזירה את קבוצת הבדיקות שעברו בהצלחה.
`FailureDescription`	`getRunFailureDescription()` הפונקציה מחזירה את תיאור הכשל בהרצה, `null` אם ההרצה לא נכשלה.
`String`	`getRunFailureMessage()` מחזירה את הודעת השגיאה של כשל בהרצה, `null` אם ההרצה לא נכשלה.
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ביומן שמשויך לתרחיש הבדיקה הזה.
`Map<String, String>`	`getRunMetrics()`
`HashMap<String, MetricMeasurement.Metric>`	`getRunProtoMetrics()`
`long`	`getStartTime()` הפונקציה מחזירה את שעת ההתחלה של הקריאה הראשונה ל-testRunStart.
`Map<TestDescription, TestResult>`	`getTestEntriesInState(Collection<TestStatus> statuses)` מחזירה את קבוצת הבדיקות בסטטוסים נתונים.
`Map<TestDescription, TestResult>`	`getTestResults()` הפונקציה מחזירה מפה של תוצאות הבדיקה.
`Set<TestDescription>`	`getTestsInState(List<TestStatus> statuses)` מחזירה את קבוצת הבדיקות בסטטוסים נתונים.
`List<TestResult>`	`getTestsResultsInState(TestStatus status)` הפונקציה מחזירה את כל `TestResult` במדינה מסוימת.
`String`	`getTextSummary()` הפונקציה מחזירה מחרוזת ידידותית למשתמש שמתארת את התוצאות.
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults)`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults, MergeStrategy strategy)` מיזוג של כמה TestRunResults עם אותו testRunName.
`void`	`resetRunFailure()` איפוס סטטוס הכשל בהרצה.
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testLogSaved(String dataName, LogFile logFile)` המידע על קובץ שנרשם ביומן מאוחסן ומשויך לתרחיש הבדיקה או להרצת הבדיקה שנמצאים בתהליך.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` ממשק חדש שמשתמש במדדי הפרוטו החדשים.
`void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` הודעה על התחלת הרצת בדיקה.
`void`	`testRunStarted(String runName, int testCount)` הודעה על התחלת הרצת בדיקה.
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

ערכים קבועים

ERROR_DIVIDER

public static final String ERROR_DIVIDER

ערך קבוע: " ====Next Error==== "

‫constructors ציבוריים

TestRunResult

public TestRunResult ()

יוצרים TestRunResult ריק.

‫methods ציבוריים

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

פרמטרים
`test`	`TestDescription`
`testResult`	`TestResult`

getCompletedTests

public Set<TestDescription> getCompletedTests ()

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

החזרות
`Set<TestDescription>`

getElapsedTime

public long getElapsedTime ()

הפונקציה מחזירה את משך הזמן שחלף מההפעלה הנוכחית.

החזרות
`long`

getExpectedTestCount

public int getExpectedTestCount ()

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

החזרות
`int`

getFailedTests

public Set<TestDescription> getFailedTests ()

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

החזרות
`Set<TestDescription>`

getName

public String getName ()

החזרות
`String`	שם הרצת הבדיקה

getNumAllFailedTests

public int getNumAllFailedTests ()

החזרת המספר הכולל של הבדיקות במצב כשל (נכשלו, כשל בהנחה)

החזרות
`int`

getNumCompleteTests

public int getNumCompleteTests ()

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

החזרות
`int`

getNumTests

public int getNumTests ()

מחזירה את מספר הבדיקות בהרצה הזו.

החזרות
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.

פרמטרים
`status`	`TestStatus`

החזרות
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

לצורך תאימות לסטטוסים ישנים יותר. במקומה, צריך להשתמש ב-method‏ getNumTestsInState(TestStatus).

פרמטרים
`ddmlibStatus`	`TestResult.TestStatus`

החזרות
`int`

getPassedTests

public Set<TestDescription> getPassedTests ()

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

החזרות
`Set<TestDescription>`

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

הפונקציה מחזירה את תיאור הכשל בהרצה, null אם ההרצה לא נכשלה.

החזרות
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

מחזירה את הודעת השגיאה של כשל בהרצה, null אם ההרצה לא נכשלה.

החזרות
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

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

החזרות
`MultiMap<String, LogFile>`

getRunMetrics

public Map<String, String> getRunMetrics ()

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

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

החזרות
`HashMap<String, MetricMeasurement.Metric>`	‫`Map` של מדדי הרצת הבדיקה בפורמט הפרוטו החדש.

getStartTime

public long getStartTime ()

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

החזרות
`long`

getTestEntriesInState

public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

מחזירה את קבוצת הבדיקות בסטטוסים נתונים.

פרמטרים
`statuses`	`Collection`

החזרות
`Map<TestDescription, TestResult>`

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

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

החזרות
`Map<TestDescription, TestResult>`

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

מחזירה את קבוצת הבדיקות בסטטוסים נתונים.

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

החזרות
`Set<TestDescription>`

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

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

פרמטרים
`status`	`TestStatus`

החזרות
`List<TestResult>`

getTextSummary

public String getTextSummary ()

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

החזרות
`String`

hasFailedTests

public boolean hasFailedTests ()

החזרות
`boolean`	‫`true` אם יש בדיקות שנכשלו או שגיאות בהרצת הבדיקה.

isRunComplete

public boolean isRunComplete ()

החזרות
`boolean`	‫`true` אם ההרצה של הבדיקה הסתיימה.

isRunFailure

public boolean isRunFailure ()

החזרות
`boolean`	‫`true` if test run failed.

מיזוג

public static TestRunResult merge (List<TestRunResult> testRunResults)

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

החזרות
`TestRunResult`

מידע נוסף:

merge(List,MergeStrategy)

מיזוג

public static TestRunResult merge (List<TestRunResult> testRunResults, 
                MergeStrategy strategy)

מיזוג של כמה TestRunResults עם אותו testRunName. אם מקרה בדיקה מופיע בכמה TestRunResults אבל יש לו תוצאות שונות (למשל, boottest-device מופעל שלוש פעמים עם התוצאה FAIL-FAIL-PASS), אנחנו משרשרים את כל עקבות המחסנית מההפעלות שנכשלו וסומכים על תוצאת ההפעלה הסופית לגבי הסטטוס, המדדים, קובצי היומן, שעת ההתחלה ושעת הסיום.

פרמטרים
`testRunResults`	‫`List`: רשימה של TestRunResult למיזוג.
`strategy`	‫`MergeStrategy`: שיטת המיזוג שאומצה למיזוג התוצאות.

החזרות
`TestRunResult`	ה-TestRunResult הסופי שמכיל את הנתונים הממוזגים מ-testRunResults.

resetRunFailure

public void resetRunFailure ()

איפוס סטטוס הכשל בהרצה.

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

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

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

setRunComplete

public void setRunComplete (boolean runComplete)

פרמטרים
`runComplete`	`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`

testEnded

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

פרמטרים
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`	`HashMap`

testEnded

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

פרמטרים
`test`	`TestDescription`
`testMetrics`	`HashMap`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

פרמטרים
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

פרמטרים
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

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

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

testRunEnded

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

ממשק חדש שמשתמש במדדי הפרוטו החדשים.

פרמטרים
`elapsedTime`	`long`
`runMetrics`	`HashMap`

testRunEnded

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

פרמטרים
`elapsedTime`	`long`
`runMetrics`	`Map`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

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

testRunFailed

public void testRunFailed (String errorMessage)

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

testRunStarted

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

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

פרמטרים
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

פרמטרים
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

פרמטרים
`test`	`TestDescription`