本頁面由 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 ()

如果支持並發限制，則釋放下載許可。