自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

FileDownloadCacheWrapper

public class FileDownloadCacheWrapper
extends Object implements IFileDownloader

java.lang.Object
↳	com.android.tradefed.build.FileDownloadCacheWrapper

一个封装容器类，用于提供 FileDownloadCache 功能，同时实现 IFileDownloader 接口。

适用于您想要从调用方抽象缓存使用的情况。

摘要

公共构造函数
`FileDownloadCacheWrapper(File cacheDir, IFileDownloader delegateDownloader)`

公共方法
`void`	`downloadFile(String remoteFilePath, File destFile)` `downloadFile(String)` 的替代形式，允许调用方指定应将远程内容放置在哪个目标文件中。
`File`	`downloadFile(String remoteFilePath)` 将远程文件下载到本地磁盘上的临时文件。
`void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` 下载远程 zip 文件中与给定过滤器匹配的文件。
`boolean`	`isFresh(File localFile, String remoteFilePath)` 检查本地文件的新鲜度。

公共构造函数

FileDownloadCacheWrapper

public FileDownloadCacheWrapper (File cacheDir, 
                IFileDownloader delegateDownloader)

参数
`cacheDir`	`File`
`delegateDownloader`	`IFileDownloader`

公共方法

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile)

downloadFile(String) 的替代形式，允许调用方指定应将远程内容放置在哪个目标文件中。

参数
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。
`destFile`	`File`：用于放置下载内容的文件。不应存在。

抛出
`BuildRetrievalError`

downloadFile

public File downloadFile (String remoteFilePath)

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

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

返回
`File`	临时本地下载的 `File`。

抛出
`BuildRetrievalError`

downloadZippedFiles

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

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

只有当远程 zip 文件中的文件的路径与任何包含过滤器匹配，但不与排除过滤器匹配时，该文件才会被下载。

参数
`destDir`	`File`：用于放置下载内容的文件。
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。
`includeFilters`	`List`：用于下载匹配文件的过滤器列表。
`excludeFilters`	`List`：用于跳过下载匹配文件的过滤器列表。

抛出
`BuildRetrievalError`
`IOException`

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

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

返回
`boolean`	如果本地文件是新鲜的，则返回 true，否则返回 false。

抛出
`BuildRetrievalError`