IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

已知的间接子类

FileDownloadCacheWrapper ， GCSFileDownloader

FileDownloadCacheWrapper	一个包装器类，在实现`IFileDownloader`接口时提供`FileDownloadCache`功能。
GCSFileDownloader	文件下载器，可从Google云存储（GCS）下载文件。

下载远程文件的界面。

概要

公开方法
`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)` 检查本地文件的新鲜度。

公开方法

下载文件

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`	如果无法下载文件。

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

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

退货
`boolean`	如果本地文件是最新的，则为true，否则为false。

投掷
`BuildRetrievalError`