Se usó la API de Cloud Translation para traducir esta página.

SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

Subclases directas conocidas

LegacySubprocessResultsReporter

LegacySubprocessResultsReporter Una implementación congelada del reportero de resultados de subprocesos que debería seguir siendo compatible con versiones anteriores de TF/CTS (por ejemplo, 8+), a pesar de los cambios en su superclase.

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

Resumen

Constructores públicos
`SubprocessResultsReporter ()`

Métodos públicos
`void`	`close ()`
`TestSummary`	`getSummary ()` Permite que InvocationListener devuelva un resumen.
`void`	`invocationEnded (long elapsedTime)` Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.
`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 fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` la devolución de llamada no es posible.
`void`	`printEvent (String key, Object event)` Ayudante para imprimir la clave del evento y luego el objeto json.
`void`	`setOutputTestLog (boolean outputTestLog)` Establece si debemos o no dar salida a la prueba registrada o no.
`boolean`	`supportGranularResults ()` Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.
`void`	`testAssumptionFailure ( TestDescription testId, String trace)` Llamado cuando una prueba atómica marca que asume una condición que es falsa
`void`	`testAssumptionFailure ( TestDescription testId, FailureDescription failure)` Llamado cuando una prueba atómica marca que asume una condición que es falsa
`void`	`testEnded ( TestDescription testId, long endTime, metrics)` `testEnded ( TestDescription testId, long endTime, metrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` donde podemos especificar la hora de finalización directamente.
`void`	`testEnded ( TestDescription testId, metrics)` `testEnded ( TestDescription testId, metrics)` Informa el final de la ejecución de un caso de prueba individual.
`void`	`testFailed ( TestDescription testId, FailureDescription failure)` Informa de la falla de un caso de prueba individual.
`void`	`testFailed ( TestDescription testId, String reason)` Informa de la falla de un caso de prueba individual.
`void`	`testIgnored ( TestDescription testId)` Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Proporciona el registro asociado o los datos de depuración de la invocación de prueba.
`void`	`testModuleEnded ()` Informa del final de la ejecución de un módulo.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Informa el comienzo de un módulo en ejecución.
`void`	`testRunEnded (long time, runMetrics)` `testRunEnded (long time, runMetrics)` Informa el final de la ejecución de la prueba.
`void`	`testRunFailed ( FailureDescription failure)` La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por `FailureDescription` .
`void`	`testRunFailed (String reason)` La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Informa del inicio de una ejecución de prueba.
`void`	`testRunStarted (String runName, int testCount)` Informa del inicio de una ejecución de prueba.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Informa del inicio de una ejecución de prueba.
`void`	`testRunStopped (long arg0)` La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
`void`	`testStarted ( TestDescription testId, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` donde también especificamos cuándo se inició la prueba, combinada con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para una medición precisa .
`void`	`testStarted ( TestDescription testId)` Informa del inicio de un caso de prueba individual.

Constructores públicos

SubprocessResultsReporter

public SubprocessResultsReporter ()

Métodos públicos

cerca

public void close ()

obtenerResumen

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Devoluciones
`TestSummary`	Un `TestSummary` que resume la ejecución, o nulo

invocaciónTerminada

public void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

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

invocaciónError

public void invocationFailed (FailureDescription failure)

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

Será llamado automáticamente por el marco TradeFederation.

Parámetros
`failure`	`FailureDescription` : la `FailureDescription` que describe la causa de la falla

invocaciónError

public void invocationFailed (Throwable cause)

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

Será llamado automáticamente por el marco TradeFederation.

Parámetros
`cause`	`Throwable` : el `ERROR(/Throwable)` causa de la falla

invocaciónEmpezó

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco TradeFederation. Los reporteros deben anular este método para admitir informes de múltiples 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 fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la devolución de llamada no es posible. Por lo tanto, esta devolución de llamada permite proporcionar explícitamente una asociación fuerte.

