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.

Questa pagina è stata tradotta dall'API Cloud Translation.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Sottoclassi dirette note

FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer

FilteredResultForwarder	Variante di `ResultForwarder` che consente di segnalare solo una lista consentita di `TestDescription`.
JarHostTest.HostTestListener	Listener wrapper che inoltra tutti gli eventi, tranne testRunStarted() e testRunEnded(), al listener incorporato.
LogSaverResultForwarder	Un `ResultForwarder` per salvare i log con il salvataggio globale dei file.
LogcatCrashResultForwarder	Listener speciale: in caso di errori (arresto anomalo del processo di strumentazione), tenta di estrarre l'arresto anomalo da logcat e lo aggiunge al messaggio di errore associato al test.
PythonBinaryHostTest.PythonForwarder	Result forwarder per sostituire il nome dell'esecuzione con il nome del file binario.
ResultAndLogForwarder	Forwarder per eventi di risultati e log.
RetryResultForwarder	Un'estensione di `ResultForwarder` che esegue sempre il push a un determinato numero di tentativi.
ShardMainResultForwarder	Un `ResultForwarder` che combina i risultati di invocazioni di test suddivise.
TestTimeoutEnforcer	Listener che consentono di controllare il tempo di esecuzione di un determinato caso di test e di non superarlo se supera un determinato timeout.

Sottoclassi indirette note

GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Assistente per le lezioni per rilevare l'inizio e la fine delle corse mancanti.
ModuleResultsAndMetricsForwarder	Un'estensione di `ResultAndLogForwarder` che aggiunge metriche aggiuntive relative al modulo ai risultati del test.
RemoteTestTimeOutEnforcer	Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e di interromperlo se supera un determinato timeout.
RetryLogSaverResultForwarder	Forwarder che gestisce anche il passaggio del tentativo corrente.

Un ITestInvocationListener che inoltra i risultati dell'invocazione a un elenco di altri listener.

Riepilogo

Costruttori pubblici
`ResultForwarder(ITestInvocationListener... listeners)` Costruttore di argomenti di variabili alternativi per `ResultForwarder`.
`ResultForwarder( listeners)` Crea un `ResultForwarder`.

Costruttori protetti
`ResultForwarder()` Crea un `ResultForwarder` con l'impostazione del listener differito.

Metodi pubblici
	`getListeners()` Recupera l'elenco degli ascoltatori.
