A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

TestRunResult

public class TestRunResult
extends Object implements ITestRunListener

java.lang.Object
↳	com.android.ddmlib.testrunner.TestRunResult

Contém resultados de uma única execução de teste.

Mantém uma contagem precisa de testes e rastreia testes incompletos.

Não é thread safe! Os callbacks test* precisam ser chamados em ordem

Resumo

Construtores públicos
`TestRunResult()` Crie um `TestRunResult` vazio.

Métodos públicos
	`getCompletedTests()` Recebe o conjunto de testes concluídos.
`long`	`getElapsedTime()` Retorna o tempo decorrido da execução atual.
`String`	`getName()`
`int`	`getNumAllFailedTests()` Retorna o número total de testes em um estado de falha (falha, falha de proposição).
`int`	`getNumCompleteTests()` Recebe o número de testes concluídos nesta execução, ou seja, com status != incompleto.
`int`	`getNumTests()` Recebe o número de testes nesta execução.
`int`	`getNumTestsInState(TestResult.TestStatus status)` Recebe o número de testes no estado especificado para esta execução.
`String`	`getRunFailureMessage()` Retorna a mensagem de erro de falha da execução, `null` se a execução não falhou.
	`getRunMetrics()`
	`getTestResults()` Retorna um mapa dos resultados do teste.
`String`	`getTextSummary()` Retorna uma string fácil de usar que descreve os resultados.
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestIdentifier test, String trace)` Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.
`void`	`testEnded(TestIdentifier test, testMetrics)` Informa o fim da execução de um caso de teste individual.
`void`	`testFailed(TestIdentifier test, String trace)` Informa a falha de um caso de teste individual.
`void`	`testIgnored(TestIdentifier test)` Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`void`	`testRunFailed(String errorMessage)` O teste de execução de relatórios não foi concluído devido a um erro fatal.
`void`	`testRunStarted(String runName, int testCount)` Informa o início de uma execução de teste.
`void`	`testRunStopped(long elapsedTime)` O relatório informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.
`void`	`testStarted(TestIdentifier test)` Informa o início de um caso de teste individual.

Construtores públicos

TestRunResult

public TestRunResult ()

Crie um TestRunResult vazio.

Métodos públicos

getCompletedTests

public  getCompletedTests ()

Recebe o conjunto de testes concluídos.

Retorna

getElapsedTime

public long getElapsedTime ()

Retorna o tempo decorrido da execução atual.

Retorna
`long`

getName

public String getName ()

Retorna
`String`	o nome da execução de teste

getNumAllFailedTests

public int getNumAllFailedTests ()

Retorna o número total de testes em um estado de falha (falha, falha de proposição).

Retorna
`int`

getNumCompleteTests

public int getNumCompleteTests ()

Recebe o número de testes concluídos nesta execução, ou seja, com status != incompleto.

Retorna
`int`

getNumTests

public int getNumTests ()

Recebe o número de testes nesta execução.

Retorna
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Recebe o número de testes no estado especificado para esta execução.

Parâmetros
`status`	`TestResult.TestStatus`

Retorna
`int`

getRunFailureMessage

public String getRunFailureMessage ()

Retorna a mensagem de erro de falha da execução, null se a execução não falhou.

Retorna
`String`

getRunMetrics

public  getRunMetrics ()

Retorna
	um `ERROR(/Map)` das métricas de execução do teste.

getTestResults

public  getTestResults ()

Retorna um mapa dos resultados do teste.

Retorna

getTextSummary

public String getTextSummary ()

Retorna uma string fácil de usar que descreve os resultados.

Retorna
`String`

hasFailedTests

public boolean hasFailedTests ()

Retorna
`boolean`	`true` se a execução de teste tiver testes com falha ou erro.

isRunComplete

public boolean isRunComplete ()

Retorna
`boolean`	`true` se a execução do teste for concluída.

isRunFailure

public boolean isRunFailure ()

Retorna
`boolean`	`true` se a execução do teste falhar.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parâmetros
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

Parâmetros
`runComplete`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

Parâmetros
`test`	`TestIdentifier`: identifica o teste.
`trace`	`String`: stack trace da falha

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

Informa o fim da execução de um caso de teste individual.

Se testFailed(TestIdentifier, String) não foi invocado, o teste foi aprovado. Também retorna todas as métricas de chave/valor que podem ter sido emitidas durante a execução do caso de teste.

Parâmetros

test

TestIdentifier: identifica o teste.

testMetrics

: um ERROR(/Map) das métricas emitidas durante a execução do caso de teste pelo android.app.Instrumentation#sendStatus. A ordem de inserção é preservada, a menos que você emita a mesma chave várias vezes. As chaves padrão definidas em IInstrumentationResultParser.StatusKeys são filtradas deste mapa. A Ddmlib pode adicionar métricas de teste extras definidas em IInstrumentationResultParser.StatusKeys.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestIdentifier`: identifica o teste.
`trace`	`String`: stack trace da falha

testIgnored

public void testIgnored (TestIdentifier test)

Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

Parâmetros
`test`	`TestIdentifier`: identifica o teste.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros

elapsedTime

long: tempo decorrido informado pelo dispositivo, em milissegundos

runMetrics

: um ERROR(/Map) das métricas emitidas durante a execução do caso de teste pelo android.app.Instrumentation#addResults. A ordem de inserção é preservada, a menos que você emita a mesma chave várias vezes. As chaves padrão definidas em IInstrumentationResultParser.StatusKeys são filtradas deste mapa. A Ddmlib pode adicionar métricas de teste extras definidas em IInstrumentationResultParser.StatusKeys.

testRunFailed

public void testRunFailed (String errorMessage)

O teste de execução de relatórios não foi concluído devido a um erro fatal.

Parâmetros
`errorMessage`	`String`: `String` descrevendo o motivo da falha na execução.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa o início de uma execução de teste.

Parâmetros
`runName`	`String`: o nome da execução do teste
`testCount`	`int`: número total de testes na execução do teste

testRunStopped

public void testRunStopped (long elapsedTime)

O relatório informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos

testStarted

public void testStarted (TestIdentifier test)

Informa o início de um caso de teste individual.

Parâmetros
`test`	`TestIdentifier`: identifica o teste.