A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Subclasses indiretas conhecidas

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CollectingTestListener e outros 57.

AggregatePostProcessor	Um agregador de métricas que fornece o mínimo, o máximo, a média, a variância, o desvio padrão, o total, a contagem e, opcionalmente, os percentis para métricas numéricas coletadas durante execuções de teste de várias iterações, tratando-as como números de ponto flutuante de precisão dupla.
AtraceCollector	Um `IMetricCollector` que executa um rastreamento durante um teste e coleta o resultado e o registra na invocação.
AtraceRunMetricCollector	Coleta os rastreamentos de todos os diretórios de teste no diretório especificado do dispositivo de teste, registra o diretório de teste e pós-processa os arquivos de rastreamento no diretório de teste e agrega as métricas.
AveragePostProcessor	Implementação de pós-processador que calcula a média da lista de métricas.
BaseDeviceMetricCollector	Implementação básica de `IMetricCollector` que permite iniciar e interromper a coleta em `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` e `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	A `IPostProcessor` básica que toda implementação precisa estender.
BluetoothConnectionLatencyCollector	O coletor vai enviar uma configuração de métrica de duração do statsd predefinida para os dispositivos e coletar a duração da conexão Bluetooth de cada perfil.
BluetoothConnectionStateCollector	Esse coletor vai coletar métricas BluetoothConnectionStateChanged e registrar o número do estado da conexão para cada perfil.
BluetoothConnectionSuccessRatePostProcessor	Implementação de um pós-processador que calcula a taxa de sucesso de um perfil Bluetooth. Use "metric-key-match" para especificar métricas que contêm estados de conexão Bluetooth em uma matriz numérica. Exemplo: [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Coletor para ativar o registro de rastreamento do HCI Bluetooth no DUT e coletar o registro de cada teste.
BugreportzOnFailureCollector	Coletar um bugreportz quando um caso de teste falhar.
BugreportzOnTestCaseFailureCollector	Coletar um bugreportz quando um caso de teste em uma execução falhar.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Clang do dispositivo e as registra como artefatos de teste.
CodeCoverageCollector	Um `BaseDeviceMetricCollector` que vai extrair do dispositivo as medições de cobertura nativa e em Java e as registrar como artefatos de teste.
CollectingTestListener	Um `ITestInvocationListener` que vai coletar todos os resultados do teste.
ConsoleResultReporter	Gerador de relatórios de resultados para imprimir os resultados do teste no console.
CountTestCasesCollector	Conta e informa o número de casos de teste para um determinado `IRemoteTest`.
DebugHostLogOnFailureCollector	Coletor que vai reunir e registrar os registros do lado do host quando uma falha de caso de teste ocorrer.
DeviceTraceCollector	Coletor que inicia o rastreamento do perfetto quando uma execução de teste começa e registra o arquivo de rastreamento no final.
EventsLoggerListener	Listener que registra todos os eventos recebidos em um arquivo.
FileProtoResultReporter	Gerador de relatórios do Proto que despeja o `TestRecord` em um arquivo.
FilePullerDeviceMetricCollector	Um `BaseDeviceMetricCollector` que detecta a chave de métricas do dispositivo e as extrai como um arquivo.
FilePullerLogCollector	Registrador do arquivo informado pelo lado do dispositivo.
FormattedGeneratorReporter	Reporter que permite gerar relatórios em um formato específico.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que vai extrair as medições de cobertura do gcov do dispositivo e registrar como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do kernel gcov de debugfs e do dispositivo e, por fim, as registra como artefatos de teste.
GranularRetriableTestWrapper.StartEndCollector	Classe auxiliar para detectar o início e o fim de execuções ausentes.
HostStatsdMetricCollector	Um `IMetricCollector` que coleta métricas do statsd do lado do host usando comandos do utilitário statsd.
IMetricCollector	Essa interface será adicionada como um decorador ao informar os resultados dos testes para coletar métricas correspondentes.
IPostProcessor	Os pós-processadores são um objeto do Trade Federation que permite o processamento de métricas e registros APÓS os testes e ANTES da geração de relatórios de resultados.
InvocationProtoResultReporter	Repórteres para armazenar informações de cache no nível de invocação e a lista de módulos.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai medições de cobertura do Java do dispositivo e as registra como artefatos de teste.
JsonHttpTestResultReporter	Um criador de relatórios de resultados que codifica os resultados das métricas de teste e as informações de ramificação e dispositivo em JSON e POST em um endpoint de serviço HTTP.
LUCIResultReporter	Um gerador de relatórios de resultados que salva os resultados de testes necessários para o ResultDB e o LUCI no formato JSON (go/result-sink) e registra o local do arquivo no console.
LegacySubprocessResultsReporter	Uma implementação congelada do gravador de resultados de subprocesso que deve permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8 ou mais), apesar das mudanças na superclasse.
LogSaverResultForwarder	Um `ResultForwarder` para salvar registros com o salvador de arquivos global.
LogcatOnFailureCollector	Coletor que captura e registra um logcat quando um caso de teste falha.
LogcatTimingMetricCollector	Um coletor de métricas que coleta informações de tempo (por exemplo, tempo de troca de usuário) do logcat durante um ou vários testes repetidos usando padrões regex específicos para analisar sinais de início e fim de um evento das linhas do logcat.
MetricFilePostProcessor	Usado para fazer upload do arquivo de registro de métricas coletado durante o teste e o nível de execução.
MetricsXMLResultReporter	O MetricsXMLResultReporter grava métricas de teste e de execução em um arquivo XML em uma pasta especificada pelo parâmetro "metrics-folder" na fase "invocationEnded" do teste.
ModuleListener	Listener anexado a cada `IRemoteTest` de cada módulo para coletar a lista de resultados.
ModuleLogcatCollector	Versão do coletor logcat, mas para o módulo.
ModuleProtoResultReporter	Um gerador de relatórios de resultados destinado a informar apenas os resultados no nível do módulo.
ModuleResultsAndMetricsForwarder	Uma extensão de `ResultAndLogForwarder` que adiciona métricas extras relacionadas ao módulo aos resultados do teste.
PerfettoFilePullerCollector	Um coletor que extrai arquivos de rastreamento do Perfetto do dispositivo, compacta-os (opcionalmente) e os adiciona aos registros de teste.
PerfettoGenericPostProcessor	Um pós-processador que processa arquivos proto do Perfetto de métricas de texto/binário em pares de chave-valor expandindo recursivamente as mensagens e os campos proto com valores de string até encontrar o campo com valor numérico.
PerfettoPullerMetricCollector	Essa classe foi descontinuada. Use `PerfettoFilePullerCollector` e `ERROR(/PerfettoTracePostProcessor)` em vez disso.
PerfettoTracePostProcessor	Um pós-processador que recupera arquivos de rastreamento do Perfetto dos registros de teste e executa o processador de rastreamento neles para produzir um proto de métricas do Perfetto.
ProtoResultReporter	O ResultReporter cria um protobuf `TestRecord` com todos os resultados.
RebootReasonCollector	Coletor que coleta reinicializações de dispositivos durante o teste e as informa por motivo e contagem.
RemoteTestTimeOutEnforcer	Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e falhar se ela exceder um determinado tempo limite.
ReportPassedTests	Informar em um arquivo os possíveis filtros para excluir o teste aprovado.
ResultAggregator	Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de nova tentativa adotada.
ResultAndLogForwarder	Encaminhador de resultados e eventos de registro.
ResultDBReporter	Gerador de relatórios de resultados que faz upload dos resultados do teste para o ResultDB.
ResultReporter
RetryLogSaverResultForwarder	Encaminhador que também processa a transmissão da tentativa atual.
RuntimeRestartCollector	Coletor que coleta os carimbos de data/hora das reinicializações de tempo de execução (falhas do servidor do sistema) durante a execução do teste, se houver.
ScreenshotOnFailureCollector	Coletor que captura e registra uma captura de tela quando um caso de teste falha.
ShardListener	Um `ITestInvocationListener` que coleta resultados de um fragmento de invocação (ou seja, uma divisão de invocação para ser executada em vários recursos em paralelo) e os encaminha para outro listener.
ShardMainResultForwarder	Um `ResultForwarder` que combina os resultados de invocações de teste fragmentadas.
ShowmapPullerMetricCollector	Implementação básica de `FilePullerDeviceMetricCollector` que permite extrair os arquivos showmap do dispositivo e coletar as métricas dele.
StatsdBeforeAfterGaugeMetricPostProcessor	Um pós-processador que processa métricas de indicador coletadas em uma abordagem "antes/depois", ou seja,
StatsdEventMetricPostProcessor	Um pós-processador que processa métricas de eventos em relatórios do StatsD em pares de chave-valor, usando os formatadores especificados no processador.
StatsdGenericPostProcessor	Um pós-processador que processa relatórios binários do proto statsd em pares de chave-valor expandindo o relatório como uma estrutura de árvore.
StreamProtoResultReporter	Uma implementação de `ProtoResultReporter`
SubprocessResultsReporter	Implementa `ITestInvocationListener` para ser especificado como um result_reporter e encaminha do subprocesso os resultados de testes, execuções de teste e invocações de teste.
SuiteResultReporter	Coletar resultados de testes para uma invocação de pacote inteiro e gerar os resultados finais.
TextResultReporter	Um criador de relatórios de resultados de testes que encaminha os resultados para a impressora de resultados de texto do JUnit.
TraceCmdCollector	Um `IMetricCollector` que coleta rastreamentos durante o teste usando trace-cmd e os registra na invocação.
XmlFormattedGeneratorReporter	Implementação do `FormattedGeneratorReporter` que formata os resultados do conjunto em um formato XML.
XmlResultReporter	Grava resultados do JUnit em arquivos XML em um formato consistente com XMLJUnitResultFormatter do Ant.

Permite que ITestInvocationListeners detectem quando os arquivos de registro são salvos.

Isso permite que vários ITestInvocationListeners usem o mesmo arquivo de registros salvo ao gerar relatórios e evita que cada listener salve o arquivo individualmente quando ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) é chamado.

As classes que implementam essa interface precisam saber que testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) será chamado sempre que ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) for chamado.

Essa classe também transmite a instância global ILogSaver para que os ITestInvocationListeners possam salvar outros arquivos no mesmo local.

Resumo

Métodos públicos
`default 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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`default void`	`setLogSaver(ILogSaver logSaver)` Defina `ILogSaver` para permitir que o implementador salve arquivos.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Chamado quando o registro de teste é salvo.

Métodos públicos

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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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` que foi registrado antes e precisa ser associado ao caso de teste.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Defina ILogSaver para permitir que o implementador salve arquivos.

Parâmetros
`logSaver`	`ILogSaver`: o `ILogSaver`

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

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.