A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

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

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.NameMangleListener

Un objeto de escucha de proxy para traducir los nombres de método, clase y paquete de prueba a medida que se informan los resultados.

Resumen

Constructores públicos
`NameMangleListener(ITestInvocationListener listener)`

Métodos públicos
`TestSummary`	`getSummary()` Permite que InvocationListener devuelva un resumen.
`void`	`invocationEnded(long elapsedTime)` Informa que la invocación finalizó, ya sea de forma correcta o 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`	`testAssumptionFailure(TestDescription test, String trace)` Se llama cuando una prueba atómica marca que supone una condición falsa.
`void`	`testEnded(TestDescription test, testMetrics)` Informa el final de la ejecución 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 ejecutará una prueba, por lo general, porque un método de prueba está anotado con org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Proporciona los datos de registro o depuración asociados de la invocación de prueba.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Informa el final de la ejecución de prueba.
`void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.
`void`	`testRunStarted(String runName, int testCount)` Informa el inicio de una ejecución de prueba.
`void`	`testRunStopped(long elapsedTime)` La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
`void`	`testStarted(TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos protegidos
`TestDescription`	`mangleTestId(TestDescription test)` Este método se ejecuta en todos los `TestDescription` que se pasan a las devoluciones de llamada `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` y `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Este método se ejecuta en todos los nombres de ejecuciones de prueba que se pasan a la devolución de llamada `testRunStarted(String, int)`.

Constructores públicos

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parámetros
`listener`	`ITestInvocationListener`

Métodos públicos

getSummary

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Muestra
`TestSummary`	Un `TestSummary` que resume la ejecución o es nulo

invocationEnded

public void invocationEnded (long elapsedTime)

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

El framework de TradeFederation lo llamará automáticamente.

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

invocationFailed

public void invocationFailed (Throwable cause)

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

El framework de TradeFederation lo llamará automáticamente.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

El framework de TradeFederation lo llamará automáticamente. Los generadores de informes deben anular este método para admitir informes de varios dispositivos.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`trace`	`String`: seguimiento de pila de la falla

testEnded

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`testMetrics`	: Un `ERROR(/Map)` de las métricas emitidas

testFailed

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 la falla

testIgnored

public void testIgnored (TestDescription test)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.

testLog

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 que a ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o a ERROR(/ITestInvocationListener#invocationEnded(long)).

El framework de 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`: Un nombre descriptivo `String` de los datos, p. ej., "device_logcat". Nota: Es posible que dataName no sea único por invocación. Es decir, los implementadores deben poder controlar varias llamadas con el mismo dataName.
`dataType`	`LogDataType`: El `LogDataType` de los datos
`dataStream`	`InputStreamSource`: Es 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. Los emisores deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de prueba.

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos
`runMetrics`	: Son los pares clave-valor que se informan al final de una ejecución de prueba.

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

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`: Es la cantidad total de pruebas en la ejecución de prueba.

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos

testStarted

public void testStarted (TestDescription test)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.

Métodos protegidos

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Este método se ejecuta en todos los TestDescription que se pasan a las devoluciones de llamada testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) y ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). El método debe mostrar un TestDescription posiblemente diferente que se pasará al ITestInvocationListener descendente que se especificó durante la construcción.

La implementación debe tener cuidado de no modificar el TestDescription original.

La implementación predeterminada pasa el identificador entrante sin modificaciones.

Parámetros
`test`	`TestDescription`

Muestra
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Este método se ejecuta en todos los nombres de ejecuciones de prueba que se pasan a la devolución de llamada testRunStarted(String, int). El método debe mostrar un nombre de ejecución de prueba posiblemente diferente que se pasará al ITestInvocationListener descendente que se especificó durante la compilación.

La implementación debe tener cuidado de no modificar el nombre de la ejecución original.

La implementación predeterminada pasa el nombre de la ejecución de prueba entrante sin modificarlo.

Parámetros
`name`	`String`

Devuelve
`String`