RecopilarTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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


Un elemento ITestInvocationListener que recopilará todos los resultados de la prueba

Aunque las estructuras de datos que se usan en este objeto son seguras para los subprocesos, las devoluciones de llamada ITestInvocationListener deben llamarse en el orden correcto.

Resumen

Constructores públicos

CollectingTestListener()

Métodos públicos

IBuildInfo getBuildInfo()

Este método dejó de estar disponible. se basan en el IBuildInfo de getInvocationContext().

TestRunResult getCurrentRunResults()

Obtiene los resultados de la ejecución de la prueba actual.

int getExpectedTests()

Muestra el recuento de pruebas esperado.

IInvocationContext getInvocationContext()

Muestra el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults()

Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

IInvocationContext getModuleContextForRunResult(String testRunName)

Muestra el IInvocationContext del módulo asociado con los resultados.

MultiMap<String, LogFile> getModuleLogFiles()

Devuelve una copia del mapa que contiene todos los archivos registrados asociados con el módulo.

MultiMap<String, LogFile> getNonAssociatedLogFiles()

Devuelve una copia del mapa que contiene todos los archivos registrados no asociados con una ejecución de prueba o una módulo.

int getNumAllFailedTestRuns()

Devuelve la cantidad total de ejecuciones de pruebas en estado de error.

int getNumAllFailedTests()

Devuelve la cantidad total de pruebas en un estado de error (solo con errores; las suposiciones con errores no lo hacen contar para ese fin).

int getNumTestsInState(TestStatus status)

Muestra la cantidad de pruebas en un estado determinado para esta ejecución.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Para brindar compatibilidad con el tipo de estado anterior

int getNumTotalTests()

Muestra la cantidad total de pruebas completas para todas las ejecuciones.

IBuildInfo getPrimaryBuildInfo()

Muestra la información de compilación principal que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getRunResults()

Este método dejó de estar disponible. Usa getMergedTestRunResults().

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Muestra el TestRunResult de un solo intento.

int getTestRunAttemptCount(String testRunName)

Muestra la cantidad de intentos para un nombre de ejecución de prueba determinado.

getTestRunAttempts(String testRunName)

Obtiene todos los intentos de un TestRunResult de una ejecución de prueba determinada.

getTestRunForAttempts(int attempt)

Obtiene todos los resultados de un intento determinado.

getTestRunNames()

Muestra todos los nombres de todas las ejecuciones de prueba.

boolean hasFailedTests()

Muestra si la invocación tuvo pruebas con errores o si la suposición falló.

boolean hasTestRunResultsForName(String testRunName)

Muestra si un nombre de ejecución de prueba determinado tiene resultados.

void invocationEnded(long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

void invocationFailed(Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

void invocationSkipped(SkipReason reason)

Informa una invocación como omitida

void invocationStarted(IInvocationContext context)

Informa el inicio de la invocación de prueba.

boolean isDisabled()

Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación).

void logAssociation(String dataName, LogFile logFile)

En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) directo no es posible realizar la devolución de llamada.

void setBuildInfo(IBuildInfo buildInfo)

Este método dejó de estar disponible. Ya no es necesario para las pruebas.

void setDisable(boolean isDisabled)

Establece si el objeto se debe inhabilitar.

void setMergeStrategy(MergeStrategy strategy)

Establece el objeto MergeStrategy que se usará cuando se combinen los resultados.

