自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 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`	如果本地文件是新鲜的，则返回 true，否则返回 false。

抛出
`BuildRetrievalError`