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.

LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

Subclasses diretas conhecidas

RetryLogSaverResultForwarder

RetryLogSaverResultForwarder Encaminhador que também processa a transmissão da tentativa atual.

Um ResultForwarder para salvar registros com o salvador de arquivos global.

Resumo

Construtores públicos
`LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config)`
`LogSaverResultForwarder(ILogSaver logSaver, List<ITestInvocationListener> listeners, IConfiguration config, boolean setLogSaver)`

Métodos públicos
`void`	`invocationEnded(long elapsedTime)` Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`void`	`invocationStarted(IInvocationContext context)` Informa o início da invocação do teste.
`void`	`logAssociation(String dataName, LogFile logFile)` Em alguns casos, o registro precisa estar fortemente associado a um caso de teste, mas não é possível fazer isso no callback direto do `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`static void`	`logFile(List<ITestInvocationListener> listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)` Registrar um arquivo final antes da conclusão
`static void`	`reportEndHostLog(List<ITestInvocationListener> listeners, ILogSaver saver, String name)` Informa o host_log da sessão em andamento.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece os dados de depuração ou de registro associados da invocação de teste. Além disso, salve o arquivo de registro com o `ILogSaver` global e chame `ILogSaverListener.testLogSaved(String,LogDataType,InputStreamSource,LogFile)` para os listeners que implementam a interface `ILogSaverListener`.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` Encaminhe apenas o testLog em vez de salvar o registro primeiro.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Chamado quando o registro de teste é salvo. Se `LogSaverResultForwarder` estiver envolvido em outro, encaminhe o callback testLogSaved para os listeners abaixo dele.
`void`	`testModuleEnded()` Informa o fim da execução de um módulo.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Informa o início da execução de um módulo.

Construtores públicos

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config)

Parâmetros
`logSaver`	`ILogSaver`
`listeners`	`List`
`config`	`IConfiguration`

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                List<ITestInvocationListener> listeners, 
                IConfiguration config, 
                boolean setLogSaver)

Parâmetros
`logSaver`	`ILogSaver`
`listeners`	`List`
`config`	`IConfiguration`
`setLogSaver`	`boolean`

Métodos públicos

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro precisa estar fortemente associado a um caso de teste, mas não é possível fazer isso no callback direto do testLogSaved(String,LogDataType,InputStreamSource,LogFile). Assim, esse callback permite fornecer uma associação forte de forma explícita.

Parâmetros
`dataName`	`String`: o nome dos dados
`logFile`	`LogFile`: o `LogFile` registrado anteriormente e que precisa ser associado ao caso de teste.

logFile

public static void logFile (List<ITestInvocationListener> listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

Registrar um arquivo final antes da conclusão

Parâmetros
`listeners`	`List`
`saver`	`ILogSaver`
`source`	`InputStreamSource`
`name`	`String`
`type`	`LogDataType`

reportEndHostLog

public static void reportEndHostLog (List<ITestInvocationListener> listeners, 
                ILogSaver saver, 
                String name)

Informa o host_log da sessão em andamento.

Parâmetros
`listeners`	`List`
`saver`	`ILogSaver`
`name`	`String`

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.

Além disso, salve o arquivo de registro com o ILogSaver global e chame ILogSaverListener.testLogSaved(String,LogDataType,InputStreamSource,LogFile) para os listeners que implementam a interface ILogSaverListener.

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.

testLogForward

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

Encaminhe apenas o testLog em vez de salvar o registro primeiro.

Parâmetros
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Chamado quando o registro de teste é salvo.

Deve ser usado no lugar de ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

Se LogSaverResultForwarder estiver envolvido em outro, encaminhe o callback testLogSaved para os listeners abaixo dele.

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.
`logFile`	`LogFile`: o `LogFile` que contém os metadados do arquivo salvo.

testModuleEnded

public void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa o início da execução de um módulo. Esse callback está associado a testModuleEnded() e é opcional na sequência. Ele só é usado durante uma execução que usa módulos: executores baseados em suítes.

Parâmetros
`moduleContext`	`IInvocationContext`: o `IInvocationContext` do módulo.