A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Sottoclassi indirette note

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Implementazione stub di `ITestRunListener`
TestRunResult	Contiene i risultati di una singola esecuzione del test.
TestRunToTestInvocationForwarder	Forwarder da ddmlib `ITestRunListener` a `ITestLifeCycleReceiver`.
XmlTestRunListener	Scrive i risultati JUnit in file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

Riceve notifiche di eventi durante l'esecuzione dei test di strumentazione.

Modellato su org.junit.runner.notification.RunListener

La sequenza di chiamate sarà:

testRunStarted
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Riepilogo

Metodi pubblici
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Segnala la fine dell'esecuzione di un singolo scenario di test.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Segnala l'esito negativo di un singolo caso di test.
`abstract void`	`testIgnored(TestIdentifier test)` Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Segnala la fine dell'esecuzione del test.
`abstract void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile.
`abstract void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione del test.
`abstract void`	`testRunStopped(long elapsedTime)` Questo metodo è obsoleto. Questo callback non viene mai richiamato. Da eliminare.
`abstract void`	`testStarted(TestIdentifier test)` Segnala l'inizio di un singolo scenario di test.

Metodi pubblici

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
`test`	`TestIdentifier`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

Segnala la fine dell'esecuzione di un singolo scenario di test.

Se testFailed(TestIdentifier, String) non è stato richiamato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione dello scenario di test.

Parametri

test

TestIdentifier: identifica il test

testMetrics

: un ERROR(/Map) delle metriche emesse durante l'esecuzione dello scenario di test da android.app.Instrumentation#sendStatus. L'ordine di inserimento viene mantenuto a meno che non emetti più volte la stessa chiave. Tieni presente che le chiavi standard definite in IInstrumentationResultParser.StatusKeys vengono filtrate da questa mappa. Ddmlib potrebbe aggiungere metriche di test aggiuntive definite in IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Segnala l'esito negativo di un singolo caso di test.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestIdentifier`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testIgnored

public abstract void testIgnored (TestIdentifier test)

Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.

Parametri
`test`	`TestIdentifier`: identifica il test

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

Parametri

elapsedTime

long: tempo trascorso segnalato dal dispositivo, in millisecondi

runMetrics

: un ERROR(/Map) delle metriche emesse durante l'esecuzione dello scenario di test da android.app.Instrumentation#addResults. L'ordine di inserimento viene mantenuto a meno che non emetti più volte la stessa chiave. Tieni presente che le chiavi standard definite in IInstrumentationResultParser.StatusKeys vengono filtrate da questa mappa. Ddmlib potrebbe aggiungere metriche di test aggiuntive definite in IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile.

Parametri
`errorMessage`	`String`: `String` che descrive il motivo dell'errore di esecuzione.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione del test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione di test

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Questo metodo è obsoleto.
Questo callback non viene mai richiamato. Da eliminare.

L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.

Parametri
`elapsedTime`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi

testStarted

public abstract void testStarted (TestIdentifier test)

Segnala l'inizio di un singolo scenario di test.

Parametri
`test`	`TestIdentifier`: identifica il test