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.

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

Classi di sottoclasse dirette note

JsonHttpTestResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	Un report sui risultati che codifica i risultati delle metriche di test e le informazioni su branch e dispositivo in JSON e li invia tramite POST a un endpoint di servizio HTTP.
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.
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.
ShardListener	Un `ITestInvocationListener` che raccoglie i risultati da uno shard di chiamata (ovvero una suddivisione di chiamate da eseguire in parallelo su più risorse) e li inoltra a un altro ascoltatore.
SuiteResultReporter	Raccogliere i risultati dei test per un'intera chiamata della suite e generare i risultati finali.
XmlResultReporter	Scrive i risultati di JUnit in file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

Classi di sottoclasse indirette note

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Report che consente di generare report in un determinato formato.
XmlFormattedGeneratorReporter	Implementazione del `FormattedGeneratorReporter` che formatta la suite in un formato XML.

Un ITestInvocationListener che raccoglierà tutti i risultati del test.

Sebbene le strutture di dati utilizzate in questo oggetto siano sicure per i thread, i callback ITestInvocationListener devono essere chiamati nell'ordine corretto.

Riepilogo

Costruttori pubblici
`CollectingTestListener()`

Metodi pubblici
`IBuildInfo`	`getBuildInfo()` Questo metodo è deprecato. fare affidamento sul `IBuildInfo` da `getInvocationContext()`.
`TestRunResult`	`getCurrentRunResults()` Recupera i risultati dell'esecuzione del test corrente.
`int`	`getExpectedTests()` Restituisce il numero di test previsti.
`IInvocationContext`	`getInvocationContext()` Restituisce il contesto di chiamata registrato tramite `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`
	`getMergedTestRunResults()` Restituisce la raccolta unita dei risultati di tutte le esecuzioni in diversi tentativi.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Restituisce il `IInvocationContext` del modulo associato ai risultati.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Restituisce una copia della mappa contenente tutti i file registrati associati al modulo
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Restituisce una copia della mappa contenente tutti i file registrati non associati a un esecuzione di test o a un modulo.
`int`	`getNumAllFailedTestRuns()` Restituisce il numero totale di esecuzioni di test in uno stato di errore
`int`	`getNumAllFailedTests()` Restituisce il numero totale di test in uno stato di errore (solo i test non riusciti, gli errori di ipotesi non vengono conteggiati).
`int`	`getNumTestsInState(TestResult.TestStatus status)` Restituisce il numero di test in un determinato stato per questa esecuzione.
`int`	`getNumTotalTests()` Restituisce il numero totale di test completati per tutte le esecuzioni.
`IBuildInfo`	`getPrimaryBuildInfo()` Restituisce le informazioni sulla build principale registrate tramite `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getRunResults()` Questo metodo è deprecato. Utilizza `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Restituire il `TestRunResult` per un singolo tentativo.
`int`	`getTestRunAttemptCount(String testRunName)` Restituisce il numero di tentativi per un determinato nome di esecuzione del test.
	`getTestRunAttempts(String testRunName)` Recupera tutti i tentativi per un `TestRunResult` di una determinata esecuzione del test.
	`getTestRunForAttempts(int attempt)` Recupera tutti i risultati per un determinato tentativo.
	`getTestRunNames()` Restituisce tutti i nomi per tutte le esecuzioni del test.
`boolean`	`hasFailedTests()` Restituisce se l'invocazione ha avuto test di fallimento o di presupposto non riusciti.
`boolean`	`hasTestRunResultsForName(String testRunName)` Restituisce se un determinato nome di esecuzione del test ha risultati.
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`logAssociation(String dataName, LogFile logFile)`
`void`	`setBuildInfo(IBuildInfo buildInfo)` Questo metodo è deprecato. Non è più necessario per i test.
`void`	`setMergeStrategy(MergeStrategy strategy)` Imposta il valore `MergeStrategy` da utilizzare per l'unione dei risultati.
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failure)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber)`
`void`	`testRunStarted(String name, int numTests)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped(long elapsedTime)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Metodi protetti
`final void`	`clearModuleLogFiles()` Consente di pulire il file del modulo in modo da evitare di trasportarlo per troppo tempo.
`final void`	`clearResultsForName(String testRunName)` Consente di cancellare i risultati per un determinato nome di esecuzione.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Attiva/disattiva l'opzione "Metriche aggregate"

Costruttori pubblici

CollectingTestListener

public CollectingTestListener ()

Metodi pubblici

getBuildInfo

public IBuildInfo getBuildInfo ()

Questo metodo è deprecato.
affidati alla IBuildInfo da getInvocationContext().

Restituisce le informazioni sulla build.

Ritorni
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Recupera i risultati dell'esecuzione del test corrente.

Tieni presente che i risultati potrebbero non essere completi. Ti consigliamo di testare il valore di TestRunResult.isRunComplete() e/o (@link TestRunResult#isRunFailure()}, se opportuno, prima di elaborare i risultati.

Ritorni
`TestRunResult`	`TestRunResult` che rappresenta i dati raccolti durante l'ultima esecuzione del test

getExpectedTests

public int getExpectedTests ()

Restituisce il numero di test previsti. Può essere diverso da getNumTotalTests() se alcuni test non sono stati eseguiti.

Ritorni
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Restituisce il contesto di chiamata registrato tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Ritorni
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

Restituisce la raccolta unita dei risultati di tutte le esecuzioni in diversi tentativi.

Se sono presenti più risultati, ogni esecuzione del test viene unita e il risultato più recente del test sovrascrive i risultati delle esecuzioni precedenti. Le esecuzioni del test sono ordinate in base al numero di tentativi.

Le metriche per lo stesso tentativo verranno unite in base alla preferenza impostata da aggregate-metrics. Le metriche finali saranno quelle dell'ultimo tentativo.

Ritorni

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Restituisce il IInvocationContext del modulo associato ai risultati.

Parametri
`testRunName`	`String`: il nome assegnato da {`testRunStarted(String, int)`.

Ritorni
`IInvocationContext`	Il `IInvocationContext` del modulo per un determinato nome di esecuzione del test `null` se non sono presenti risultati per quel nome.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Restituisce una copia della mappa contenente tutti i file registrati associati al modulo

Ritorni
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Restituisce una copia della mappa contenente tutti i file registrati non associati a un esecuzione di test o a un modulo.

Ritorni
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Restituisce il numero totale di esecuzioni di test in uno stato di errore

Ritorni
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Restituisce il numero totale di test in uno stato di errore (solo i test non riusciti, gli errori di ipotesi non vengono conteggiati).

Ritorni
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Restituisce il numero di test in un determinato stato per questa esecuzione.

Parametri
`status`	`TestResult.TestStatus`

Ritorni
`int`

getNumTotalTests

public int getNumTotalTests ()

Restituisce il numero totale di test completati per tutte le esecuzioni.

Ritorni
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Restituisce le informazioni sulla build principale registrate tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext). La build principale è la build restituita dal primo fornitore di build della configurazione in esecuzione. Restituisce null se non è presente alcun contesto (nessuna compilazione per lo scenario di test).

Ritorni
`IBuildInfo`

getRunResults

public  getRunResults ()

Questo metodo è deprecato.
Utilizza getMergedTestRunResults()

Restituisce i risultati di tutte le esecuzioni del test.

Ritorni

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Restituire il TestRunResult per un singolo tentativo.

Parametri
`testRunName`	`String`: il nome assegnato da {`testRunStarted(String, int)`.
`attempt`	`int`: l'ID tentativo.

Ritorni
`TestRunResult`	L'`TestRunResult` per il nome e l'ID tentativo specificati o `null` se non esiste.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Restituisce il numero di tentativi per un determinato nome di esecuzione del test.

Parametri
`testRunName`	`String`: il nome assegnato da {`testRunStarted(String, int)`.

Ritorni
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Recupera tutti i tentativi per un TestRunResult di una determinata esecuzione del test.

Parametri
`testRunName`	`String`: il nome assegnato da {`testRunStarted(String, int)`.

Ritorni
	Tutti i `TestRunResult` per una determinata esecuzione del test, ordinati per tentativi.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Recupera tutti i risultati per un determinato tentativo.

Parametri
`attempt`	`int`: il tentativo per cui vogliamo i risultati.

Ritorni
	Tutti i `TestRunResult` per un determinato tentativo.

getTestRunNames

public  getTestRunNames ()

Restituisce tutti i nomi per tutte le esecuzioni del test.

Queste esecuzioni di test potrebbero essere state eseguite più volte con tentativi diversi.

Ritorni

hasFailedTests

public boolean hasFailedTests ()

Restituisce se l'invocazione ha avuto test di fallimento o di presupposto non riusciti.

Ritorni
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Restituisce se un determinato nome di esecuzione del test ha risultati.

Parametri
`testRunName`	`String`: il nome assegnato da {`testRunStarted(String, int)`.

Ritorni
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Parametri
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (Throwable cause)

Parametri
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Parametri
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Parametri
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Questo metodo è deprecato.
Non più necessario per i test.

Imposta le informazioni sulla compilazione. Da utilizzare solo per i test.

Parametri
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Imposta il valore MergeStrategy da utilizzare per l'unione dei risultati.

Parametri
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Parametri
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parametri
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parametri
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Parametri
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parametri
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Parametri
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parametri
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Parametri
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Parametri
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Parametri
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Parametri
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parametri
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parametri
`test`	`TestDescription`

Metodi protetti

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Consente di pulire il file del modulo in modo da evitare di trasportarlo per troppo tempo.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Consente di cancellare i risultati per un determinato nome di esecuzione. Da utilizzare solo in alcuni casi, ad esempio come aggregatore dei risultati.

Parametri
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Attiva/disattiva l'opzione "Metriche aggregate"

Parametri
`aggregate`	`boolean`