此页面由 Cloud Translation API 翻译。

文件下载器

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

已知的间接子类

FileDownloadCacheWrapper ， GCSFileDownloader

文件下载缓存包装器	包装类，提供`FileDownloadCache`设施，同时实现`IFileDownloader`接口。
GCS文件下载器	文件下载器从谷歌云存储（GCS）下载文件。

下载远程文件的界面。

概括

公共方法
`default void`	`acquireDownloadPermit ()` 如果支持并发限制，请获取下载许可。
`default void`	`downloadFile (String remoteFilePath, File destFile, long startOffset, long size)` 的另一种形式`downloadFile(String, File)` ，它允许呼叫者下载文件的一部分，并保存到特定的目标文件。
`abstract void`	`downloadFile (String relativeRemotePath, File destFile)` 的替代形式`downloadFile(String)` ，它允许呼叫方指定目的地文件的远程内容应放置英寸
`abstract File`	`downloadFile (String remoteFilePath)` 将远程文件下载到本地磁盘上的临时文件。
`default void`	`downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters)` `downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters)` `downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters)` 在远程 zip 文件中下载与给定过滤器匹配的文件。
`default boolean`	`isFresh (File localFile, String remoteFilePath)` 检查本地文件的新鲜度。
`default void`	`releaseDownloadPermit ()` 如果支持并发限制，则释放下载许可。

公共方法

获取下载许可

public void acquireDownloadPermit ()

如果支持并发限制，请获取下载许可。

下载文件

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

的另一种形式downloadFile(String, File) ，它允许呼叫者下载文件的一部分，并保存到特定的目标文件。

参数
`remoteFilePath`	`String` ：相对于实现特定的根远程路径下载的文件。
`destFile`	`File` ：文件将下载的内容放入。不应该存在。
`startOffset`	`long` ：开始在远程文件偏移。
`size`	`long` ：字节数从远程下载文件。将其设置为负值以下载整个文件。

投掷
`BuildRetrievalError`	如果无法下载文件

下载文件

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

的替代形式downloadFile(String) ，它允许呼叫方指定目的地文件的远程内容应放置英寸

参数
`relativeRemotePath`	`String` ：相对于实现特定的根远程路径下载的文件。
`destFile`	`File` ：文件将下载的内容放入。不应该存在。

投掷
`BuildRetrievalError`	如果无法下载文件

下载文件

public abstract File downloadFile (String remoteFilePath)

将远程文件下载到本地磁盘上的临时文件。

参数
`remoteFilePath`	`String` ：相对于实现特定的根远程路径下载的文件。

退货
`File`	临时本地下载`ERROR(/File)` 。

投掷
`BuildRetrievalError`	如果无法下载文件

下载压缩文件

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

在远程 zip 文件中下载与给定过滤器匹配的文件。

远程 zip 文件中的文件仅下载到与任何包含过滤器匹配的路径，而不是与排除过滤器匹配的路径。

参数
`destDir`	`File` ：文件将下载的内容放入。
`remoteFilePath`	`String` ：相对于实现特有的根远程路径下载的文件。
`includeFilters`	：用于下载匹配文件的过滤器列表。
`excludeFilters`	：跳过下载匹配文件的过滤器列表。

投掷
`BuildRetrievalError`	如果无法下载文件。

是新鲜的

public boolean isFresh (File localFile, 
                String remoteFilePath)

检查本地文件的新鲜度。如果本地文件与远程文件相同，则它是新鲜的。如果没有，本地文件是陈旧的。这主要用于缓存。默认实现将始终返回 true，因此如果文件是不可变的，它将永远不需要检查新鲜度。

参数
`localFile`	`File` ：本地文件。
`remoteFilePath`	`String` ：远程文件路径。

退货
`boolean`	如果本地文件是新鲜的，则为真，否则为假。

投掷
`BuildRetrievalError`

释放下载许可

public void releaseDownloadPermit ()

如果支持并发限制，则释放下载许可。