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.

FileSystemLogSaver

public class FileSystemLogSaver
extends Object implements ILogSaver

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

Subclasses diretas conhecidas

ATestFileSystemLogSaver

ATestFileSystemLogSaver A classe LogSaver é usada pelo ATest para salvar registros em um caminho específico.

Salve os registros em um sistema de arquivos.

Resumo

Construtores públicos
`FileSystemLogSaver()`

Métodos públicos
`LogFile`	`getLogReportDir()` Receba o `LogFile` que contém o caminho e/ou URL do diretório em que os registros são salvos.
`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. Além disso, crie um diretório exclusivo do sistema de arquivos em `report-dir/[branch/]build-id/test-tag/unique_dir` para salvar os registros.
`LogFile`	`saveLogData(String dataName, LogDataType dataType, InputStream dataStream)` Salve os dados de registro. Compacta e salva o arquivo de registro se `LogDataType.isCompressed()` retornar "false" para `dataType` e `compressed-files` estiver definido. Caso contrário, o fluxo será salvo sem compactação.
`LogFile`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` Salve o arquivo de registros.
`void`	`setCompressFiles(boolean compress)`
`void`	`testModuleEnded()` Informa que o módulo de teste foi encerrado.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Informa o início do módulo de teste.

Métodos protegidos
`File`	`createBuildDir(IBuildInfo buildInfo, File reportDir, String moduleName)` Um método auxiliar para receber ou criar um diretório de build com base nas informações de build da invocação.
`File`	`generateLogReportDir(IBuildInfo buildInfo, File reportDir, String moduleName)` Um método exposto que permite que a subclasse personalize a lógica de geração de caminhos.

Construtores públicos

FileSystemLogSaver

public FileSystemLogSaver ()

Métodos públicos

getLogReportDir

public LogFile getLogReportDir ()

Receba o LogFile que contém o caminho e/ou URL do diretório em que os registros são salvos.

Retorna
`LogFile`	O `LogFile`.

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 depois que ITestInvocationListener.invocationEnded(long) for chamado.

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 pelo framework TradeFederation antes de ITestInvocationListener.invocationStarted(IInvocationContext) ser chamado.

Além disso, crie um diretório exclusivo do sistema de arquivos em report-dir/[branch/]build-id/test-tag/unique_dir para salvar os registros. Se a criação do diretório falhar, os registros serão gravados em um diretório temporário no sistema de arquivos local.

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

saveLogData

public LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

Salve os dados de registro.

Será chamado automaticamente pelo framework TradeFederation sempre que ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) for chamado. Ele também pode ser usado como um método auxiliar para salvar dados de registros extras.

Dependendo da implementação e da política, os registros podem ser salvos de forma compactada. Os registros também podem ser armazenados em um local inacessível ao Tradefed.

Compacta e salva o arquivo de registro se LogDataType.isCompressed() retornar "false" para dataType e compressed-files estiver definido. Caso contrário, o fluxo será salvo sem compactação.

Parâmetros
`dataName`	`String`: um `String` nome descritivo dos dados, por exemplo, "device_logcat".
`dataType`	`LogDataType`: o `LogDataType` do arquivo.
`dataStream`	`InputStream`: o `InputStream` dos dados.

Retorna
`LogFile`	o `LogFile` que contém o caminho e o URL do arquivo salvo.

Gera
`IOException`

saveLogFile

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

Salve o arquivo de registros.

Será chamado automaticamente pela estrutura TradeFederation sempre que ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) for chamado e o stream fizer referência a um arquivo.

Dependendo da implementação e da política, os registros podem ser salvos de forma compactada. Os registros também podem ser armazenados em um local inacessível ao Tradefed.

Parâmetros
`dataName`	`String`: um `String` nome descritivo dos dados, por exemplo, "device_logcat".
`dataType`	`LogDataType`: o `LogDataType` do arquivo.
`fileToLog`	`File`: o `File` a ser salvo.

Retorna
`LogFile`	o `LogFile` que contém o caminho e o URL do arquivo salvo.

Gera
`IOException`

setCompressFiles

public void setCompressFiles (boolean compress)

Parâmetros
`compress`	`boolean`

testModuleEnded

public void testModuleEnded ()

Informa que o módulo de teste foi encerrado.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa o início do módulo de teste.

Parâmetros
`moduleContext`	`IInvocationContext`: informações sobre o módulo.

Métodos protegidos

createBuildDir

protected File createBuildDir (IBuildInfo buildInfo, 
                File reportDir, 
                String moduleName)

Um método auxiliar para receber ou criar um diretório de build com base nas informações de build da invocação.

Crie um diretório exclusivo do sistema de arquivos com a estrutura report-dir/[branch/]build-id/test-tag para salvar registros.

Parâmetros
`buildInfo`	`IBuildInfo`: o `IBuildInfo`
`reportDir`	`File`: o `File` do diretório de relatórios.
`moduleName`	`String`: o nome do módulo de teste

Retorna
`File`	O diretório em que as invocações do mesmo build devem ser salvas.

Gera
`IOException`	se o diretório não puder ser criado porque um arquivo com o mesmo nome existe ou não há permissões para gravar nele.

generateLogReportDir

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir, 
                String moduleName)

Um método exposto que permite que a subclasse personalize a lógica de geração de caminhos.

Parâmetros
`buildInfo`	`IBuildInfo`: o `IBuildInfo`
`reportDir`	`File`: o `File` do diretório de relatórios.
`moduleName`	`String`: o nome do módulo de teste

Retorna
`File`	O diretório criado.

Gera
`IOException`