Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Um listener de proxy para traduzir nomes de métodos, classes e pacotes de teste à medida que 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 ele pressupõe uma condição falsa.
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Informa o fim 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 depuração ou de registro associados da invocação de teste.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> 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 um teste.
`void`	`testRunStopped(long elapsedTime)` A execução de 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(TestDescription)`, `testFailed(TestDescription,String)` e `testEnded(TestDescription,HashMap)`.
`String`	`mangleTestRunName(String name)` Esse método é executado em todos os nomes de execução 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 pela estrutura TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pela estrutura 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 pela estrutura TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a relatórios de vários dispositivos.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testEnded

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

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

Se testFailed(TestDescription, FailureDescription) 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`	`TestDescription`: identifica o teste.
`testMetrics`	`HashMap`: uma `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 da 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 depuração ou de registro associados da invocação de teste.

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

A estrutura TradeFederation chama esse método automaticamente, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

Parâmetros
`dataName`	`String`: um nome descritivo `String` dos dados, por exemplo, "device_logcat". Observação: dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de 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 fechar o InputStream resultante quando concluído. Os autores da 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Informa o fim da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então precisamos usar HashMap aqui.

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	`HashMap`: pares de chave-valor informados no final de uma execução de teste com `Metric`.

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` que descreve o motivo da falha na execução.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa o início de um 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)

A execução de teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.

TODO: atualmente não usado, 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(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(TestDescription), testFailed(TestDescription,String) e testEnded(TestDescription,HashMap). O método vai 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 recebido sem modificações.

Parâmetros
`test`	`TestDescription`

Retorna
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Esse método é executado em todos os nomes de execução 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 original da execução.

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

Parâmetros
`name`	`String`

Retorna
`String`