A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Subclasses indiretas conhecidas

FileDownloadCacheWrapper, GCSFileDownloader

FileDownloadCacheWrapper	Uma classe wrapper que fornece recursos `FileDownloadCache` ao implementar a interface `IFileDownloader`.
GCSFileDownloader	Downloader de arquivos para fazer o download de arquivos do Google Cloud Storage (GCS).

Interface para fazer o download de um arquivo remoto.

Resumo

Métodos públicos
`default void`	`acquireDownloadPermit()` Se o limite de simultaneidade tiver suporte, faça uma permissão de download.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Forma alternativa de `downloadFile(String, File)`, que permite que o autor da chamada faça o download de uma seção do arquivo e salve em um arquivo de destino específico.
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` Forma alternativa de `downloadFile(String)`, que permite que o autor da chamada especifique o arquivo de destino em que o conteúdo remoto será colocado.
`abstract File`	`downloadFile(String remoteFilePath)` Faz o download de um arquivo remoto para um arquivo temporário no disco local.
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters)` Faça o download dos arquivos que correspondem aos filtros em um arquivo ZIP remoto.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Verifique a atualização do arquivo local.
`default void`	`releaseDownloadPermit()` Se o limite de simultaneidade tiver suporte, libere uma permissão de download.

Métodos públicos

acquireDownloadPermit

public void acquireDownloadPermit ()

Se o limite de simultaneidade tiver suporte, faça 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 que o autor da chamada faça o download de uma seção do arquivo e salve em um arquivo de destino específico.

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

Gera
`BuildRetrievalError`	if file could not be downloaded

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

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

Gera
`BuildRetrievalError`	if file could not be downloaded

downloadFile

public abstract File downloadFile (String remoteFilePath)

Faz o download de um arquivo remoto para um arquivo temporário no disco local.

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

Retorna
`File`	o local temporário fez o download de `ERROR(/File)`.

Gera
`BuildRetrievalError`	if file could not be downloaded

downloadZippedFiles

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

Faça o download dos arquivos que correspondem aos filtros em um arquivo ZIP remoto.

Um arquivo dentro do arquivo ZIP remoto só é transferido por download para o caminho correspondente a qualquer um dos filtros de inclusão, mas não aos filtros de exclusão.

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

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

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Verifique a atualização do arquivo local. Se o arquivo local for o mesmo que o remoto, ele será 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, ele nunca precisará verificar a atualização.

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

Retorna
`boolean`	Verdadeiro se o arquivo local estiver atualizado. Caso contrário, é falso.

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

releaseDownloadPermit

public void releaseDownloadPermit ()

Se o limite de simultaneidade tiver suporte, libere uma permissão de download.