ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

Objeto java.lang.
   ↳ com.android.tradefed.result.proto.ProtoResultReporter

El generador de informes de resultados compila un protobuf TestRecord con todos los resultados dentro. Debe tener para controlar qué hacer con el proto final en processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord).

Resumen

Constructores públicos

ProtoResultReporter()

Métodos públicos

final void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

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

final void invocationStarted(IInvocationContext context)

Informa el inicio de la invocación de prueba.

final 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 processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)

Usa el registro de invocación para enviar, uno por uno, todos los registros finales de la invocación.

void processFinalProto(TestRecordProto.TestRecord finalRecord)

Manejo del proto final con todos los resultados.

void processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Control del protocolo de registro de prueba de invocación parcial después de que ocurrió invocationStarted(com.android.tradefed.invoker.IInvocationContext).

void processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)

Manejo del protocolo de registro de caso de prueba finalizado después de que ocurrió ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

void processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)

Manejo del protocolo de registro de caso de prueba parcial después de que ocurrió testStarted(com.android.tradefed.result.TestDescription, long).

void processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)

Manejo del protocolo de registro del módulo finalizado después de que ocurrió testModuleEnded().

void processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)

Se controla el proto de registro parcial del módulo después de que ocurrió testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

void processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Manejo del protocolo de registro de ejecución finalizado después de ERROR(/#testRunEnded(long,HashMap)) para determinar si se produjo un error.

void processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)

Manejo del protocolo de registro de ejecución de prueba parcial después de testRunStarted(String, int) para determinar si se produjo un error.

void setGranularResults(boolean granularResults)
void setInlineRecordOfChildren(boolean inline)
boolean supportGranularResults()

Muestra el valor True si el informante admite resultados detallados. De lo contrario, muestra false.

final void testAssumptionFailure(TestDescription test, String trace)

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

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

final 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.

final void testFailed(TestDescription test, FailureDescription failure)

Informa el error de un caso de prueba individual.

final void testFailed(TestDescription test, String trace)

Informa el error de un caso de prueba individual.

final 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.

final void testModuleEnded()

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

final void testModuleStarted(IInvocationContext moduleContext)

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

final void testRunEnded(long elapsedTimeMillis, runMetrics)

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

final void testRunFailed(FailureDescription failure)

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

final void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int testCount, int attemptNumber)

Informa el inicio de una ejecución de prueba.

final void testRunStarted(String runName, int testCount)

Informa el inicio de una ejecución de prueba.

void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

Informa el inicio de una ejecución de prueba.

final 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.

final 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.

final void testStarted(TestDescription test)

Informa el inicio de un caso de prueba individual.

Métodos protegidos

TestRecordProto.ChildReference createModuleChildReference(TestRecordProto.TestRecord record)

Crea una referencia secundaria para un módulo.

Constructores públicos

ProtoResultReporter

public ProtoResultReporter ()

Métodos públicos

invocaciónFinalizada

public final 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 (FailureDescription failure)

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

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

Parámetros
failure FailureDescription: Es el FailureDescription que describe la causa de la falla.

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 final 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

Asociación de registro

public final 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.

RegistrosdeInvocacióndelProcesoFinal

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Usa el registro de invocación para enviar, uno por uno, todos los registros finales de la invocación.

Parámetros
invocationLogs TestRecordProto.TestRecord: Es el proto finalizado que representa la invocación.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Manejo del proto final con todos los resultados.

Parámetros
finalRecord TestRecordProto.TestRecord: Es el proto finalizado con todos los resultados de la invocación.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Control del protocolo de registro de prueba de invocación parcial después de que ocurrió invocationStarted(com.android.tradefed.invoker.IInvocationContext).

Parámetros
invocationStartRecord TestRecordProto.TestRecord: Es el proto parcial propagado después de invocationStart.
invocationContext IInvocationContext: Es la invocación IInvocationContext.

procesodepruebadecasofinalizado

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Manejo del protocolo de registro de caso de prueba finalizado después de que ocurrió ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

Parámetros
testCaseRecord TestRecordProto.TestRecord: Es el proto finalizado que representa un caso de prueba.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Manejo del protocolo de registro de caso de prueba parcial después de que ocurrió testStarted(com.android.tradefed.result.TestDescription, long).

Parámetros
testCaseStartedRecord TestRecordProto.TestRecord: Es el proto parcial que representa el caso de prueba.

procesode módulodepruebadefinalización

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Manejo del protocolo de registro del módulo finalizado después de que ocurrió testModuleEnded().

Parámetros
moduleRecord TestRecordProto.TestRecord: Es el proto finalizado que representa el módulo.

proceso de módulodepruebadecomienzo

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Se controla el proto de registro parcial del módulo después de que ocurrió testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

Parámetros
moduleStartRecord TestRecordProto.TestRecord: Es el proto parcial que representa el módulo.

proceso de ejecución de prueba finalizado

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Manejo del protocolo de registro de ejecución finalizado después de ERROR(/#testRunEnded(long,HashMap)) para determinar si se produjo un error.

Parámetros
runRecord TestRecordProto.TestRecord: Es el proto finalizado que representa la ejecución.
moduleInProgress boolean: Indica si un módulo está en curso o no.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Manejo del protocolo de registro de ejecución de prueba parcial después de testRunStarted(String, int) para determinar si se produjo un error.

Parámetros
runStartedRecord TestRecordProto.TestRecord: Es el proto parcial que representa la ejecución.

setGranularResults

public void setGranularResults (boolean granularResults)

Parámetros
granularResults boolean

setInlineRecordOfChild

public void setInlineRecordOfChildren (boolean inline)

Parámetros
inline boolean

asistenciaGranularResults

public boolean supportGranularResults ()

Muestra el valor True si el informante admite resultados detallados. De lo contrario, muestra false.

Muestra
boolean

ErrordeAsuncióndeprueba

public final 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 final 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 final 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 final 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 final 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 final 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 final void testModuleEnded ()

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

MódulodepruebaIniciado

public final 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 final void testRunEnded (long elapsedTimeMillis, 
                 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
elapsedTimeMillis 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 final 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 final 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 runName, 
                int testCount, 
                int attemptNumber)

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.
testCount 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 final void testRunStarted (String runName, 
                int testCount)

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.
testCount int: Cantidad total de pruebas en la ejecución de prueba

pruebaRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.
testCount 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().

pruebaOmitir

public final 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 final 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 final 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

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea una referencia secundaria para un módulo.

Parámetros
record TestRecordProto.TestRecord

Devuelve
TestRecordProto.ChildReference