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.

ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

Sottoclassi dirette note

FileProtoResultReporter, StreamProtoResultReporter

FileProtoResultReporter	Proto reporter che esegue il dump di `TestRecord` in un file.
StreamProtoResultReporter	Un'implementazione di `ProtoResultReporter`

Sottoclassi indirette note

InvocationProtoResultReporter, ModuleProtoResultReporter

InvocationProtoResultReporter	Reporter per archiviare le informazioni di memorizzazione nella cache a livello di invocazione e il relativo elenco di moduli
ModuleProtoResultReporter	Un reporter dei risultati che ha lo scopo di segnalare solo i risultati a livello di modulo.

Result Reporter crea un protobuf TestRecord con tutti i risultati all'interno. Deve essere esteso per gestire cosa fare con il proto finale in processFinalProto(TestRecord).

Riepilogo

Costruttori pubblici
`ProtoResultReporter()`

Metodi pubblici
`final void`	`invocationEnded(long elapsedTime)` Indica 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.
`final void`	`logAssociation(String dataName, LogFile logFile)` In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo nel callback diretto `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` non è possibile.
`void`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` Utilizza il record di chiamata per inviare uno alla volta tutti i log finali della chiamata.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` Gestione del prototipo finale con tutti i risultati.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` Gestione del proto del record di test di chiamata parziale dopo l'evento `invocationStarted(IInvocationContext)`.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` Gestione del proto del record dello scenario di test finalizzato dopo l'evento `testEnded(TestDescription,long,HashMap)`.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` Gestione del proto del record dello scenario di test parziale dopo l'evento `testStarted(TestDescription,long)`.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` Gestione del proto del record del modulo finalizzato dopo l'`testModuleEnded()`.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` Gestione del proto di record del modulo parziale dopo che si è verificato `testModuleStarted(IInvocationContext)`.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` Gestione del proto del record di esecuzione finalizzato dopo l'evento `testRunEnded(long,HashMap)`.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` Gestione del proto del record di esecuzione parziale del test dopo che si è verificato `testRunStarted(String,int)`.
`void`	`setGranularResults(boolean granularResults)`
`void`	`setInlineRecordOfChildren(boolean inline)`
`boolean`	`supportGranularResults()` Restituisce True se il reporter supporta risultati granulari, false in caso contrario.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` in cui possiamo specificare direttamente l'ora di fine.
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Segnala la fine dell'esecuzione di un singolo scenario di test.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'esito negativo di un singolo test case.
`final void`	`testFailed(TestDescription test, String trace)` Segnala l'esito negativo di un singolo test case.
`final void`	`testIgnored(TestDescription test)` Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`final void`	`testModuleEnded()` Segnala la fine dell'esecuzione di un modulo.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Indica l'inizio dell'esecuzione di un modulo.
`final void`	`testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)` Segnala la fine dell'esecuzione del test.
`final void`	`testRunFailed(FailureDescription failure)` L'esecuzione di test dei report non è stata completata a causa di un errore descritto da `FailureDescription`.
`final 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 di test.
`final void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione di test.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione di test.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Chiamato quando un test viene ignorato e non eseguito per un motivo insolito.
`final void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(TestDescription)`, in cui specifichiamo anche quando è iniziato il test, combinata con `testEnded(TestDescription,long,Map)` per una misurazione accurata.
`final void`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo scenario di test.

Metodi protetti
`void`	`afterModuleEnd()`
`void`	`beforeModuleStart()`
`TestRecordProto.ChildReference`	`createModuleChildReference(TestRecordProto.TestRecord record)` Crea un riferimento secondario per un modulo.

Costruttori pubblici

ProtoResultReporter

public ProtoResultReporter ()

Metodi pubblici

invocationEnded

public final void invocationEnded (long elapsedTime)

Indica 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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo nel callback diretto testLogSaved(String,LogDataType,InputStreamSource,LogFile) non è possibile. Pertanto, questo callback consente di fornire un'associazione forte in modo esplicito.

Parametri
`dataName`	`String`: il nome dei dati
`logFile`	`LogFile`: il `LogFile` registrato in precedenza e che deve essere associato allo scenario di test.

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilizza il record di chiamata per inviare uno alla volta tutti i log finali della chiamata.

Parametri
`invocationLogs`	`TestRecordProto.TestRecord`: Il proto finalizzato che rappresenta la chiamata.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestione del prototipo finale con tutti i risultati.

Parametri
`finalRecord`	`TestRecordProto.TestRecord`: Il proto finalizzato con tutti i risultati di invocazione.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Gestione del proto del record di test di chiamata parziale dopo l'evento invocationStarted(IInvocationContext).

Parametri
`invocationStartRecord`	`TestRecordProto.TestRecord`: Il proto parziale compilato dopo invocationStart.
`invocationContext`	`IInvocationContext`: La chiamata `IInvocationContext`.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestione del proto del record dello scenario di test finalizzato dopo l'evento testEnded(TestDescription,long,HashMap).

Parametri
`testCaseRecord`	`TestRecordProto.TestRecord`: Il proto finalizzato che rappresenta uno scenario di test.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Gestione del proto del record dello scenario di test parziale dopo l'evento testStarted(TestDescription,long).

Parametri
`testCaseStartedRecord`	`TestRecordProto.TestRecord`: Il proto parziale che rappresenta lo scenario di test.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Gestione del proto del record del modulo finalizzato dopo l'testModuleEnded().

Parametri
`moduleRecord`	`TestRecordProto.TestRecord`: il proto finalizzato che rappresenta il modulo.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Gestione del proto di record del modulo parziale dopo che si è verificato testModuleStarted(IInvocationContext).

Parametri
`moduleStartRecord`	`TestRecordProto.TestRecord`: il proto parziale che rappresenta il modulo.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Gestione del proto del record di esecuzione finalizzato dopo l'evento testRunEnded(long,HashMap).

Parametri
`runRecord`	`TestRecordProto.TestRecord`: Il proto finalizzato che rappresenta l'esecuzione.
`moduleInProgress`	`boolean`: indica se un modulo è in corso o meno.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestione del proto del record di esecuzione parziale del test dopo che si è verificato testRunStarted(String,int).

Parametri
`runStartedRecord`	`TestRecordProto.TestRecord`: il proto parziale che rappresenta l'esecuzione.

setGranularResults

public void setGranularResults (boolean granularResults)

Parametri
`granularResults`	`boolean`

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parametri
`inline`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Restituisce True se il reporter supporta risultati granulari, false in caso contrario.

Resi
`boolean`

testAssumptionFailure

public final 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 final 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 final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternativa a testEnded(TestDescription,Map) in cui possiamo specificare direttamente l'ora di fine. Combina con testStarted(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`	`HashMap`: un `Map` delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> 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`	`HashMap`: un `Map` delle metriche emesse

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'esito negativo di un singolo test case.

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 final void testFailed (TestDescription test, 
                String trace)

Segnala l'esito negativo di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

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

testIgnored

public final 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

testModuleEnded

public final void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public final 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 una corsa che utilizza moduli: runner basati su suite.

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

testRunEnded

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

Segnala la fine dell'esecuzione del test. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

Parametri
`elapsedTimeMillis`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi
`runMetrics`	`HashMap`: coppie chiave-valore riportate alla fine di un'esecuzione del test con `Metric`.

testRunFailed

public final 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 final 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 di test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione del 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.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione di test.

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione del 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 di inizio della corsa, misurata tramite `System.currentTimeMillis()`

testSkipped

public final 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 final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(TestDescription), in cui specifichiamo anche quando è iniziato il test, combinata con testEnded(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 final void testStarted (TestDescription test)

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

Parametri
`test`	`TestDescription`: identifica il test

Metodi protetti

afterModuleEnd

protected void afterModuleEnd ()

beforeModuleStart

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea un riferimento secondario per un modulo.

Parametri
`record`	`TestRecordProto.TestRecord`

Risultati
`TestRecordProto.ChildReference`