Parámetros
`dataName`	`String` : el nombre de los datos
`logFile`	`LogFile` : el `LogFile` que se registró antes y debe asociarse con el caso de prueba.

imprimirEvento

public void printEvent (String key, 
                Object event)

Ayudante 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 dar salida a la prueba registrada o no.

Parámetros
`outputTestLog`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.

Devoluciones
`boolean`

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
`testId`	`TestDescription` : identifica la prueba
`trace`	`String` : rastro de pila de falla

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
`testId`	`TestDescription` : identifica la prueba
`failure`	`FailureDescription` : `FailureDescription` que describe el error y su contexto.

pruebaTerminó

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente. Combínelo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medida precisa.

Parámetros
`testId`	`TestDescription` : identifica la prueba
`endTime`	`long` : la hora en que finalizó la prueba, medida a través de `ERROR(/System#currentTimeMillis())`
`metrics`	: un `ERROR(/Map)` de las métricas emitidas

pruebaTerminó

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 pasó. También devuelve cualquier métrica clave/valor que se haya emitido durante la ejecución del caso de prueba.

Parámetros
`testId`	`TestDescription` : identifica la prueba
`metrics`	: un `ERROR(/Map)` de las métricas emitidas

prueba fallida

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`testId`	`TestDescription` : identifica la prueba
`failure`	`FailureDescription` : `FailureDescription` que describe el error y su contexto.

prueba fallida

public void testFailed (TestDescription testId, 
                String reason)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`testId`	`TestDescription` : identifica la prueba
`reason`	`String` : rastro de pila de falla

prueba ignorada

public void testIgnored (TestDescription testId)

Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
`testId`	`TestDescription` : identifica la prueba

registro de prueba

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

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

Debe llamarse antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parámetros
`dataName`	`String` : un `ERROR(/String)` nombre descriptivo de los datos. por ejemplo, "device_logcat". Tenga en cuenta que dataName puede no ser único por invocación. es decir, los implementadores deben poder manejar múltiples llamadas con el mismo nombre de datos
`dataType`	`LogDataType` : el `LogDataType` de los datos
`dataStream`	`InputStreamSource` : el `InputStreamSource` de los datos. Los implementadores deben llamar a createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream resultante cuando se complete. Las personas que llaman deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog.

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: no podemos tener dos interfaces Map<> con un tipo diferente, por lo que tenemos que usar HashMap aquí.

Parámetros
`time`	`long` : tiempo transcurrido informado por el dispositivo, en milisegundos
`runMetrics`	: pares clave-valor notificados al final de una ejecución de prueba con `Metric` .

pruebaRunFailed

public void testRunFailed (FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

Parámetros
`failure`	`FailureDescription` : `FailureDescription` que describe el error y su contexto.

pruebaRunFailed

public void testRunFailed (String reason)

La ejecución de la prueba de informes no se pudo completar debido a un error fatal.

Parámetros
`reason`	`String` : `ERROR(/String)` que describe el motivo del error de ejecución.

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba
`attemptNumber`	`int` : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba
`attemptNumber`	`int` : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.
`startTime`	`long` : la hora en que comenzó la ejecución, medida a través de `ERROR(/System#currentTimeMillis())`

testRunStopped

public void testRunStopped (long arg0)

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

TODO: actualmente sin usar, considere eliminar

Parámetros
`arg0`	`long` : tiempo transcurrido informado por el dispositivo, en milisegundos

pruebaEmpezó

public void testStarted (TestDescription testId, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .

Parámetros
`testId`	`TestDescription` : identifica la prueba
`startTime`	`long` : la hora en que comenzó la prueba, medida a través de `ERROR(/System#currentTimeMillis())`

pruebaEmpezó

public void testStarted (TestDescription testId)

Informa del inicio de un caso de prueba individual. Interfaz anterior, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
`testId`	`TestDescription` : identifica la prueba