BugreportCollector
public class BugreportCollector
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.BugreportCollector |
Un ITestInvocationListener
pass-through che raccoglie segnalazioni di bug quando si verificano eventi configurabili e quindi chiama ITestInvocationListener#testLog
sui relativi elementi figlio dopo la raccolta di ogni segnalazione di bug.
- Cattura dopo ciascuno se un test case ha fallito
- Cattura dopo ogni test case
- Cattura dopo ogni test case fallito
- Catturare
Riepilogo
Classi nidificate | |
---|---|
enum | BugreportCollector.Filter |
enum | BugreportCollector.Freq |
enum | BugreportCollector.Noun |
class | BugreportCollector.Predicate Un predicato completo che descrive quando acquisire una segnalazione di bug. |
enum | BugreportCollector.Relation |
interface | BugreportCollector.SubPredicate
|
Campi | |
---|---|
public static final BugreportCollector.Predicate | AFTER_FAILED_TESTCASES Un predicato predefinito che si attiva dopo ogni testcase non riuscito |
public static final BugreportCollector.Predicate | AT_START Un predicato predefinito che si attiva all'inizio della prima invocazione |
Costruttori pubblici | |
---|---|
BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice) |
Metodi pubblici | |
---|---|
void | addPredicate ( BugreportCollector.Predicate p) |
void | blockUntilIdle () Blocca finché il raccoglitore non raccoglie segnalazioni di bug. |
TestSummary | getSummary () Consente a InvocationListener di restituire un riepilogo. |
void | invocationEnded (long elapsedTime) Segnala che l'invocazione è terminata, con esito positivo oa causa di una condizione di errore. |
void | invocationFailed (Throwable cause) Segnala una chiamata incompleta a causa di una condizione di errore. |
void | invocationStarted ( IInvocationContext context) Segnala l'inizio dell'invocazione del test. |
void | setAsynchronous (boolean asynchronous) Imposta se la raccolta bugreport deve raccogliere il bugreport in un thread diverso ( |
void | setDescriptiveName (String name) Imposta il nome descrittivo da utilizzare durante la registrazione di segnalazioni di bug. |
void | setDeviceWaitTime (int waitTime) Imposta il tempo (in secondi) di attesa che il dispositivo sia online prima di provare a acquisire una segnalazione di bug. |
void | testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Segnala la fine dell'esecuzione di un singolo test case. |
void | testFailed ( TestDescription test, String trace) Segnala il fallimento di un singolo test case. |
void | testIgnored ( TestDescription test) Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Fornisce il registro associato o i dati di debug dalla chiamata al test. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Segnala la fine dell'esecuzione del test. |
void | testRunFailed (String errorMessage) L'esecuzione del test dei rapporti non è stata completata a causa di un errore irreversibile. |
void | testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStopped (long elapsedTime) Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente. |
void | testStarted ( TestDescription test) Segnala l'inizio di un singolo test case. |
Campi
DOPO_FAILED_TEST CASES
public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES
Un predicato predefinito che si attiva dopo ogni testcase non riuscito
AT_START
public static final BugreportCollector.Predicate AT_START
Un predicato predefinito che si attiva all'inizio della prima invocazione
Costruttori pubblici
BugreportCollector
public BugreportCollector (ITestInvocationListener listener, ITestDevice testDevice)
Parametri | |
---|---|
listener | ITestInvocationListener |
testDevice | ITestDevice |
Metodi pubblici
addPredicate
public void addPredicate (BugreportCollector.Predicate p)
Parametri | |
---|---|
p | BugreportCollector.Predicate |
blockUntilIdle
public void blockUntilIdle ()
Blocca finché il raccoglitore non raccoglie segnalazioni di bug. Se il raccoglitore non sta raccogliendo attivamente una segnalazione di bug, torna immediatamente
getSommario
public TestSummary getSummary ()
Consente a InvocationListener di restituire un riepilogo.
ritorna | |
---|---|
TestSummary | Un TestSummary riepiloga l'esecuzione o null |
invocazioneFine
public void invocationEnded (long elapsedTime)
Segnala che l'invocazione è terminata, con esito positivo oa causa di una condizione di errore.
Verrà automaticamente chiamato dal framework TradeFederation.Parametri | |
---|---|
elapsedTime | long : il tempo trascorso dall'invocazione in ms |
invocazione non riuscita
public void invocationFailed (Throwable cause)
Segnala una chiamata incompleta a causa di una condizione di errore.
Verrà automaticamente chiamato dal framework TradeFederation.Parametri | |
---|---|
cause | Throwable : la causa Throwable del fallimento |
invocationStarted
public void invocationStarted (IInvocationContext context)
Segnala l'inizio dell'invocazione del test.
Verrà automaticamente chiamato dal framework TradeFederation. I reporter devono sovrascrivere questo metodo per supportare più dispositivi di reporting.
Parametri | |
---|---|
context | IInvocationContext : informazioni sull'invocazione |
setAsincrono
public void setAsynchronous (boolean asynchronous)
Imposta se la raccolta bugreport deve raccogliere il bugreport in un thread diverso ( asynchronous = true
) o bloccare il chiamante fino a quando il bugreport non viene acquisito ( asynchronous = false
).
Parametri | |
---|---|
asynchronous | boolean |
setDescriptiveName
public void setDescriptiveName (String name)
Imposta il nome descrittivo da utilizzare durante la registrazione di segnalazioni di bug. Se null
, BugreportCollector
ritornerà al comportamento predefinito di serializzazione del nome dell'evento che ha causato la raccolta del bugreport.
Parametri | |
---|---|
name | String |
setDeviceWaitTime
public void setDeviceWaitTime (int waitTime)
Imposta il tempo (in secondi) di attesa che il dispositivo sia online prima di provare a acquisire una segnalazione di bug. In caso negativo, non verrà eseguito alcun controllo. Qualsiasi DeviceNotAvailableException
incontrata durante questo controllo verrà registrata e ignorata.
Parametri | |
---|---|
waitTime | int |
testAssumptionFailure
public 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 : traccia dello stack dell'errore |
testTerminato
public void testEnded (TestDescription test,testMetrics)
Segnala la fine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testMetrics | ERROR(/Map) delle metriche emesse |
test non riuscito
public void testFailed (TestDescription test, String trace)
Segnala il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack dell'errore |
testIgnorato
public 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 |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Fornisce il registro associato o i dati di debug dalla chiamata al test.
Deve essere chiamato primaERROR(/ITestInvocationListener#invocationFailed(Throwable))
o ERROR(/ITestInvocationListener#invocationEnded(long))
Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log dell'host e, se applicabile, il logcat del dispositivo.Parametri | |
---|---|
dataName | String : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName |
dataType | LogDataType : il LogDataType dei dati |
dataStream | InputStreamSource : InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante una volta completato. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> di tipo diverso, quindi dobbiamo usare HashMap qui.
Parametri | |
---|---|
elapsedTime | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
L'esecuzione del test dei rapporti 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)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test in esecuzione |
testRunStopped
public void testRunStopped (long elapsedTime)
Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.
TODO: attualmente inutilizzato, considerare la rimozione
Parametri | |
---|---|
elapsedTime | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
testIniziato
public void testStarted (TestDescription test)
Segnala l'inizio di un singolo test case. L'interfaccia precedente dovrebbe usare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test | TestDescription : identifica il test |
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Last updated 2022-08-15 UTC.