`TestSummary`	`getSummary()` Consente a InvocationListener di restituire un riepilogo.
`void`	`invocationEnded(long elapsedTime)` Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
`void`	`invocationFailed(FailureDescription failure)` Segnala una chiamata incompleta a causa di una condizione di errore.
`void`	`invocationFailed(Throwable cause)` Segnala una chiamata incompleta a causa di una condizione di errore.
`void`	`invocationSkipped(SkipReason reason)` Segnala un'invocazione come ignorata
`void`	`invocationStarted(IInvocationContext context)` Segnala l'inizio della chiamata di test.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` in cui possiamo specificare direttamente l'ora di fine.
`void`	`testEnded(TestDescription test, testMetrics)` Segnala la fine dell'esecuzione di un singolo scenario di test.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'esito negativo di un singolo caso di test.
`void`	`testFailed(TestDescription test, String trace)` Segnala l'esito negativo di un singolo caso di test.
`void`	`testIgnored(TestDescription test)` Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornisce i dati di log o di debug associati dall'invocazione del test.
`void`	`testModuleEnded()` Segnala la fine dell'esecuzione di un modulo.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Indica l'inizio dell'esecuzione di un modulo.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Segnala la fine dell'esecuzione del test.
`void`	`testRunFailed(FailureDescription failure)` L'esecuzione di test dei report non è stata completata a causa di un errore descritto da `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Segnala l'inizio di un'esecuzione del test.
`void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione del test.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione del test.
`void`	`testRunStopped(long elapsedTime)` L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Chiamato quando un test viene ignorato e non eseguito per un motivo insolito.
`void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, in cui specifichiamo anche quando è iniziato il test, combinata con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` per una misurazione accurata.
`void`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo scenario di test.

Metodi protetti
`void`	`setListeners(ITestInvocationListener... listeners)` Imposta gli ascoltatori dopo la costruzione.
`void`	`setListeners( listeners)` Imposta gli ascoltatori dopo la costruzione.

Costruttori pubblici

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Costruttore di argomenti di variabili alternativi per ResultForwarder.

Parametri
`listeners`	`ITestInvocationListener`: gli `ITestInvocationListener` reali a cui inoltrare i risultati

ResultForwarder

public ResultForwarder ( listeners)

Crea un ResultForwarder.

Parametri
`listeners`	: gli `ITestInvocationListener` reali a cui inoltrare i risultati

Costruttori protetti

ResultForwarder

protected ResultForwarder ()

Crea un ResultForwarder con l'impostazione del listener differito. Destinato solo all'uso da parte di sottoclassi.

Metodi pubblici

getListeners

public  getListeners ()

Recupera l'elenco degli ascoltatori.

Ritorni
	L'elenco di `ITestInvocationListener`.

getSummary

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
`TestSummary`	Un `TestSummary` che riassume la corsa o null

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`elapsedTime`	`long`: il tempo trascorso dell'invocazione in ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`failure`	`FailureDescription`: il `FailureDescription` che descrive la causa dell'errore

invocationFailed

public void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`cause`	`Throwable`: la causa `Throwable` dell'errore

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare la segnalazione di più dispositivi.

Parametri
`context`	`IInvocationContext`: informazioni sulla chiamata

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testEnded

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui possiamo specificare direttamente l'ora di fine. Combina con testStarted(com.android.tradefed.result.TestDescription, long) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`endTime`	`long`: l'ora in cui è terminato il test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) 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`	`TestDescription`: identifica il test
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

Verrà chiamato tra testStarted e testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

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

Parametri
`test`	`TestDescription`: identifica il test

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornisce i dati di log o di debug associati dall'invocazione del test.

Deve essere chiamato prima del giorno ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o del giorno ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log host e, se applicabile, il logcat del dispositivo.

Parametri
`dataName`	`String`: un nome descrittivo `String` dei dati, ad es. "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. Ciò significa che gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName
`dataType`	`LogDataType`: il `LogDataType` dei dati
`dataStream`	`InputStreamSource`: il `InputStreamSource` dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante al termine dell'operazione. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Indica l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza moduli: runner basati su suite.

Parametri
`moduleContext`	`IInvocationContext`: il `IInvocationContext` del modulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

Parametri
`elapsedTime`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi
`runMetrics`	: coppie chiave-valore segnalate alla fine di un'esecuzione del test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione di test dei report non è stata completata a causa di un errore descritto da FailureDescription.

Parametri
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testRunFailed

public 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 void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riprovato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber va da 0 a 3.

testRunStarted

public 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

testRunStarted

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

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
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene ritentato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber va da 0 a 3.
`startTime`	`long`: l'ora in cui è iniziata la corsa, misurata tramite `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: attualmente non utilizzato, valuta la possibilità di rimuoverlo

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chiamato quando un test viene ignorato e non eseguito per un motivo insolito. Verrà effettuato un nuovo tentativo di esecuzione di questi test.

Parametri
`test`	`TestDescription`: identifica il test
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), in cui specifichiamo anche quando è iniziato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`startTime`	`long`: l'ora di inizio del test, misurata tramite `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo scenario di test. Interfaccia precedente, deve utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
`test`	`TestDescription`: identifica il test

Metodi protetti

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Imposta gli ascoltatori dopo la costruzione. Destinato all'uso esclusivo da parte delle sottoclassi.

Parametri
`listeners`	`ITestInvocationListener`: gli `ITestInvocationListener` reali a cui inoltrare i risultati

setListeners

protected void setListeners ( listeners)

Imposta gli ascoltatori dopo la costruzione. Destinato all'uso esclusivo da parte delle sottoclassi.

Parametri
`listeners`	: gli `ITestInvocationListener` reali a cui inoltrare i risultati