void testAssumptionFailure(TestDescription test, String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Se llama cuando una prueba atómica marca que asume una condición falsa.

void testEnded(TestDescription test, long endTime, testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente.

void testEnded(TestDescription test, testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

void testFailed(TestDescription test, FailureDescription failure)

Informa el error de un caso de prueba individual.

void testFailed(TestDescription test, String trace)

Informa el error de un caso de prueba individual.

void testIgnored(TestDescription test)

Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

void testModuleEnded()

Informa el final de la ejecución de un módulo.

void testModuleStarted(IInvocationContext moduleContext)

Informa el comienzo de la ejecución de un módulo.

void testRunEnded(long elapsedTime, runMetrics)

Informa el final de la ejecución de la prueba.

void testRunFailed(FailureDescription failure)

No se pudo completar la ejecución de prueba de los informes debido a un error que describe FailureDescription.

void testRunFailed(String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

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

Informa el inicio de una ejecución de prueba.

void testRunStarted(String name, int numTests)

Informa el inicio de una ejecución de prueba.

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

Informa el inicio de una ejecución de prueba.

void testRunStopped(long elapsedTime)

La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario.

void testSkipped(TestDescription test, SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera.

void testStarted(TestDescription test, long startTime)

Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), donde también especificamos cuándo se realizó la prueba. comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para obtener una medición precisa.

void testStarted(TestDescription test)

Informa el inicio de un caso de prueba individual.

Métodos protegidos

final void clearModuleLogFiles()

Permite limpiar el archivo del módulo para que no se lleven durante mucho tiempo.

final void clearResultsForName(String testRunName)

Permite borrar los resultados de un nombre de ejecución determinado.

void setIsAggregrateMetrics(boolean aggregate)

Activar o desactivar “Métricas agregadas” opción

Constructores públicos

RecopilarTestListener

public CollectingTestListener ()

Métodos públicos

getBuildInfo

public IBuildInfo getBuildInfo ()

Este método dejó de estar disponible.
se basan en el IBuildInfo de getInvocationContext().

Muestra la información de compilación.

Muestra
IBuildInfo

getCurrentRunResults.

public TestRunResult getCurrentRunResults ()

Obtiene los resultados de la ejecución de la prueba actual.

Ten en cuenta que es posible que los resultados no estén completos. Se recomienda probar el valor de TestRunResult.isRunComplete() o (@link TestRunResult#isRunFailure()} según corresponda antes de procesar los resultados.

Muestra
TestRunResult El objeto TestRunResult que representa los datos recopilados durante la última ejecución de prueba

getExpectedTests

public int getExpectedTests ()

Muestra el recuento de pruebas esperado. Podría diferir de getNumTotalTests() si no se ejecutaron algunas pruebas.

Muestra
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Muestra
IInvocationContext

getMergedTestRunResults.

public  getMergedTestRunResults ()

Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

Si hay varios resultados, cada ejecución de prueba se combina con el resultado más reciente. y reemplazar los resultados de las ejecuciones anteriores. Las ejecuciones de prueba se ordenan según el número de intento.

Las métricas del mismo intento se combinarán según la preferencia que estableció aggregate-metrics. Las métricas finales serán las del último intento.

Muestra

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Muestra el IInvocationContext del módulo asociado con los resultados.

Parámetros
testRunName String: Es el nombre que proporciona {testRunStarted(String, int).

Muestra
IInvocationContext El IInvocationContext del módulo para un nombre de ejecución de prueba determinado: null si no hay resultados para ese nombre.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados asociados con el módulo.

Muestra
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados no asociados con una ejecución de prueba o una módulo.

Muestra
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Devuelve la cantidad total de ejecuciones de pruebas en estado de error.

Muestra
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Devuelve la cantidad total de pruebas en un estado de error (solo con errores; las suposiciones con errores no lo hacen contar para ese fin).

Muestra
int

getNumTestsInState.

public int getNumTestsInState (TestStatus status)

Muestra la cantidad de pruebas en un estado determinado para esta ejecución.

Parámetros
status TestStatus

Muestra
int

getNumTestsInState.

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Para brindar compatibilidad con el tipo de estado anterior

Parámetros
ddmlibStatus TestResult.TestStatus

Muestra
int

getNumTotalTests.

public int getNumTotalTests ()

Muestra la cantidad total de pruebas completas para todas las ejecuciones.

Muestra
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Muestra la información de compilación principal que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext). La compilación principal es la que devuelve la primera de compilación de la configuración en ejecución. El resultado es nulo si no hay contexto (no hay ninguna compilación en caso de prueba).

Muestra
IBuildInfo

getRunResults

public  getRunResults ()

Este método dejó de estar disponible.
Usa getMergedTestRunResults().

Muestra los resultados de todas las ejecuciones de prueba.

Muestra

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Muestra el TestRunResult de un solo intento.

Parámetros
testRunName String: Es el nombre que proporciona {testRunStarted(String, int).

attempt int: Es el ID del intento.

Muestra
TestRunResult El TestRunResult para el nombre y el ID del intento específicos, o bien null si no existe.

getTestRunAttemptCount.

public int getTestRunAttemptCount (String testRunName)

Muestra la cantidad de intentos para un nombre de ejecución de prueba determinado.

Parámetros
testRunName String: Es el nombre que proporciona {testRunStarted(String, int).

Muestra
int

getTestRunAttempts.

public  getTestRunAttempts (String testRunName)

Obtiene todos los intentos de un TestRunResult de una ejecución de prueba determinada.

Parámetros
testRunName String: Es el nombre que proporciona {testRunStarted(String, int).

Muestra
Todos los TestRunResult de una ejecución de prueba determinada, ordenados por intentos.

getTestRunForAttempts.

public  getTestRunForAttempts (int attempt)

Obtiene todos los resultados de un intento determinado.

Parámetros
attempt int: Es el intento para el que queremos obtener resultados.

Muestra
Son todos los TestRunResult de un intento determinado.

getTestRunNames

public  getTestRunNames ()

Muestra todos los nombres de todas las ejecuciones de prueba.

Es posible que estas ejecuciones de prueba se hayan realizado varias veces con distintos intentos.

Muestra

hasFailedTests

public boolean hasFailedTests ()

Muestra si la invocación tuvo pruebas con errores o si la suposición falló.

Muestra
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Muestra si un nombre de ejecución de prueba determinado tiene resultados.

Parámetros
testRunName String: Es el nombre que proporciona {testRunStarted(String, int).

Muestra
boolean

invocaciónFinalizada

public void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

Se llamará automáticamente a través del marco TradeFederation.

Parámetros
elapsedTime long: El tiempo transcurrido de la invocación en ms

Error de invocación

public void invocationFailed (Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

Se llamará automáticamente a través del marco TradeFederation.

Parámetros
cause Throwable: Es la causa Throwable de la falla.

se omitió el proceso de invocación

public void invocationSkipped (SkipReason reason)

Informa una invocación como omitida

Parámetros
reason SkipReason

iniciación de invocación

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Se llamará automáticamente a través del marco TradeFederation. Los reporteros deben anular este método para admitir informes de varios dispositivos.

Parámetros
context IInvocationContext: Información sobre la invocación

Inhabilitado

public boolean isDisabled ()

Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). De lo contrario, el valor es falso.

Muestra
boolean

Asociación de registro

public void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) directo no es posible realizar la devolución de llamada. Esta devolución de llamada permite proporcionar una asociación sólida de forma explícita.

Parámetros
dataName String: Es el nombre de los datos.

logFile LogFile: El LogFile que se registró antes y debe asociarse con el caso de prueba.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Este método dejó de estar disponible.
Ya no es necesario para las pruebas.

Configura la información de compilación. Solo debe usarse para pruebas.

Parámetros
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

Establece si el objeto se debe inhabilitar. Si está inhabilitado, significa que los pasos de configuración y desconexión se deben omitir. Se puede usar para inhabilitar un objeto de forma predeterminada en el .

Parámetros
isDisabled boolean: Es el estado en el que se debe colocar el objeto.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Establece el objeto MergeStrategy que se usará cuando se combinen los resultados.

Parámetros
strategy MergeStrategy

ErrordeAsuncióndeprueba

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

Parámetros
test TestDescription: Identifica la prueba.

trace String: seguimiento de pila de las fallas

ErrordeAsuncióndeprueba

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica marca que asume una condición falsa.

Parámetros
test TestDescription: Identifica la prueba.

failure FailureDescription: FailureDescription que describe la falla y su contexto

pruebaFinalizada

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener mediciones precisas.

Parámetros
test TestDescription: Identifica la prueba.

endTime long: La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis()

testMetrics : Una ERROR(/Map) de las métricas emitidas

pruebaFinalizada

public void testEnded (TestDescription test, 
                 testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

Si no se invocó testFailed(TestDescription, FailureDescription), esta prueba se completó correctamente. También muestra cualquier par clave-valor. métricas que podrían haberse emitido durante la ejecución del caso de prueba.

Parámetros
test TestDescription: Identifica la prueba.

testMetrics : Una ERROR(/Map) de las métricas emitidas

Prueba con errores

public void testFailed (TestDescription test, 
                FailureDescription failure)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription: Identifica la prueba.

failure FailureDescription: FailureDescription que describe la falla y su contexto

Prueba con errores

public void testFailed (TestDescription test, 
                String trace)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription: Identifica la prueba.

trace String: seguimiento de pila de las fallas

pruebaIgnorada

public void testIgnored (TestDescription test)

Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

Parámetros
test TestDescription: Identifica la prueba.

módulodepruebafinalizado

public void testModuleEnded ()

Informa el final de la ejecución de un módulo.

MódulodepruebaIniciado

public void testModuleStarted (IInvocationContext moduleContext)

Informa el comienzo de la ejecución de un módulo. Esta devolución de llamada está asociada con testModuleEnded() y es opcional en la secuencia. Solo se usa durante una ejecución que usa módulos: ejecutores basados en paquetes.

Parámetros
moduleContext IInvocationContext: Es el IInvocationContext del módulo.

pruebaRunfinalizada

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: No podemos tener dos mapas<> con diferentes tipos, por lo que aquí tenemos que usar HashMap.

Parámetros
elapsedTime long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.

runMetrics : Son pares clave-valor que se informan al final de una ejecución de prueba con Metric.

Error de ejecución de prueba

public void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de los informes debido a un error que describe FailureDescription.

Parámetros
failure FailureDescription: FailureDescription que describe la falla y su contexto

Error de ejecución de prueba

public void testRunFailed (String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

Parámetros
errorMessage String: String que describe el motivo de la falla de ejecución

pruebaRunStarted

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

Informa el inicio de una ejecución de prueba.

Parámetros
name String: Es el nombre de la ejecución de prueba.

numTests int: Cantidad total de pruebas en la ejecución de prueba

attemptNumber int: Número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El valor de tryNumber tiene un índice 0 y debería aumentarse cada vez se ejecuta una nueva ejecución. p.ej., Se vuelve a intentar una prueba detallada 3 veces; debería tener 4 en total se ejecuta con el mismo runName y tryNumber del 0 al 3.

pruebaRunStarted

public void testRunStarted (String name, 
                int numTests)

Informa el inicio de una ejecución de prueba.

Parámetros
name String: Es el nombre de la ejecución de prueba.

numTests int: Cantidad total de pruebas en la ejecución de prueba

pruebaRunStarted

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

Informa el inicio de una ejecución de prueba.

Parámetros
name String: Es el nombre de la ejecución de prueba.

numTests int: Cantidad total de pruebas en la ejecución de prueba

attemptNumber int: Número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El valor de intentNumber tiene un índice 0 y debería aumentarse cada vez que se genera un una nueva carrera. p.ej., Se vuelve a intentar una prueba detallada 3 veces, por lo que debería tener 4 ejecuciones en total con el mismo runName e tryNumber del 0 al 3.

startTime long: Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis().

pruebaRundetenida

public void testRunStopped (long elapsedTime)

La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario.

PENDIENTE: Actualmente sin uso, te recomendamos que lo quites

Parámetros
elapsedTime long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.

pruebaOmitir

public void testSkipped (TestDescription test, 
                SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. Se intentará volver a realizar estas pruebas para que se ejecute correctamente.

Parámetros
test TestDescription: Identifica la prueba.

reason SkipReason: SkipReason

Iniciodeprueba

public void testStarted (TestDescription test, 
                long startTime)

Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), donde también especificamos cuándo se realizó la prueba. comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para obtener una medición precisa.

Parámetros
test TestDescription: Identifica la prueba.

startTime long: Es la hora en que comenzó la prueba, medida mediante System.currentTimeMillis().

Iniciodeprueba

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. Esta interfaz es antigua y debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription: Identifica la prueba.

Métodos protegidos

ClearModuleLogFiles

protected final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo para que no se lleven durante mucho tiempo.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Permite borrar los resultados de un nombre de ejecución determinado. Solo debe usarse en algunos casos, como el agregador de resultados.

Parámetros
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Activar o desactivar “Métricas agregadas” opción

Parámetros
aggregate boolean