O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Um listener de proxy para traduzir métodos de teste, classes e nomes de pacotes conforme os resultados são informados.

Resumo

Construtores públicos
`NameMangleListener(ITestInvocationListener listener)`

Métodos públicos
`TestSummary`	`getSummary()` Permite que o InvocationListener retorne um resumo.
`void`	`invocationEnded(long elapsedTime)` Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`void`	`invocationFailed(Throwable cause)` Informa uma invocação incompleta devido a alguma condição de erro.
`void`	`invocationStarted(IInvocationContext context)` Informa o início da invocação do teste.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`void`	`testEnded(TestDescription test, testMetrics)` Informa o término da execução de um caso de teste individual.
`void`	`testFailed(TestDescription test, String trace)` Informa a falha de um caso de teste individual.
`void`	`testIgnored(TestDescription test)` É chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece os dados de registro ou depuração associados à invocação do teste.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`void`	`testRunFailed(String errorMessage)` A execução do teste de relatórios não foi concluída 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)` A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
`void`	`testStarted(TestDescription test)` Informa o início de um caso de teste individual.

Métodos protegidos
`TestDescription`	`mangleTestId(TestDescription test)` Esse método é executado em todos os `TestDescription`s transmitidos aos callbacks `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` e `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Esse método é usado em todos os nomes de execuções de teste transmitidos ao callback `testRunStarted(String, int)`.

Construtores públicos

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parâmetros
`listener`	`ITestInvocationListener`

Métodos públicos

getSummary

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Retorna
`TestSummary`	Um `TestSummary` que resume a execução ou é nulo.

invocationEnded

public void invocationEnded (long elapsedTime)

Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`elapsedTime`	`long`: o tempo decorrido da invocação em ms

InvocationFalha

public void invocationFailed (Throwable cause)

Informa uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`cause`	`Throwable`: a causa `Throwable` da falha.

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa o início da invocação do teste.

Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a vários dispositivos.

Parâmetros
`context`	`IInvocationContext`: informações sobre a invocação.

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamada quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
`test`	`TestDescription`: identifica o teste
`trace`	`String`: stack trace de falha

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Informa o término da execução de um caso de teste individual.

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

Parâmetros
`test`	`TestDescription`: identifica o teste
`testMetrics`	: uma `ERROR(/Map)` das métricas emitidas

testFailed

public void testFailed (TestDescription test, 
                String trace)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestDescription`: identifica o teste
`trace`	`String`: stack trace de falha

testIgnored

public void testIgnored (TestDescription test)

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

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

testLog

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

Fornece os dados de registro ou depuração associados à invocação do teste.

Precisa ser chamado antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long)).

O framework TradeFederation vai chamar esse método automaticamente, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

Parâmetros
`dataName`	`String`: um nome descritivo de `String` dos dados. Por exemplo, "device_logcat". DataName pode não ser exclusivo por invocação, ou seja, os implementadores precisam conseguir processar várias chamadas com o mesmo dataName
`dataType`	`LogDataType`: o `LogDataType` dos dados
`dataStream`	`InputStreamSource`: o `InputStreamSource` dos dados. Os implementadores precisam chamar createInputStream para começar a ler os dados e garantir que o InputStream resultante seja fechado quando concluído. Os autores de chamada precisam garantir que a origem dos dados permaneça presente e acessível até que o método testLog seja concluído.

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`	: pares de chave-valor informados no final de uma execução de teste

testRunFailed

public void testRunFailed (String errorMessage)

A execução do teste de relatórios não foi concluída 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)

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

TODO: não usado no momento, considere remover

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

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. Interface mais antiga, use testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

Parâmetros
`test`	`TestDescription`: identifica o teste

Métodos protegidos

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Esse método é executado em todos os TestDescriptions transmitidos aos callbacks testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). O método precisa retornar um TestDescription possivelmente diferente, que será transmitido para o ITestInvocationListener downstream especificado durante a construção.

A implementação precisa ter cuidado para não modificar o TestDescription original.

A implementação padrão transmite o identificador de entrada sem modificações.

Parâmetros
`test`	`TestDescription`

Retorna
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Esse método é usado em todos os nomes de execuções de teste transmitidos ao callback testRunStarted(String, int). O método precisa retornar um nome de execução de teste possivelmente diferente, que será transmitido para o ITestInvocationListener downstream especificado durante a construção.

A implementação precisa ter cuidado para não modificar o nome da execução original.

A implementação padrão transmite o nome da execução de teste recebido sem modificações.

Parâmetros
`name`	`String`

Retorna
`String`