A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad 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

Contiene i risultati di una singola esecuzione del test.

Mantiene un conteggio accurato dei test e monitora i test incompleti.

Non è thread-safe. I callback di test* devono essere chiamati in ordine

Riepilogo

Costanti
`String`	`ERROR_DIVIDER`

Costruttori pubblici
`TestRunResult()` Crea un`TestRunResult` vuoto.

Metodi pubblici
`void`	`addTestResult(TestDescription test, TestResult testResult)`
`Set<TestDescription>`	`getCompletedTests()` Restituisce l'insieme dei test completati.
`long`	`getElapsedTime()` Restituisce il tempo trascorso dell'esecuzione corrente.
`int`	`getExpectedTestCount()` Restituisce il numero di scenari di test che questo TestRunResult prevede di avere.
`Set<TestDescription>`	`getFailedTests()` Restituisce l'insieme di test non riusciti.
`String`	`getName()`
`int`	`getNumAllFailedTests()` Restituisce il numero totale di test in stato di errore (non riuscito, errore di ipotesi)
`int`	`getNumCompleteTests()` Restituisce il numero di test completi in questa esecuzione, ovvero con stato != incompleto.
`int`	`getNumTests()` Restituisce il numero di test in questa esecuzione.
`int`	`getNumTestsInState(TestStatus status)` Restituisce il numero di test nel determinato stato per questa esecuzione.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` PER LA COMPATIBILITÀ con lo stato precedente.
`Set<TestDescription>`	`getPassedTests()` Restituisce l'insieme dei test superati.
`FailureDescription`	`getRunFailureDescription()` Restituisce il descrittore di errore di esecuzione, `null`, se l'esecuzione non è andata in errore.
`String`	`getRunFailureMessage()` Restituisce il messaggio di errore di esecuzione non riuscita, `null`, se l'esecuzione non è andata in errore.
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` Restituisce una copia della mappa contenente tutti i file registrati associati a questo scenario di test.
`Map<String, String>`	`getRunMetrics()`
`HashMap<String, MetricMeasurement.Metric>`	`getRunProtoMetrics()`
`long`	`getStartTime()` Restituisce l'ora di inizio della prima chiamata testRunStart.
`Map<TestDescription, TestResult>`	`getTestEntriesInState(Collection<TestStatus> statuses)` Recupera l'insieme di test nei determinati stati.
`Map<TestDescription, TestResult>`	`getTestResults()` Restituisce una mappa dei risultati del test.
`Set<TestDescription>`	`getTestsInState(List<TestStatus> statuses)` Recupera l'insieme di test nei determinati stati.
`List<TestResult>`	`getTestsResultsInState(TestStatus status)` Restituisce tutti i `TestResult` in un determinato stato.
`String`	`getTextSummary()` Restituisce una stringa di facile lettura che descrive i risultati.
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults)`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults, MergeStrategy strategy)` Unisci più TestRunResults dello stesso testRunName.
`void`	`resetRunFailure()` Reimposta lo stato di errore di esecuzione.
`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)` Le informazioni su un file registrato vengono memorizzate e associate al caso di test o all'esecuzione del test in corso.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Nuova interfaccia che utilizza le nuove metriche proto.
`void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` Notifica che è stata avviata un'esecuzione di test.
`void`	`testRunStarted(String runName, int testCount)` Notifica che è stata avviata un'esecuzione di test.
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Costanti

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Valore costante: " ====Next Error==== "

Costruttori pubblici

TestRunResult

public TestRunResult ()

Crea unTestRunResult vuoto.

Metodi pubblici

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parametri
`test`	`TestDescription`
`testResult`	`TestResult`

getCompletedTests

public Set<TestDescription> getCompletedTests ()

Restituisce l'insieme dei test completati.

Resi
`Set<TestDescription>`

getElapsedTime

public long getElapsedTime ()

Restituisce il tempo trascorso dell'esecuzione corrente.

Resi
`long`

getExpectedTestCount

public int getExpectedTestCount ()

Restituisce il numero di scenari di test che questo TestRunResult prevede di avere. Il numero effettivo potrebbe essere inferiore a quello previsto a causa di arresti anomali del test. In genere, una mancata corrispondenza di questo tipo indica un errore di esecuzione del test.

Resi
`int`

getFailedTests

public Set<TestDescription> getFailedTests ()

Restituisce l'insieme di test non riusciti.

Resi
`Set<TestDescription>`

getName

public String getName ()

Resi
`String`	il nome dell'esecuzione del test

getNumAllFailedTests

public int getNumAllFailedTests ()

Restituisce il numero totale di test in stato di errore (non riuscito, errore di ipotesi)

Resi
`int`

getNumCompleteTests

public int getNumCompleteTests ()

Restituisce il numero di test completi in questa esecuzione, ovvero con stato != incompleto.

Resi
`int`

getNumTests

public int getNumTests ()

Restituisce il numero di test in questa esecuzione.

Resi
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Restituisce il numero di test nel determinato stato per questa esecuzione.

Parametri
`status`	`TestStatus`

