為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

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

包裝函式類別，可在實作 IFileDownloader 介面時提供 FileDownloadCache 設施。

在您想將快取的使用方式從呼叫端抽象化時，這項功能就很實用。

摘要

公用建構函式
`FileDownloadCacheWrapper(File cacheDir, IFileDownloader delegateDownloader)`

公用方法
`void`	`downloadFile(String remoteFilePath, File destFile)` `downloadFile(String)` 的替代形式，可讓呼叫端指定應放置遠端內容的目標檔案。
`File`	`downloadFile(String remoteFilePath)` 將遠端檔案下載至本機磁碟上的暫存檔案。
`void`	`downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, 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`	臨時下載的 `ERROR(/File)`。

擲回
`BuildRetrievalError`

downloadZippedFiles

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`	如果本機檔案為最新版本，則傳回「是」；否則傳回「否」。

擲回
`BuildRetrievalError`