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.

XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

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

Grava resultados do JUnit em arquivos XML em um formato consistente com o XMLJUnitResultFormatter do Ant.

Cria um arquivo XML separado por execução de teste.

Confira também:

https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd

Resumo

Construtores públicos
`XmlTestRunListener()`

Métodos públicos
`void`	`addSystemError(String systemError)` Adiciona uma mensagem de erro do sistema.
`TestRunResult`	`getRunResult()` Retorna o `TestRunResult`
`String`	`getSystemError()` Retorna a mensagem de erro do sistema a ser gravada no arquivo XML no elemento "system-err".
`void`	`setHostName(String hostName)`
`void`	`setReportDir(File file)` Define o arquivo de relatório a ser usado.
`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 numTests)` 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.

Métodos protegidos
	`getPropertiesAttributes()` Receba os atributos de propriedades como pares de chave-valor para serem incluídos no relatório de teste.
`File`	`getResultFile(File reportDir)` Cria um `ERROR(/File)` em que o relatório será criado.
`String`	`getTestName(TestIdentifier testId)`
`String`	`getTestSuiteName()`

Construtores públicos

XmlTestRunListener

public XmlTestRunListener ()

Métodos públicos

addSystemError

public void addSystemError (String systemError)

Adiciona uma mensagem de erro do sistema.

Parâmetros
`systemError`	`String`

getRunResult

public TestRunResult getRunResult ()

Retorna o TestRunResult

Retorna
`TestRunResult`	os resultados da execução do teste.

getSystemError

public String getSystemError ()

Retorna a mensagem de erro do sistema a ser gravada no arquivo XML no elemento "system-err". O elemento não será criado se isso retornar uma string vazia.

Retorna
`String`

setHostName

public void setHostName (String hostName)

Parâmetros
`hostName`	`String`

setReportDir

public void setReportDir (File file)

Define o arquivo de relatório a ser usado.

Parâmetros
`file`	`File`

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 numTests)

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

Parâmetros
`runName`	`String`: o nome da execução do teste
`numTests`	`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.

Métodos protegidos

getPropertiesAttributes

protected  getPropertiesAttributes ()

Receba os atributos de propriedades como pares de chave-valor para serem incluídos no relatório de teste.

Retorna

getResultFile

protected File getResultFile (File reportDir)

Cria um ERROR(/File) em que o relatório será criado.

Parâmetros
`reportDir`	`File`: o diretório raiz do relatório.

Retorna
`File`	um arquivo

Gera
	IOException

getTestName

protected String getTestName (TestIdentifier testId)

Parâmetros
`testId`	`TestIdentifier`

Retorna
`String`

getTestSuiteName

protected String getTestSuiteName ()

Retorna
`String`