TestRunResult

public class TestRunResult
extends Object

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

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

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

לא בטוח למספר שרשורים (thread-safe)! צריך לקרוא להודעות החזרה (callbacks) של test* בסדר

סיכום

שדות

public static final String ERROR_DIVIDER

קונסטרוקטורים גלויים לכולם

TestRunResult()

יוצרים TestRunResult ריק.

שיטות ציבוריות

getCompletedTests()

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

long getElapsedTime()

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

int getExpectedTestCount()

הפונקציה מקבלת את מספר מקרי הבדיקה שצפויים להיות ב-TestRunResult.

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.

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

קונסטרוקטורים גלויים לכולם

TestRunResult

public TestRunResult ()

יוצרים TestRunResult ריק.

שיטות ציבוריות

getCompletedTests

public  getCompletedTests ()

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

החזרות

getElapsedTime

public long getElapsedTime ()

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

החזרות
long

getExpectedTestCount

public int getExpectedTestCount ()

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

החזרות
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) של מדדי הרצה של הבדיקה בפורמט ה-proto החדש.

getStartTime

public long getStartTime ()

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

החזרות
long

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 אם הרצת הבדיקה נכשלה.

מזג

public static TestRunResult merge ( testRunResults)

פרמטרים
testRunResults

החזרות
TestRunResult

מזג

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