A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

TestRunResult

public class TestRunResult
extends Object

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

Contiene los resultados de una sola ejecución de prueba.

Mantiene un recuento preciso de las pruebas y hace un seguimiento de las pruebas incompletas.

No es seguro para subprocesos. Las devoluciones de llamada test* se deben llamar en orden.

Resumen

Constantes
`String`	`ERROR_DIVIDER`

Constructores públicos
`TestRunResult()` Crea un`TestRunResult`vacío.

Métodos públicos
`void`	`addTestResult(TestDescription test, TestResult testResult)`
`Set<TestDescription>`	`getCompletedTests()` Obtiene el conjunto de pruebas completadas.
`long`	`getElapsedTime()` Devuelve el tiempo transcurrido de la ejecución actual.
`int`	`getExpectedTestCount()` Obtiene la cantidad de casos de prueba que se espera que tenga este TestRunResult.
`Set<TestDescription>`	`getFailedTests()` Obtiene el conjunto de pruebas con errores.
`String`	`getName()`
`int`	`getNumAllFailedTests()` Devuelve la cantidad total de pruebas en estado de error (con errores o con errores de suposición).
`int`	`getNumCompleteTests()` Obtiene la cantidad de pruebas completadas en esta ejecución, es decir, con el estado != incompleto.
`int`	`getNumTests()` Obtiene la cantidad de pruebas en esta ejecución.
`int`	`getNumTestsInState(TestStatus status)` Obtiene la cantidad de pruebas en el estado determinado para esta ejecución.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` PARA COMPATIBILIDAD con estados anteriores.
`Set<TestDescription>`	`getPassedTests()` Obtiene el conjunto de pruebas aprobadas.
`FailureDescription`	`getRunFailureDescription()` Devuelve el descriptor de falla de la ejecución, `null` si la ejecución no falló.
`String`	`getRunFailureMessage()` Devuelve el mensaje de error de la falla de ejecución, `null` si la ejecución no falló.
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` Devuelve una copia del mapa que contiene todos los archivos de registro asociados con ese caso de prueba.
`Map<String, String>`	`getRunMetrics()`
`HashMap<String, MetricMeasurement.Metric>`	`getRunProtoMetrics()`
`long`	`getStartTime()` Devuelve la hora de inicio de la primera llamada testRunStart.
`Map<TestDescription, TestResult>`	`getTestEntriesInState(Collection<TestStatus> statuses)` Obtiene el conjunto de pruebas en los estados determinados.
`Map<TestDescription, TestResult>`	`getTestResults()` Devuelve un mapa de los resultados de la prueba.
`Set<TestDescription>`	`getTestsInState(List<TestStatus> statuses)` Obtiene el conjunto de pruebas en los estados determinados.
`List<TestResult>`	`getTestsResultsInState(TestStatus status)` Devuelve todos los `TestResult` en un estado determinado.
`String`	`getTextSummary()` Devuelve una cadena fácil de usar que describe los resultados.
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults)`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults, MergeStrategy strategy)` Combina varios TestRunResults del mismo testRunName.
`void`	`resetRunFailure()` Restablece el estado de error de la ejecución.
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testLogSaved(String dataName, LogFile logFile)` La información sobre un archivo que se registra se almacena y asocia al caso de prueba o a la ejecución de prueba en curso.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Nueva interfaz que usa las nuevas métricas de .proto
`void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` Notifica que se inició una ejecución de prueba.
`void`	`testRunStarted(String runName, int testCount)` Notifica que se inició una ejecución de prueba.
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Constantes

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Valor de la constante: " ====Next Error==== "

Constructores públicos

TestRunResult

public TestRunResult ()

Crea unTestRunResultvacío.

Métodos públicos

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parámetros
`test`	`TestDescription`
`testResult`	`TestResult`

getCompletedTests

public Set<TestDescription> getCompletedTests ()

Obtiene el conjunto de pruebas completadas.

Muestra
`Set<TestDescription>`

getElapsedTime

public long getElapsedTime ()

Devuelve el tiempo transcurrido de la ejecución actual.

Muestra
`long`

getExpectedTestCount

public int getExpectedTestCount ()

Obtiene la cantidad de casos de prueba que se espera que tenga este TestRunResult. La cantidad real puede ser inferior a la esperada debido a fallas en las pruebas. Por lo general, tal discrepancia indica una falla en la ejecución de la prueba.

Muestra
`int`

getFailedTests

public Set<TestDescription> getFailedTests ()

Obtiene el conjunto de pruebas con errores.

Muestra
`Set<TestDescription>`

getName

public String getName ()

Muestra
`String`	Nombre de la ejecución de la prueba

getNumAllFailedTests

public int getNumAllFailedTests ()

Devuelve la cantidad total de pruebas en estado de error (con errores o con errores de suposición).

Muestra
`int`

getNumCompleteTests

public int getNumCompleteTests ()

Obtiene la cantidad de pruebas completadas en esta ejecución, es decir, con el estado != incompleto.

Muestra
`int`

getNumTests

public int getNumTests ()

Obtiene la cantidad de pruebas en esta ejecución.

Muestra
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Obtiene la cantidad de pruebas en el estado determinado para esta ejecución.

Parámetros
`status`	`TestStatus`

Muestra
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

PARA COMPATIBILIDAD con estados anteriores. Usa getNumTestsInState(TestStatus) en su lugar.

Parámetros
`ddmlibStatus`	`TestResult.TestStatus`

Muestra
`int`

getPassedTests

public Set<TestDescription> getPassedTests ()

Obtiene el conjunto de pruebas aprobadas.

Muestra
`Set<TestDescription>`

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Devuelve el descriptor de falla de la ejecución, null si la ejecución no falló.

Muestra
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

Devuelve el mensaje de error de la falla de ejecución, null si la ejecución no falló.

Muestra
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Devuelve una copia del mapa que contiene todos los archivos de registro asociados con ese caso de prueba.

Muestra
`MultiMap<String, LogFile>`

getRunMetrics

public Map<String, String> getRunMetrics ()

Muestra
`Map<String, String>`	Es un `Map` de las métricas de ejecución de la prueba.

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

Muestra
`HashMap<String, MetricMeasurement.Metric>`	Un `Map` de las métricas de ejecución de la prueba con el nuevo formato de .proto

getStartTime

public long getStartTime ()

Devuelve la hora de inicio de la primera llamada testRunStart.

Muestra
`long`

getTestEntriesInState

public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

Obtiene el conjunto de pruebas en los estados determinados.

Parámetros
`statuses`	`Collection`

Muestra
`Map<TestDescription, TestResult>`

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

Devuelve un mapa de los resultados de la prueba.

Muestra
`Map<TestDescription, TestResult>`

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

Obtiene el conjunto de pruebas en los estados determinados.

Parámetros
`statuses`	`List`

Muestra
`Set<TestDescription>`

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

Devuelve todos los TestResult en un estado determinado.

Parámetros
`status`	`TestStatus`

Muestra
`List<TestResult>`

getTextSummary

public String getTextSummary ()

Devuelve una cadena fácil de usar que describe los resultados.

Muestra
`String`

hasFailedTests

public boolean hasFailedTests ()

Muestra
`boolean`	`true` si la ejecución de prueba tuvo alguna prueba con errores o fallas

isRunComplete

public boolean isRunComplete ()

Muestra
`boolean`	`true` si finalizó la ejecución de prueba.

isRunFailure

public boolean isRunFailure ()

Muestra
`boolean`	`true` si falló la ejecución de la prueba.

combinar

public static TestRunResult merge (List<TestRunResult> testRunResults)

Parámetros
`testRunResults`	`List`

Muestra
`TestRunResult`

También:

merge(List,MergeStrategy)

combinar

public static TestRunResult merge (List<TestRunResult> testRunResults, 
                MergeStrategy strategy)

Combina varios TestRunResults del mismo testRunName. Si un caso de prueba aparece en varios TestRunResults, pero tiene resultados diferentes (p.ej., "boottest-device" se ejecuta tres veces con el resultado FALLA-FALLA-APROBADO), concatenamos todos los seguimientos de pila de las ejecuciones FALLIDAS y confiamos en el resultado de la ejecución final para el estado, las métricas, los archivos de registro y la hora de inicio y finalización.

Parámetros
`testRunResults`	`List`: Es una lista de TestRunResult que se combinarán.
`strategy`	`MergeStrategy`: Es la estrategia de combinación adoptada para combinar los resultados.

Muestra
`TestRunResult`	Es el TestRunResult final que contiene los datos combinados de los testRunResults.

resetRunFailure

public void resetRunFailure ()

Restablece el estado de error de la ejecución.

A veces, es necesario restablecer el estado de falla de la ejecución cuando se vuelve a intentar. Esto debe hacerse con cuidado para evitar borrar una falla real.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parámetros
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

Parámetros
`runComplete`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parámetros
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parámetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parámetros
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`	`HashMap`

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parámetros
`test`	`TestDescription`
`testMetrics`	`HashMap`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parámetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parámetros
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parámetros
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

