Listener ITestInvocation

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Sottoclassi indirette note . AggregatePostProcessor Un aggregatore di metriche che fornisce i valori min, massimo, media, varianza, deviazione standard, totale, conteggio e facoltativamente percentili per le metriche numeriche raccolte durante le esecuzioni di test di iterazioni multiple trattandoli come doppi.  AtraceCollector Un IMetricCollector che esegue un atrace durante un test e raccoglie il risultato e il log alla chiamata.  AtraceRunMetricCollector Raccoglie le tracce da tutta la directory di test nella directory specificata dal dispositivo di test, registrare la directory di test e pubblicare i file di traccia nella directory di test e aggregare le metriche.  MediaPostProcessor Implementazione di post-processore che calcola la media dell'elenco di metriche.  BaseDeviceMetricCollector Base dell'implementazione 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 Il valore IPostProcessor di base che ogni implementazione dovrebbe estendere.  BluetoothConnectionLatenzaCollector Il raccoglitore invierà ai dispositivi una configurazione predefinita della metrica relativa alla durata delle statistiche e raccoglierà Durata della connessione Bluetooth per ogni profilo.  BluetoothConnectionStateCollector Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà lo stato di connessione numero per ogni profilo.  BluetoothConnectionSuccessRatePostProcessor Implementazione di post-processore che calcola la percentuale di successo per un profilo Bluetooth Utilizza "corrispondenza chiave-metrica" per specificare metriche che contengono stati della connessione Bluetooth in valori numerici Esempio di array [0, 1, 2, 3, 0, 1, 2, 3].  BluetoothHciSnoopLogCollector Collettore per abilitare il logging di analisi HCI Bluetooth sul DUT e raccogliere il registro per ogni test.  BugreportCollector Un ITestInvocationListener passthrough che raccoglie segnalazioni di bug quando eventi configurabili si verificano e quindi chiama ITestInvocationListener#testLog sui relativi elementi secondari dopo ogni la segnalazione di bug.  BugreportzOnFailureCollector Raccogli una segnalazione di bug quando uno scenario di test ha esito negativo.  BugreportzOnTestCaseFailureCollector Raccogli una segnalazione di bug quando uno scenario di test in un'esecuzione ha esito negativo.  ClangCodeCoperturaCollector Un BaseDeviceMetricCollector che estrarrà Clang le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  CollectingTestListener Un ITestInvocationListener che raccoglierà tutti i risultati del test.  CommandStatusGestori Gestore che aiuta a monitorare e aggiornare lo stato di una chiamata.  ConditionFailureMonitor Monitora eventuali errori derivanti dalla chiamata.  ConsoleResultReporter Reporter dei risultati per stampare i risultati del test nella console.  CountTestCasesCollector Conteggia e segnala il numero di scenari di test per un determinato IRemoteTest.  DebugHostLogOnFailureCollector Il raccoglitore che raccoglierà e registrerà i log del lato host quando si verifica un errore dello scenario di test.  DeviceReleaseReporter L'autore della release del dispositivo che gestisce la comunicazione con il genitore elabora il/i dispositivo/i dispositivi da rilasciate.  DeviceTraceCollector Il raccoglitore che avvierà l'analisi perfetta all'avvio di un test e il file di traccia del log alla fine.  Dispositivo non disponibile Questo listener tenta di acquisire solo il DNAE di uno scenario di test.  EventiLoggerListener Listener che registra tutti gli eventi ricevuti in un file FileProtoResultReporter Reporter protocollo che scarica TestRecord in un file.  FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo ed esegue il pull come file dal dispositivo.  FilePullerLogCollector Logger del file segnalato dal lato dispositivo.  FilteredResultForwarder Variante di ResultForwarder che consente di utilizzare solo una lista consentita di TestDescription segnalato.  FormattatoGeneratorReporter Reporter che permette di generare report in un determinato formato.  GcovCodeCoperturaCollector Un BaseDeviceMetricCollector che eseguirà il pull dei gcov le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  GcovKernelCodeReachCollector Un BaseDeviceMetricCollector che eseguirà il pull del kernel gcov misurazioni della copertura dai debug e dal dispositivo e alla fine le registra come test artefatti.  GranularRetriableTestWrapper.StartEndCollector Assistente di classe per rilevare l'inizio e la fine della corsa.  HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche statistiche dal lato host utilizzando l'utilità Statistiche tramite comandi SQL.  ICommandScheduler.IScheduleInvocationListener Listener di eventi di chiamata al completamento della chiamata.  Listener ILogSaver Consente a ITestInvocationListener di rilevare quando vengono salvati i file di log.  IMetricCollector Questa interfaccia verrà aggiunta come decoratore durante i report sui risultati dei test per raccogliere metriche corrispondenti.  IPostProcess I post-responsabili sono un oggetto della Trade Federation pensato per consentire l'elaborazione di metriche e log DOPO i test e PRIMA della segnalazione dei risultati.  IShardableListener Un elemento ITestInvocationListener di cui è possibile eseguire lo sharding.  RisultatiGranulariAssistenzaI Interfaccia che specifica se un ITestInvocationListener supporta la ricezione di informazioni o meno.  ITestSummaryListener Interfaccia che consente a ITestInvocationListener di scambiare alcune informazioni limitate tramite riassunti.  InvocationToJUnitResultForwarder Un corso che ascolta gli eventi ITestInvocationListener e li inoltra a un TestListener.  JarHostTest.HostTestListener Listener di wrapper che inoltra tutti gli eventi tranne testRunStarted() e testRunEnded() al listener incorporato.  JavaCodeCoperturaCollector Un'BaseDeviceMetricCollector che eseguirà il pull di Java le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  JsonHttpTestResultReporter Un reporter dei risultati che codifica i risultati delle metriche del test e le informazioni sul dispositivo in JSON e POST in un endpoint di servizio HTTP LUCIResultReporter Un reporter dei risultati che salva i risultati dei test richiesti da ResultDB e LUCI in formato JSON (go/result-sink) e registra la posizione del file nella console.  LastShardDetector Quando si esegue lo sharding locale, a volte vogliamo eseguire solo alcune azioni quando l'ultimo shard raggiunge invocationEnded(long).  LegacySubprocessResultsReporter Un'implementazione bloccata del reporter sui risultati del sottoprocesso che dovrebbe rimanere compatibile con versioni precedenti di TF/CTS (ad es. 8+), nonostante le modifiche nella sua superclasse.  LogSaverResultForwarder Un ResultForwarder per il salvataggio dei log con il risparmio file globale.  LogcatCrashResultForwarder Listener speciale: in caso di errori (arresto anomalo del processo di strumentazione), tenterà di estrarre da logcat per l'arresto anomalo e lo aggiunge al messaggio di errore associato al test.  LogcatOnFailureCollector Raccoglitore che acquisirà e registra un logcat quando uno scenario di test ha esito negativo.  LogcatTimingMetricCollector Un raccoglitore di metriche che raccoglie informazioni sulle tempistiche (ad es. l'ora di cambio dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare gli indicatori di inizio e fine di un dell'evento dalle righe logcat.  Processore post-file-Metrica Utilizzato per caricare il file di log delle metriche raccolto durante il livello di test e di esecuzione.  MetricsXMLResultReporter MetricsXMLResultReporter scrive le metriche di test ed esegue le metriche in un file XML in una cartella specificata in base al parametro Metrics-folder nella fase di invocationEnded del test.  ModuleListener Listener associato a ogni IRemoteTest di ogni modulo per raccogliere l'elenco di che consentono di analizzare i dati e visualizzare i risultati.  ModuleLogcatCollector Versione del raccoglitore logcat ma per il modulo.  NameMangleListener Un listener proxy per tradurre nomi di metodi, classi e pacchetti di test quando vengono riportati 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 di testo/metrica binaria perfetto in coppie chiave-valore Espandere in modo ricorsivo i messaggi e i campi di protocollo con valori di stringa fino a quando il campo con rilevato un valore numerico.  PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente estrarre i file perfetti dal dispositivo e raccogliere le metriche al suo interno.  PrettyTestEventLogger Logger che corrisponde agli eventi e li registra per semplificare il debug.  ProtoResultReporter Il reporter dei risultati crea un protobuf TestRecord con tutti i risultati all'interno.  PythonBinaryHostTest.PythonForwarder Funzione di inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario.  RiavviaReasonCollector Il raccoglitore che raccoglie il riavvio del dispositivo durante l'esecuzione del test e li segnala per motivo e conteggi.  RemoteTestTimeOutEnforcer Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e di non riuscire se l'operazione viene completata correttamente durante un determinato timeout.  ReportPassedTest Segnala in un file i possibili filtri per escludere il test superato.  Aggregatore dei risultati Inoltro speciale che aggrega i risultati quando necessario, in base alla strategia di ripetizione che è prese.  ResultAndLogForwarder Forwarder per i risultati e gli eventi dei log.  Inoltro dei risultati Un elemento ITestInvocationListener che inoltra i risultati della chiamata a un elenco di altri listener.  RiprovaLogSaverResultForwarder Forwarder che gestisce anche il passaggio del tentativo attuale.  RiprovaRisultatoInoltratore Un'estensione di ResultForwarder che esegue sempre il push a un determinato numero di tentativo.  RuntimeRiavviaCollector Raccoglitore che raccoglie i timestamp dei riavvii del runtime (arresti anomali del server di sistema) durante il test se ce ne sono.  ScreenshotOnFailureCollector Il raccoglitore che acquisirà e registrerà uno screenshot quando uno scenario di test non va a buon fine.  ShardListener Un elemento ITestInvocationListener che raccoglie i risultati da uno shard di chiamata (ovvero un la suddivisione della chiamata in modo che venga eseguita su più risorse in parallelo) e le inoltra a un'altra e ascolto.  ShardMainResultForwarder Un ResultForwarder che combina i risultati delle chiamate di test con sharding.  ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre la showmap i file dal dispositivo e raccoglierne le metriche.  StatsdBeforeAfterGaugeMetricPostProcessor Un post-processore che elabora le metriche raccolte in un "prima/dopo" un tipo di approccio, cioè StatsdEventMetricPostProcessor Un post-processore che elabora le metriche degli eventi nei report statistici in coppie chiave-valore, utilizzando i formattatori specificati sul processore.  StatsdGenericPostProcessor Un post-processore che elabora i report statistici dei protocolli binari in coppie chiave-valore espandendo la funzione come struttura ad albero.  StreamProtoResultReporter Un'implementazione di ProtoResultReporter SubprocessResultsReporter Implementa ITestInvocationListener in modo che venga specificato come result_reporter e inoltra da nel sottoprocesso i risultati di test, esecuzioni di test e chiamate di test.  SuiteResultReporter Raccogli i risultati dei test per la chiamata di un'intera suite e invia i risultati finali.  TestTimeoutEnforcer Listener che consentono di controllare il tempo di esecuzione di un determinato caso di test e di non riuscire se l'esecuzione viene completata correttamente durante un determinato timeout.  TextResultReporter Un reporter dei risultati di un test che inoltra i risultati alla stampante dei risultati di testo della JUnit.  TraceCmdCollector Un IMetricCollector che raccoglie le tracce durante il test utilizzando trace-cmd e le registra in la chiamata.  TradefedSandboxRunner.StubScheduleInvocationListener Uno stub IScheduledInvocationListener che non fa nulla.  XmlFormattedGeneratorReporter Implementazione di FormattedGeneratorReporter, che formatta i risultati della suite in un file XML formato.  XmlResultReporter Scrive i risultati di JUnit in un file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

