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)
	getCompletedTests() מחזירה את קבוצת הבדיקות שהושלמו.
long	getElapsedTime() הפונקציה מחזירה את הזמן שחלף מאז ההפעלה הנוכחית.
int	getExpectedTestCount() מחזירה את מספר מקרי הבדיקה שהתוצאה הזו של הרצת הבדיקה צפויה להכיל.
	getFailedTests() מחזירה את קבוצת הבדיקות שנכשלו.
String	getName()
int	getNumAllFailedTests() החזרת המספר הכולל של הבדיקות במצב כשל (נכשלו, כשל בהנחה)
int	getNumCompleteTests() מחזירה את מספר הבדיקות שהושלמו בהרצה הזו, כלומר עם סטטוס שונה מ-incomplete.
int	getNumTests() מחזירה את מספר הבדיקות בהרצה הזו.
int	getNumTestsInState(TestStatus status) מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) לצורך תאימות לסטטוס ישן יותר.
	getPassedTests() הפונקציה מחזירה את קבוצת הבדיקות שעברו בהצלחה.
FailureDescription	getRunFailureDescription() הפונקציה מחזירה את תיאור הכשל בהרצה, null אם ההרצה לא נכשלה.
String	getRunFailureMessage() החזרת הודעת השגיאה של כשל בהרצה, null אם ההרצה לא נכשלה.
MultiMap<String, LogFile>	getRunLoggedFiles() הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ומשויך לתרחיש הבדיקה הזה.
	getRunMetrics()
	getRunProtoMetrics()
long	getStartTime() הפונקציה מחזירה את שעת ההתחלה של הקריאה הראשונה ל-testRunStart.
	getTestEntriesInState( statuses) מקבל את קבוצת הבדיקות בסטטוסים נתונים.
	getTestResults() הפונקציה מחזירה מפה של תוצאות הבדיקה.
	getTestsInState( statuses) מקבל את קבוצת הבדיקות בסטטוסים נתונים.
	getTestsResultsInState(TestStatus status) הפונקציה מחזירה את כל TestResult במדינה מסוימת.
String	getTextSummary() הפונקציה מחזירה מחרוזת ידידותית למשתמש שמתארת את התוצאות.
boolean	hasFailedTests()
boolean	isRunComplete()
boolean	isRunFailure()
static TestRunResult	merge( testRunResults)
static TestRunResult	merge( 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, testMetrics)
void	testEnded(TestDescription test, 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, 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

Constant Value: " ====Next Error==== "

Constructors ציבוריים

TestRunResult

public TestRunResult ()

יוצרים קובץ ריקTestRunResult.

‫methods ציבוריים

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

פרמטרים
test	TestDescription
testResult	TestResult

getCompletedTests

public  getCompletedTests ()

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

החזרות

getElapsedTime

public long getElapsedTime ()

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

החזרות
long

getExpectedTestCount

public int getExpectedTestCount ()

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

החזרות
int

getFailedTests

public  getFailedTests ()

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

החזרות

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)

לצורך תאימות לסטטוס ישן יותר. במקום זאת, אתם צריכים להשתמש ב-getNumTestsInState(com.android.tradefed.result.TestStatus).

פרמטרים
ddmlibStatus	TestResult.TestStatus

החזרות
int

getPassedTests

public  getPassedTests ()

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

החזרות

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

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

החזרות
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

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

החזרות
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

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

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

getRunMetrics

public  getRunMetrics ()

החזרות
	ERROR(/Map) של מדדי הבדיקה.

getRunProtoMetrics

public  getRunProtoMetrics ()

החזרות
	ERROR(/Map) של מדדי הרצת הבדיקה בפורמט הפרוטו החדש.

getStartTime

public long getStartTime ()

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

החזרות
long

getTestEntriesInState

public  getTestEntriesInState ( statuses)

מקבל את קבוצת הבדיקות בסטטוסים נתונים.

פרמטרים
statuses

החזרות

getTestResults

public  getTestResults ()

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

החזרות

getTestsInState

public  getTestsInState ( statuses)

מקבל את קבוצת הבדיקות בסטטוסים נתונים.

פרמטרים
statuses

החזרות

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

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

פרמטרים
status	TestStatus

החזרות

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

פרמטרים
testRunResults

החזרות
TestRunResult

מידע נוסף:

• ERROR(/#merge(List, MergeStrategy))

מזג

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

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

פרמטרים
testRunResults	‫: רשימה של 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, 
                 testMetrics)

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

פרמטרים
test	TestDescription
testMetrics

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, 
                 runMetrics)

פרמטרים
elapsedTime	long
runMetrics

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