La información sobre un archivo que se registra se almacena y asocia al caso de prueba o a la ejecución de prueba en curso.

Parámetros
`dataName`	`String`: Es el nombre que hace referencia a los datos.
`logFile`	`LogFile`: Es el objeto `LogFile` que representa dónde se guardó el objeto y la información sobre él.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Nueva interfaz que usa las nuevas métricas de .proto

Parámetros
`elapsedTime`	`long`
`runMetrics`	`HashMap`

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

Parámetros
`elapsedTime`	`long`
`runMetrics`	`Map`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parámetros
`failureDescription`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parámetros
`errorMessage`	`String`

testRunStarted

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

Notifica que se inició una ejecución de prueba.

Parámetros
`runName`	`String`: Es el nombre asociado a la ejecución de prueba para fines de seguimiento.
`testCount`	`int`: Es la cantidad de casos de prueba esperados asociados con la ejecución de prueba.
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Notifica que se inició una ejecución de prueba.

Parámetros
`runName`	`String`: Es el nombre asociado a la ejecución de prueba para fines de seguimiento.
`testCount`	`int`: Es la cantidad de casos de prueba esperados asociados con la ejecución de prueba.

testRunStopped

public void testRunStopped (long elapsedTime)

Parámetros
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parámetros
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parámetros
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parámetros
`test`	`TestDescription`