TestRunResult

public class TestRunResult
extends Object

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

Enthält Ergebnisse eines einzelnen Testlaufs.

Erhält eine genaue Anzahl der Tests und überwacht unvollständige Tests.

Nicht threadsicher! Die Callbacks vom Typ „test*“ müssen in der richtigen Reihenfolge aufgerufen werden.

Zusammenfassung

Felder

public static final String ERROR_DIVIDER

Öffentliche Konstruktoren

TestRunResult()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

getCompletedTests()

Ruft die abgeschlossenen Tests ab.

long getElapsedTime()

Gibt die verstrichene Zeit der aktuellen Ausführung zurück.

int getExpectedTestCount()

Die erwartete Anzahl der Testfälle für dieses TestRunResult.

getFailedTests()

Ruft die fehlgeschlagenen Tests ab.

String getName()
int getNumAllFailedTests()

Die Gesamtzahl der Tests im Fehlerstatus zurückgeben (Fehlgeschlagen, Annahmefehler)

int getNumCompleteTests()

Die Anzahl der abgeschlossenen Tests in diesem Durchlauf, d. h. mit dem Status „nicht abgeschlossen“.

int getNumTests()

Die Anzahl der Tests in diesem Durchlauf.

int getNumTestsInState(TestStatus status)

Die Anzahl der Tests im angegebenen Status für diesen Durchlauf.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

FÜR KOMPATIBILITÄT mit älteren Status.

getPassedTests()

Ruft die Liste der bestandenen Tests ab.

FailureDescription getRunFailureDescription()

Gibt den Ausführungsfehlerdeskriptor null zurück, wenn die Ausführung nicht fehlgeschlagen ist.

String getRunFailureMessage()

Gibt die Fehlermeldung für den Ausführungsfehler zurück, null, wenn die Ausführung nicht fehlgeschlagen ist.

MultiMap<String, LogFile> getRunLoggedFiles()

Gibt eine Kopie der Karte zurück, die alle protokollierten Dateien enthält, die mit diesem Testfall verknüpft sind.

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

Gibt den Beginn des ersten Aufrufs von „testRunStart“ zurück.

getTestResults()

Gibt eine Zuordnung der Testergebnisse zurück.

getTestsInState( statuses)

Ruft die Gruppe von Tests mit bestimmten Statuswerten ab.

getTestsResultsInState(TestStatus status)

Gibt alle TestResult in einem bestimmten Status zurück.

String getTextSummary()

Gibt einen nutzerfreundlichen String zurück, der die Ergebnisse beschreibt.

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge( testRunResults)
static TestRunResult merge( testRunResults, MergeStrategy strategy)

Führen Sie mehrere TestRunResults desselben testRunName zusammen.

void resetRunFailure()

Setzen Sie den Fehlerstatus der Ausführung zurück.

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)

Informationen zu einer protokollierten Datei werden gespeichert und dem laufenden Testfall oder Testlauf zugeordnet.

void testRunEnded(long elapsedTime, runMetrics)
void testRunFailed(FailureDescription failureDescription)
void testRunFailed(String errorMessage)
void testRunStarted(String runName, int testCount, long startTime)

Benachrichtigung, dass ein Test gestartet wurde.

void testRunStarted(String runName, int testCount)

Benachrichtigung, dass ein Test gestartet wurde.

void testRunStopped(long elapsedTime)
void testSkipped(TestDescription test, SkipReason reason)
void testStarted(TestDescription test, long startTime)
void testStarted(TestDescription test)

Felder

FEHLER_DIVIDER

public static final String ERROR_DIVIDER

Öffentliche Konstruktoren

TestRunResult

public TestRunResult ()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

getCompletedTests

public  getCompletedTests ()

Ruft die abgeschlossenen Tests ab.

Returns

getElapsedTime (Dauer der verfallenen Zeit)

public long getElapsedTime ()

Gibt die verstrichene Zeit der aktuellen Ausführung zurück.

Returns
long

getExpectedTestCount

public int getExpectedTestCount ()

Die erwartete Anzahl der Testfälle für dieses TestRunResult. Aufgrund von Testabstürzen ist die tatsächliche Anzahl möglicherweise niedriger als die erwartete. Normalerweise weist eine solche Abweichung auf einen Fehler bei der Testausführung hin.

Returns
int

getFailedTests

public  getFailedTests ()

Ruft die fehlgeschlagenen Tests ab.

Returns

getName

public String getName ()

Returns
String den Namen der Testausführung

getNumAllFailedTests

public int getNumAllFailedTests ()

Die Gesamtzahl der Tests im Fehlerstatus zurückgeben (Fehlgeschlagen, Annahmefehler)

Returns
int

getNumCompleteTests

public int getNumCompleteTests ()

Ruft die Anzahl der vollständigen Tests in diesem Durchlauf ab, d. h. mit dem Status != complete.

Returns
int

getNumTests

public int getNumTests ()

Die Anzahl der Tests in diesem Durchlauf.

Returns
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Die Anzahl der Tests im angegebenen Status für diesen Durchlauf.