Resi
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

PER LA COMPATIBILITÀ con lo stato precedente. Usa invece getNumTestsInState(TestStatus).

Parametri
`ddmlibStatus`	`TestResult.TestStatus`

Resi
`int`

getPassedTests

public Set<TestDescription> getPassedTests ()

Restituisce l'insieme dei test superati.

Resi
`Set<TestDescription>`

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Restituisce il descrittore di errore di esecuzione, null, se l'esecuzione non è andata in errore.

Resi
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

Restituisce il messaggio di errore di esecuzione non riuscita, null, se l'esecuzione non è andata in errore.

Resi
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Restituisce una copia della mappa contenente tutti i file registrati associati a questo scenario di test.

Resi
`MultiMap<String, LogFile>`

getRunMetrics

public Map<String, String> getRunMetrics ()

Resi
`Map<String, String>`	un `Map` delle metriche del test.

getRunProtoMetrics

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

Resi
`HashMap<String, MetricMeasurement.Metric>`	un `Map` delle metriche di esecuzione del test con il nuovo formato proto.

getStartTime

public long getStartTime ()

Restituisce l'ora di inizio della prima chiamata testRunStart.

Resi
`long`

getTestEntriesInState

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

Recupera l'insieme di test nei determinati stati.

Parametri
`statuses`	`Collection`

Resi
`Map<TestDescription, TestResult>`

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

Restituisce una mappa dei risultati del test.

Resi
`Map<TestDescription, TestResult>`

getTestsInState

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

Recupera l'insieme di test nei determinati stati.

Parametri
`statuses`	`List`

Resi
`Set<TestDescription>`

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

Restituisce tutti i TestResult in un determinato stato.

Parametri
`status`	`TestStatus`

Resi
`List<TestResult>`

getTextSummary

public String getTextSummary ()

Restituisce una stringa di facile lettura che descrive i risultati.

Resi
`String`

hasFailedTests

public boolean hasFailedTests ()

Resi
`boolean`	`true` se l'esecuzione del test ha avuto esito negativo o ha generato errori.

isRunComplete

public boolean isRunComplete ()

Resi
`boolean`	`true` se l'esecuzione del test è terminata.

isRunFailure

public boolean isRunFailure ()

Resi
`boolean`	`true` se l'esecuzione del test non è riuscita.

unire

public static TestRunResult merge (List<TestRunResult> testRunResults)

Parametri
`testRunResults`	`List`

Resi
`TestRunResult`

Vedi anche:

merge(List,MergeStrategy)

unire

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

Unisci più TestRunResults dello stesso testRunName. Se uno scenario di test viene visualizzato in più TestRunResults, ma ha risultati diversi (ad es. "boottest-device" viene eseguito tre volte con risultato FAIL-FAIL-PASS), concateniamo tutte le analisi dello stack delle esecuzioni FAILED e consideriamo attendibile il risultato dell'esecuzione finale per stato, metriche, file di log, ora di inizio/fine.

Parametri
`testRunResults`	`List`: Un elenco di TestRunResult da unire.
`strategy`	`MergeStrategy`: la strategia di unione adottata per unire i risultati.

Resi
`TestRunResult`	il TestRunResult finale contenente i dati uniti di testRunResults.

resetRunFailure

public void resetRunFailure ()

Reimposta lo stato di errore di esecuzione.

A volte è necessario reimpostare lo stato di errore dell'esecuzione quando si riprova. Questa operazione deve essere eseguita con attenzione per evitare di cancellare un errore reale.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parametri
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

Parametri
`runComplete`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Parametri
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`	`HashMap`

testEnded

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

Parametri
`test`	`TestDescription`
`testMetrics`	`HashMap`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parametri
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Le informazioni su un file registrato vengono memorizzate e associate al caso di test o all'esecuzione del test in corso.

Parametri
`dataName`	`String`: il nome che fa riferimento ai dati.
`logFile`	`LogFile`: l'oggetto `LogFile` che rappresenta la posizione in cui è stato salvato l'oggetto e le informazioni correlate.

testRunEnded

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

Nuova interfaccia che utilizza le nuove metriche proto.

Parametri
`elapsedTime`	`long`
`runMetrics`	`HashMap`

testRunEnded

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

Parametri
`elapsedTime`	`long`
`runMetrics`	`Map`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parametri
`failureDescription`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parametri
`errorMessage`	`String`

testRunStarted

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

Notifica che è stata avviata un'esecuzione di test.

Parametri
`runName`	`String`: il nome associato all'esecuzione del test ai fini del monitoraggio.
`testCount`	`int`: il numero di scenari di test previsti associati all'esecuzione del test.
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Notifica che è stata avviata un'esecuzione di test.

Parametri
`runName`	`String`: il nome associato all'esecuzione del test ai fini del monitoraggio.
`testCount`	`int`: il numero di scenari di test previsti associati all'esecuzione del test.

testRunStopped

public void testRunStopped (long elapsedTime)

Parametri
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parametri
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parametri
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parametri
`test`	`TestDescription`