A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

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

Ascoltatore che registra tutti gli eventi ricevuti in un file

Riepilogo

Costruttori pubblici
`EventsLoggerListener(String name)`

Metodi pubblici
`File`	`getLoggedEvents()`
`void`	`invocationEnded(long elapsedTime)` Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.
`void`	`invocationFailed(FailureDescription failure)` Segnala un'invocazione incompleta a causa di una condizione di errore.
`void`	`invocationSkipped(SkipReason reason)` Segnala un'invocazione come ignorata
`void`	`invocationStarted(IInvocationContext context)` Segnala l'inizio dell'invocazione del test.
`void`	`logAssociation(String dataName, LogFile logFile)` In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback diretto `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Viene 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`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'errore di un singolo test case.
`void`	`testFailed(TestDescription test, String trace)` Segnala l'errore di un singolo test case.
`void`	`testIgnored(TestDescription test)` Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`void`	`testModuleEnded()` Segnala la fine dell'esecuzione di un modulo.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Segnala l'inizio dell'esecuzione di un modulo.
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Segnala la fine dell'esecuzione del test.
`void`	`testRunFailed(FailureDescription failure)` L'esecuzione del test dei report non è riuscita a causa di un errore descritto da `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
`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`	`testSkipped(TestDescription test, SkipReason reason)` Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
`void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` in cui viene specificato anche quando è stato avviato il test, combinata con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` per una misurazione accurata.

Costruttori pubblici

EventsLoggerListener

public EventsLoggerListener (String name)

Parametri
`name`	`String`

Metodi pubblici

getLoggedEvents

public File getLoggedEvents ()

Ritorni
`File`

invocationEnded

public void invocationEnded (long elapsedTime)

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

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala un'invocazione 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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

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

Parametri
`context`	`IInvocationContext`: informazioni sull'invocazione

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). 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 da associare allo scenario di test.

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Viene 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)

Viene 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 di fine del test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore 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 void testFailed (TestDescription test, 
                String trace)

Segnala l'errore 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 void testIgnored (TestDescription test)

Viene 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 void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

Parametri
`elapsedTimeMillis`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi
`runMetrics`	: coppie chiave-valore registrate al termine di un'esecuzione del test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita 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 è riuscita a causa di un errore fatale.

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 del 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. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi 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 del 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 del test.

Parametri
`runName`	`String`: il nome dell'esecuzione del 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. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.
`startTime`	`long`: l'ora di inizio dell'esecuzione, misurata tramite `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.

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 viene specificato anche quando è stato avviato 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()`