Parameter
status TestStatus

Returns
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

FÜR DIE KOMPATIBILITÄT mit älteren Status. Verwende stattdessen getNumTestsInState(com.android.tradefed.result.TestStatus).

Parameter
ddmlibStatus TestResult.TestStatus

Returns
int

getPassedTests

public  getPassedTests ()

Ruft die Liste der bestandenen Tests ab.

Returns

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Gibt den Fehlerbeschreibungstext für den Ablauf zurück, null, wenn der Ablauf nicht fehlgeschlagen ist.

Returns
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Gibt die Fehlermeldung für den Ausführungsfehler zurück, null, wenn die Ausführung nicht fehlgeschlagen ist.

Returns
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Gibt eine Kopie der Karte zurück, die alle protokollierten Dateien enthält, die mit diesem Testfall verknüpft sind.

Returns
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

Returns
ERROR(/Map) der Messwerte für den Testlauf.

getRunProtoMetrics

public  getRunProtoMetrics ()

Returns
ERROR(/Map) der Messwerte der Testläufe mit dem neuen Proto-Format.

getStartTime

public long getStartTime ()

Gibt den Beginn des ersten Aufrufs von „testRunStart“ zurück.

Returns
long

getTestResults

public  getTestResults ()

Gibt eine Karte mit den Testergebnissen zurück.

Returns

getTestsInState

public  getTestsInState ( statuses)

Ruft die Gruppe von Tests mit bestimmten Statuswerten ab.

Parameter
statuses

Returns

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Gibt alle TestResult in einem bestimmten Status zurück.

Parameter
status TestStatus

Returns

GetTextSummary

public String getTextSummary ()

Gibt einen benutzerfreundlichen String zur Beschreibung der Ergebnisse zurück.

Returns
String

hasFailedTests

public boolean hasFailedTests ()

Returns
boolean true, wenn bei der Testausführung fehlgeschlagene oder fehlerhafte Tests aufgetreten sind.

isRunComplete

public boolean isRunComplete ()

Returns
boolean true, wenn der Test abgeschlossen ist.

isRunFailure

public boolean isRunFailure ()

Returns
boolean true, wenn der Testlauf fehlgeschlagen ist.

zusammenführen

public static TestRunResult merge ( testRunResults)

Parameter
testRunResults

Returns
TestRunResult

Weitere Informationen:

zusammenführen

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Führen Sie mehrere TestRunResults desselben testRunName zusammen. Wenn ein Testfall in mehreren TestRunResults angezeigt wird, aber unterschiedliche Ergebnisse liefert (z.B. „boottest-device“ wird dreimal mit dem Ergebnis „FAIL-FAIL-PASS“ ausgeführt), verketten wir alle Stacktraces der FAILED-Ausführungen und vertrauen dem Endergebnis in Bezug auf Status, Messwerte, Logdateien und Start-/Endzeit an.

Parameter
testRunResults : Eine Liste von TestRunResult, die zusammengeführt werden sollen.
strategy MergeStrategy: Die Strategie zur Zusammenführung von Ergebnissen.
Returns
TestRunResult das endgültige TestRunResult mit den zusammengeführten Daten aus den testRunResults.

resetRunFailure

public void resetRunFailure ()

Setzen Sie den Ausführungsfehlerstatus zurück.

Bei Wiederholungsversuchen ist manchmal das Zurücksetzen des Ausführungsfehlerstatus erforderlich. Dies sollte mit Bedacht erfolgen, um einen echten Fehler nicht zu beheben.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parameter
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Parameter
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parameter
test TestDescription

trace String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parameter
test TestDescription

failure FailureDescription

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Parameter
test TestDescription

endTime long

testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parameter
test TestDescription

testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parameter
test TestDescription

failure FailureDescription

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parameter
test TestDescription

trace String

testIgnoriert

public void testIgnored (TestDescription test)

Parameter
test TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Informationen zu einer protokollierten Datei werden gespeichert und dem laufenden Testfall oder Testlauf zugeordnet.

Parameter
dataName String: Der Name, der auf die Daten verweist.
logFile LogFile: Das LogFile-Objekt, das angibt, wo das Objekt gespeichert wurde, und Informationen dazu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parameter
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parameter
failureDescription FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Parameter
errorMessage String

testRunStarted

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

Benachrichtigung, dass ein Test gestartet wurde.

Parameter
runName String: Der Name, der dem Testlauf zu Tracking-Zwecken zugeordnet ist.
testCount int: die Anzahl der erwarteten Testfälle, die mit dem Testlauf verknüpft sind.
startTime long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Benachrichtigung, dass ein Test gestartet wurde.

Parameter
runName String: Der Name, der dem Testlauf zu Tracking-Zwecken zugeordnet ist.
testCount int: die Anzahl der erwarteten Testfälle, die mit dem Testlauf verknüpft sind.

testRunStopped

public void testRunStopped (long elapsedTime)

Parameter
elapsedTime long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parameter
test TestDescription

reason SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parameter
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

Parameter
test TestDescription