---

Listener per i risultati del test dalla chiamata al test.

Una chiamata di test può a sua volta includere più esecuzioni di test, quindi la sequenza di chiamate sarà

• invocationStarted(BuildInfo)
• testRunStarted
• testIniziato
• [TestNon riuscito]
• testTerminato
• …
• testRunEnded
• …
• testRunStarted
• …
• testRunEnded
• [invocationFailed]
• [TestLog+]
• chiamata terminata
• getRiepilogo

Riepilogo

Metodi pubblici
default TestSummary	getSummary() Consente a InvocationListener di restituire un riepilogo.
default void	invocationEnded(long elapsedTime) Report che la chiamata è stata terminata, correttamente o a causa di un errore .
default void	invocationFailed(FailureDescription failure) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
default void	invocationFailed(Throwable cause) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
default void	invocationInterrupted() Chiamato all'arresto dello scheduler, offre alla chiamata l'opportunità di fare qualcosa prima in fase di chiusura.
default void	invocationSkipped(SkipReason reason) Segnala una chiamata come saltata
default void	invocationStarted(IInvocationContext context) Segnala l'inizio della chiamata di test.
default void	testModuleEnded() Segnala la fine dell'esecuzione di un modulo.
default void	testModuleStarted(IInvocationContext moduleContext) Segnala l'inizio di un modulo in esecuzione.

Metodi pubblici

getRiepilogo

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
TestSummary	Un elemento TestSummary che riepiloga l'esecuzione oppure un valore null

chiamata terminata

public void invocationEnded (long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un errore .

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime	long: il tempo trascorso della chiamata in ms

chiamata non riuscita

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

chiamata non riuscita

public void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause	Throwable: la causa Throwable dell'errore

chiamatainterrotta

public void invocationInterrupted ()

Chiamato all'arresto dello scheduler, offre alla chiamata l'opportunità di fare qualcosa prima in fase di chiusura.

chiamataIgnorata

public void invocationSkipped (SkipReason reason)

Segnala una chiamata come saltata

Parametri
reason	SkipReason

chiamataIniziata

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

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

Parametri
context	IInvocationContext: informazioni sulla chiamata

testModuloTerminato

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuloIniziato

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene usato solo durante una corsa che usa moduli: runner basati su suite.

Parametri
moduleContext	IInvocationContext: il IInvocationContext del modulo.