自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

GCSFileDownloader

public class GCSFileDownloader
extends GCSCommon implements IFileDownloader

java.lang.Object
↳	com.android.tradefed.util.GCSCommon
	↳	com.android.tradefed.util.GCSFileDownloader

檔案下載器，可從 Google Cloud Storage (GCS) 下載檔案。

摘要

欄位
`public static final String`	`GCS_APPROX_PREFIX`
`public static final String`	`GCS_PREFIX`

公用建構函式
`GCSFileDownloader(File jsonKeyFile)`
`GCSFileDownloader()`

公用方法
`InputStream`	`downloadFile(String bucketName, String filename)` 從 GCS 值區下載檔案。
`void`	`downloadFile(String remotePath, File destFile)` `downloadFile(String)` 的替代形式，可讓呼叫端指定應放置遠端內容的目標檔案。
`File`	`downloadFile(String remoteFilePath)` 從 GCS 下載檔案。
`boolean`	`isFresh(File localFile, String remotePath)` 檢查本機檔案的最新性。

public static final String GCS_APPROX_PREFIX

public static final String GCS_PREFIX

public GCSFileDownloader (File jsonKeyFile)

參數
`jsonKeyFile`	`File`

public GCSFileDownloader ()

public InputStream downloadFile (String bucketName, 
                String filename)

從 GCS 值區下載檔案。

參數
`bucketName`	`String`：GCS 值區名稱
`filename`	`String`：檔案名稱

傳回
`InputStream`	`ERROR(/InputStream)` 與檔案內容。

public void downloadFile (String remotePath, 
                File destFile)

downloadFile(String) 的替代形式，可讓呼叫端指定應放置遠端內容的目標檔案。

參數
`remotePath`	`String`：相對於特定實作根目錄的下載檔案遠端路徑。
`destFile`	`File`：下載內容的目標檔案。不應存在。

擲回
`BuildRetrievalError`

public File downloadFile (String remoteFilePath)

從 GCS 下載檔案。

目前僅支援 GCS 路徑。

參數
`remoteFilePath`	`String`：以 gs://bucket/file/path 格式輸入 GCS 路徑。

傳回
`File`	本機檔案

擲回
`BuildRetrievalError`

public boolean isFresh (File localFile, 
                String remotePath)

檢查本機檔案的更新頻率。如果本機檔案與遠端檔案相同，則表示檔案為最新版本。否則，本機檔案就會過時。這項功能主要用於快取。預設實作方式一律會傳回 true，因此如果檔案不可變更，就不需要檢查新鮮度。

參數
`localFile`	`File`：本機檔案。
`remotePath`	`String`：遠端檔案路徑。

傳回
`boolean`	如果本機檔案為最新版本，則傳回「是」；否則傳回「否」。

擲回
`BuildRetrievalError`