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.

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Subclasses indiretas conhecidas

AndroidBuildDownloader, CasFileDownloader, FileDownloadCacheWrapper, GCSFileDownloader

AndroidBuildDownloader	Um `IFileDownloader` que recupera arquivos da API Android Build.
CasFileDownloader	Faz o download de arquivos do RBE CAS.
FileDownloadCacheWrapper	Uma classe wrapper que fornece recursos `FileDownloadCache` ao implementar a interface `IFileDownloader`.
GCSFileDownloader	Baixador de arquivos para fazer o download de arquivos do Google Cloud Storage (GCS).

Interface para baixar um arquivo remoto.

Resumo

Métodos públicos
`default void`	`acquireDownloadPermit()` Se o limite de simultaneidade for compatível, pegue uma permissão de download.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Forma alternativa de `downloadFile(String,File)`, que permite ao caller baixar uma seção do arquivo e salvar em um arquivo de destino específico.
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` Forma alternativa de `downloadFile(String)`, que permite ao autor da chamada especificar o arquivo de destino em que o conteúdo remoto deve ser colocado.
`abstract File`	`downloadFile(String remoteFilePath)` Baixa um arquivo remoto para um arquivo temporário no disco local.
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` Baixe os arquivos que correspondem aos filtros especificados em um arquivo ZIP remoto.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Verificar a atualização do arquivo local.
`default void`	`releaseDownloadPermit()` Se o limite de simultaneidade for compatível, libere uma permissão de download.

Métodos públicos

acquireDownloadPermit

public void acquireDownloadPermit ()

Se o limite de simultaneidade for compatível, pegue uma permissão de download.

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

Forma alternativa de downloadFile(String,File), que permite ao caller baixar uma seção do arquivo e salvar em um arquivo de destino específico.

Parâmetros
`remoteFilePath`	`String`: o caminho remoto para o arquivo a ser baixado, relativo a uma raiz específica da implementação.
`destFile`	`File`: o arquivo em que o conteúdo baixado será colocado. Não pode existir.
`startOffset`	`long`: o deslocamento inicial no arquivo remoto.
`size`	`long`: o número de bytes a serem baixados do arquivo remoto. Defina um valor negativo para baixar o arquivo inteiro.

Gera
`BuildRetrievalError`	se não for possível fazer o download do arquivo

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Forma alternativa de downloadFile(String), que permite ao autor da chamada especificar o arquivo de destino em que o conteúdo remoto deve ser colocado.

Parâmetros
`relativeRemotePath`	`String`: o caminho remoto para o arquivo a ser baixado, relativo a uma raiz específica da implementação.
`destFile`	`File`: o arquivo em que o conteúdo baixado será colocado. Não pode existir.

Gera
`BuildRetrievalError`	se não for possível fazer o download do arquivo

downloadFile

public abstract File downloadFile (String remoteFilePath)

Baixa um arquivo remoto para um arquivo temporário no disco local.

Parâmetros
`remoteFilePath`	`String`: o caminho remoto para o arquivo a ser baixado, relativo a uma raiz específica da implementação.

Retorna
`File`	o `File` temporário baixado localmente.

Gera
`BuildRetrievalError`	se não for possível fazer o download do arquivo

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                List<String> includeFilters, 
                List<String> excludeFilters)

Baixe os arquivos que correspondem aos filtros especificados em um arquivo ZIP remoto.

Um arquivo dentro do arquivo ZIP remoto só é baixado se o caminho dele corresponder a um dos filtros de inclusão, mas não aos de exclusão.

Parâmetros
`destDir`	`File`: o arquivo em que o conteúdo baixado será colocado.
`remoteFilePath`	`String`: o caminho remoto para o arquivo a ser baixado, relativo a uma raiz específica da implementação.
`includeFilters`	`List`: uma lista de filtros para baixar arquivos correspondentes.
`excludeFilters`	`List`: uma lista de filtros para ignorar o download de arquivos correspondentes.

Gera
`BuildRetrievalError`	se não for possível fazer o download dos arquivos.
	java.io.IOException
`IOException`

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Verificar a atualização do arquivo local. Se o arquivo local for igual ao remoto, ele estará atualizado. Caso contrário, o arquivo local está desatualizado. Isso é usado principalmente para cache. A implementação padrão sempre vai retornar "true". Portanto, se o arquivo for imutável, não será necessário verificar a atualização.

Parâmetros
`localFile`	`File`: arquivo local.
`remoteFilePath`	`String`: caminho do arquivo remoto.

Retorna
`boolean`	True se o arquivo local estiver atualizado. Caso contrário, false.

Gera
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

releaseDownloadPermit

public void releaseDownloadPermit ()

Se o limite de simultaneidade for compatível, libere uma permissão de download.