本頁面由 Cloud Translation API 翻譯而成。

文件下載器

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

已知的間接子類

文件下載緩存包裝器	一個包裝類，它在實現`IFileDownloader`接口時提供`FileDownloadCache`設施。
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`	如果本地文件是新的則為真，否則為假。

投擲
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

發布下載許可

public void releaseDownloadPermit ()

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