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.

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Classi di sottoclasse indirette note

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector e altri 80.

AggregatePostProcessor	Un aggregatore di metriche che fornisce i valori minimo, massimo, medio, varianza, deviazione standard, totale, conteggio e, facoltativamente, percentile per le metriche numeriche raccolte durante le esecuzioni di test con più iterazioni, trattandole come doppi.
AtraceCollector	Un `IMetricCollector` che esegue atrace durante un test e raccoglie il risultato e lo registra nell'invocazione.
AtraceRunMetricCollector	Raccoglie le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test e esegue il post-trattamento dei file di traccia nella directory di test e aggrega le metriche.
AveragePostProcessor	Implementazione del post-processore che calcola la media dell'elenco delle metriche.
BaseDeviceMetricCollector	Implementazione di base di `IMetricCollector` che consente di avviare e interrompere la raccolta su `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` e `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	La classe `IPostProcessor` di base che ogni implementazione deve estendere.
BluetoothConnectionLatencyCollector	Il collector invierà ai dispositivi una configurazione della metrica della durata di statsd predefinita e raccoglierà la durata della connessione Bluetooth per ogni profilo.
BluetoothConnectionStateCollector	Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero dello stato della connessione per ogni profilo.
BluetoothConnectionSuccessRatePostProcessor	Implementazione del postprocessore che calcola il tasso di successo per un profilo Bluetooth Utilizza "metric-key-match" per specificare le metriche che contengono gli stati di connessione Bluetooth nell'array numerico Esempio [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Raccogliere per attivare la registrazione di analisi HCI Bluetooth sul DUT e raccogliere il log per ogni test.
BugreportCollector	Un `ITestInvocationListener` pass-through che raccoglie i report di bug quando si verificano eventi configurabili e poi chiama `ITestInvocationListener.testLog` sui suoi elementi secondari dopo la raccolta di ogni report di bug.
BugreportzOnFailureCollector	Raccogliere una segnalazione di bug quando uno scenario di test non va a buon fine.
BugreportzOnTestCaseFailureCollector	Raccogliere una segnalazione di bug quando un caso di test in un'esecuzione non va a buon fine.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura di Clang dal dispositivo e le registra come elementi di test.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come elementi di test.
CollectingTestListener	Un `ITestInvocationListener` che raccoglierà tutti i risultati del test.
CommandStatusHandler	Handler che consente di monitorare e aggiornare lo stato di un'invocazione.
ConditionFailureMonitor	Monitora eventuali errori dell'invocazione.
ConsoleResultReporter	Report sui risultati per stampare i risultati del test nella console.
CountTestCasesCollector	Conta e genera un report sul numero di casi di test per un determinato `IRemoteTest`.
CountingTestResultListener	Un `TestResultListener` che monitora il numero totale di test per `TestStatus`
DebugHostLogOnFailureCollector	Raccogli i log lato host e registrali quando si verifica un errore dello scenario di test.
DeviceReleaseReporter	Report sulle release del dispositivo che gestisce la comunicazione con il processo principale dei dispositivi da rilasciare.
DeviceTraceCollector	Raccogli dati che avvia la traccia di Perfetto all'avvio di un test e registra il file di traccia alla fine.
DeviceUnavailableMonitor	Questo ascoltatore tenta di acquisire solo un DNAE a livello di test case.
EventsLoggerListener	Ascoltatore che registra tutti gli eventi ricevuti in un file
FileProtoResultReporter	Proto reporter che scarica `TestRecord` in un file.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` che ascolta la chiave delle metriche proveniente dal dispositivo e le estrae come file dal dispositivo.
FilePullerLogCollector	Logger del file segnalato dal lato del dispositivo.
FilteredResultForwarder	Variante di `ResultForwarder` che consente di segnalare solo una lista consentita di `TestDescription`.
FormattedGeneratorReporter	Report che consente di generare report in un determinato formato.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura di gcov dal dispositivo e le registra come elementi di test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e poi le registra come elementi di test.
GranularRetriableTestWrapper.StartEndCollector	Helper di classe per rilevare l'inizio e la fine mancanti della corsa.
HostStatsdMetricCollector	Un `IMetricCollector` che raccoglie le metriche StatsD lato host utilizzando i comandi dell'utilità StatsD.
ICommandScheduler.IScheduledInvocationListener	Listener per gli eventi di chiamata al termine dell'invocazione.
ILogSaverListener	Consente ai `ITestInvocationListener` di rilevare quando vengono salvati i file di log.
IMetricCollector	Questa interfaccia verrà aggiunta come decorazione quando vengono generati i report sui risultati dei test per raccogliere le metriche corrispondenti.
IPostProcessor	I post-processor sono oggetti Trade Federation pensati per consentire l'elaborazione di metriche e log DOPO i test e PRIMA della generazione di report sui risultati.
IShardableListener	Un `ITestInvocationListener` che può essere suddiviso in parti.
ISupportGranularResults	Interfaccia che specifica se un `ITestInvocationListener` supporta o meno la ricezione dei risultati granulari.
ITestInvocationListener	Ascoltatore per i risultati del test dall'invocazione del test.
ITestSummaryListener	Interfaccia che consente a `ITestInvocationListener` di scambiare alcune informazioni limitate tramite riepiloghi.
InvocationProtoResultReporter	Report per memorizzare le informazioni sulla memorizzazione nella cache a livello di chiamata e l'elenco dei moduli
InvocationToJUnitResultForwarder	Una classe che ascolta gli eventi `ITestInvocationListener` e li inoltra a un `TestListener`.
JarHostTest.HostTestListener	Listener wrapper che inoltra tutti gli eventi, ad eccezione di testRunStarted() e testRunEnded(), al listener incorporato.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java dal dispositivo e le registra come elementi di test.
JsonHttpTestResultReporter	Un report sui risultati che codifica i risultati delle metriche di test e le informazioni su branch e dispositivo in JSON e le invia tramite POST a un endpoint di servizio HTTP
LUCIResultReporter	Un report sui risultati che salva i risultati dei test necessari per ResultDB e LUCI in formato JSON (go/result-sink) e registra la posizione del file nella console.
LastShardDetector	Quando eseguiamo lo sharding locale, a volte vogliamo eseguire alcune azioni solo quando l'ultimo frammento raggiunge `invocationEnded(long)`.
LegacySubprocessResultsReporter	Un'implementazione bloccata del report sui risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad es. 8 e versioni successive), nonostante le modifiche al superclasse.
LogSaverResultForwarder	Un `ResultForwarder` per salvare i log con il salvataggio file globale.
LogcatCrashResultForwarder	Ascoltatore speciale: in caso di errori (arresto anomalo del processo di ispezione) tenterà di estrarre dall'logcat l'arresto anomalo e lo aggiungerà al messaggio di errore associato al test.
LogcatOnFailureCollector	Raccogli dati che acquisisce e registra un logcat quando uno scenario di test non va a buon fine.
LogcatTimingMetricCollector	Un raccoglitore di metriche che raccoglie informazioni sui tempi (ad es. ora di passaggio dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare gli indicatori di inizio e fine di un evento dalle righe di logcat.
MetricFilePostProcessor	Utilizzato per il caricamento del file di log delle metriche raccolto durante il livello di test ed esecuzione.
MetricsXMLResultReporter	MetricsXMLResultReporter scrive le metriche di test e di esecuzione in un file XML in una cartella specificata dal parametro metrics-folder nella fase invocationEnded del test.
ModuleListener	Listener collegato a ogni `IRemoteTest` di ogni modulo per raccogliere l'elenco dei risultati.
ModuleLogcatCollector	Versione del raccoglitore logcat, ma per il modulo.
ModuleProtoResultReporter	Un report sui risultati destinato a registrare solo i risultati a livello di modulo.
NameMangleListener	Un ascoltatore proxy per tradurre i nomi del metodo di test, della classe e del pacchetto quando vengono generati i risultati.
PassingTestFileReporter	Un `ITestInvocationListener` che salva l'elenco degli scenari di test superati in un file di test
PerfettoGenericPostProcessor	Un post-processore che elabora il file proto metrico perfetto di testo/binario in coppie chiave-valore espandendo in modo ricorsivo i messaggi e i campi proto con valori di stringa fino a quando non viene rilevato il campo con valore numerico.
PerfettoPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di recuperare i file di perfetto dal dispositivo e di raccogliere le metriche.
PrettyTestEventLogger	Il logger abbina gli eventi e li registra per semplificare il debug.
ProtoResultReporter	Il Report sui risultati genera un `TestRecord` protobuf con tutti i risultati al suo interno.
PythonBinaryHostTest.PythonForwarder	Inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario.
RebootReasonCollector	Raccogli i riavvii del dispositivo durante l'esecuzione del test e genera un report in base al motivo e al conteggio.
RemoteTestTimeOutEnforcer	Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e di segnalare un errore se supera un determinato timeout.
ReportPassedTests	Segnala in un file i possibili filtri per escludere il test superato.
ResultAggregator	Inoltra i risultati in modo aggregato, se necessario, in base alla strategia di ripetizione adottata.
ResultAndLogForwarder	Inoltra i risultati e registra gli eventi.
ResultDBReporter	Report sui risultati che carica i risultati dei test in ResultDB.
ResultForwarder	Un `ITestInvocationListener` che inoltra i risultati dell'invocazione a un elenco di altri ascoltatori.
RetryLogSaverResultForwarder	Inoltra che gestisce anche il passaggio al tentativo corrente.
RetryResultForwarder	Un'estensione di `ResultForwarder` che esegue sempre push su un determinato numero di tentativi.
RuntimeRestartCollector	Raccoglitore che raccoglie i timestamp dei riavvii di runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti.
ScreenshotOnFailureCollector	Raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine.
ShardListener	Un `ITestInvocationListener` che raccoglie i risultati da uno shard di chiamata (ovvero una suddivisione di chiamata da eseguire su più risorse in parallelo) e li inoltra a un altro ascoltatore.
ShardMainResultForwarder	Un `ResultForwarder` che combina i risultati delle invocazioni di test suddivise in parti.
ShowmapPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di estrarre i file della mappa del programma dal dispositivo e di raccogliere le metriche.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-processore che elabora le metriche degli indicatori raccolte con un approccio "prima/dopo", ovvero
StatsdEventMetricPostProcessor	Un post-processore che elabora le metriche relative agli eventi nei report di statsd in coppie chiave-valore utilizzando i formattatori specificati nel processore.
StatsdGenericPostProcessor	Un post-processore che elabora i report di statsd proto binari in coppie chiave-valore espandendo il report come struttura ad albero.
StreamProtoResultReporter	Un'implementazione di `ProtoResultReporter`
SubprocessResultsReporter	Implementa `ITestInvocationListener` da specificare come result_reporter e inoltra dal subprocesso i risultati di test, esecuzioni di test e invocazioni di test.
SuiteResultReporter	Raccogliere i risultati dei test per un'intera chiamata della suite e generare i risultati finali.
TestResultListener	Una semplificazione di ITestLifecycleListener per gli implementatori che si preoccupano solo dei risultati dei singoli test.
TestRunResultListener	Listener che consente di leggere lo stato finale dell'esecuzione del test.
TestTimeoutEnforcer	Listener che consentono di controllare il tempo di esecuzione di un determinato test case e di non superarlo se supera un determinato timeout.
TextResultReporter	Un reporter dei risultati del test che inoltra i risultati alla stampante di risultati di testo JUnit.
TraceCmdCollector	Un `IMetricCollector` che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nell'invocazione.
TradefedSandboxRunner.StubScheduledInvocationListener	Uno stub `IScheduledInvocationListener` che non fa nulla.
XmlFormattedGeneratorReporter	Implementazione del `FormattedGeneratorReporter` che formatta la suite in un formato XML.
XmlResultReporter	Scrive i risultati di JUnit in file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

Riceve notifiche di eventi durante le esecuzioni dei test di misurazione.

Modellato su org.junit.runner.notification.RunListener

La sequenza di chiamate sarà:

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

Riepilogo

Metodi pubblici
`default void`	`testAssumptionFailure(TestDescription test, String trace)` Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
`default void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
`default 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.
`default void`	`testEnded(TestDescription test, testMetrics)` Segnala il termine dell'esecuzione di un singolo test case.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'errore di un singolo test case.
`default void`	`testFailed(TestDescription test, String trace)` Segnala l'errore di un singolo test case.
`default void`	`testIgnored(TestDescription test)` Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`default void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Segnala la fine dell'esecuzione del test.
`default void`	`testRunFailed(FailureDescription failure)` L'esecuzione del test dei report non è riuscita a causa di un errore descritto da `FailureDescription`.
`default void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Segnala l'inizio di un'esecuzione del test.
`default void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione del test.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione del test.
`default void`	`testRunStopped(long elapsedTime)` L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
`default void`	`testSkipped(TestDescription test, SkipReason reason)` Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
`default 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.
`default void`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo test case.

Metodi pubblici

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala il termine dell'esecuzione di un singolo test case.

Se testFailed(TestDescription, FailureDescription) non è stato invocato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione del test case.

Parametri
`test`	`TestDescription`: identifica il test
`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

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 di 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 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 del 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. 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()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

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()`

testStarted

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription), se possibile.

Parametri
`test`	`TestDescription`: identifica il test