SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Subclases directas conocidas LegacySubprocessResultsReporter LegacySubprocessResultsReporter Una implementación bloqueada del generador de informes de resultados del subproceso que debería seguir siendo compatible con versiones anteriores de TF/CTS (p.ej., 8 y versiones posteriores), a pesar de los cambios en su superclase.

---

Implementa ITestInvocationListener para que se especifique como result_reporter y se reenvíe desde el subproceso, los resultados de las pruebas, las ejecuciones de prueba y las invocaciones de prueba.

Resumen

Constructores públicos
SubprocessResultsReporter()

Métodos públicos
void	close()
TestSummary	getSummary() Permite que InvocationListener muestre un resumen.
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	invocationStarted(IInvocationContext context) Informa el inicio de la invocación de prueba.
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	printEvent(String key, Object event) Es el asistente para imprimir la clave del evento y, luego, el objeto JSON.
void	setOutputTestLog(boolean outputTestLog) Establece si debemos o no mostrar la prueba registrada o no.
boolean	supportGranularResults() Muestra el valor True si el informante admite resultados detallados. De lo contrario, muestra false.
void	testAssumptionFailure(TestDescription testId, String trace) Se llama cuando una prueba atómica marca que asume una condición falsa.
void	testAssumptionFailure(TestDescription testId, FailureDescription failure) Se llama cuando una prueba atómica marca que asume una condición falsa.
void	testEnded(TestDescription testId, long endTime, metrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente.
void	testEnded(TestDescription testId, metrics) Informa el final de la ejecución de un caso de prueba individual.
void	testFailed(TestDescription testId, FailureDescription failure) Informa el error de un caso de prueba individual.
void	testFailed(TestDescription testId, String reason) Informa el error de un caso de prueba individual.
void	testIgnored(TestDescription testId) Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Proporciona los datos de registro o depuración asociados de la invocación de prueba.
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 time, 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 reason) 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.
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.
void	testRunStopped(long arg0) La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario.
void	testSkipped(TestDescription testId, SkipReason reason) Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera.
void	testStarted(TestDescription testId, 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 testId) Informa el inicio de un caso de prueba individual.

Constructores públicos

SubprocessResultsReporter

public SubprocessResultsReporter ()

Métodos públicos

cerrar

public void close ()

getSummary

public TestSummary getSummary ()

Permite que InvocationListener muestre un resumen.

Muestra
TestSummary	Una TestSummary que resume la ejecución o un valor nulo

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

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

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.

printEvent

public void printEvent (String key, 
                Object event)

Es el asistente para imprimir la clave del evento y, luego, el objeto JSON.

Parámetros
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Establece si debemos o no mostrar la prueba registrada o no.

Parámetros
outputTestLog	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 void testAssumptionFailure (TestDescription testId, 
                String trace)

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

Parámetros
testId	TestDescription: Identifica la prueba.
trace	String: seguimiento de pila de las fallas

ErrordeAsuncióndeprueba

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

Parámetros
testId	TestDescription: Identifica la prueba.
failure	FailureDescription: FailureDescription que describe la falla y su contexto

pruebaFinalizada

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
testId	TestDescription: Identifica la prueba.
endTime	long: La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis()
metrics	: Una ERROR(/Map) de las métricas emitidas

pruebaFinalizada

public void testEnded (TestDescription testId, 
                 metrics)

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
testId	TestDescription: Identifica la prueba.
metrics	: Una ERROR(/Map) de las métricas emitidas

Prueba con errores

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
testId	TestDescription: Identifica la prueba.
failure	FailureDescription: FailureDescription que describe la falla y su contexto

Prueba con errores

public void testFailed (TestDescription testId, 
                String reason)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
testId	TestDescription: Identifica la prueba.
reason	String: seguimiento de pila de las fallas

pruebaIgnorada

public void testIgnored (TestDescription testId)

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

Parámetros
testId	TestDescription: Identifica la prueba.

Registro de prueba

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Proporciona los datos de registro o depuración asociados de la invocación de prueba.

Se debe llamar antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

El framework TradeFederation llamará automáticamente a este método y proporcionará el registro del host. y, si corresponde, el logcat del dispositivo.

Parámetros
dataName	String: Es un nombre descriptivo String de los datos. p.ej., “device_logcat”. Nota dataName no puede ser único por invocación. es decir, los implementadores deben poder manejar varias llamadas con el mismo dataName
dataType	LogDataType: el LogDataType de los datos
dataStream	InputStreamSource: el InputStreamSource de los datos Los implementadores deben llamar createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream cuando se complete Los emisores deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog.

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 time, 
                 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
time	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 reason)

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

Parámetros
reason	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 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().

pruebaRundetenida

public void testRunStopped (long arg0)

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
arg0	long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.

pruebaOmitir

public void testSkipped (TestDescription testId, 
                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
testId	TestDescription: Identifica la prueba.
reason	SkipReason: SkipReason

Iniciodeprueba

public void testStarted (TestDescription testId, 
                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
testId	TestDescription: Identifica la prueba.
startTime	long: Es la hora en que comenzó la prueba, medida mediante System.currentTimeMillis().

Iniciodeprueba

public void testStarted (TestDescription testId)

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
testId	TestDescription: Identifica la prueba.