自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

AndroidBuildDownloader

public class AndroidBuildDownloader
extends Object implements IFileDownloader

java.lang.Object
↳	com.google.android.tradefed.build.AndroidBuildDownloader

一种 IFileDownloader，用于从 Android Build API 检索文件。

摘要

字段
`protected static final ConcurrentMap<String, RemoteZip>`	`REMOTE_ZIP_CACHE` 远程 zip 文件的缓存，按远程路径编制索引。

公共构造函数
`AndroidBuildDownloader()`

公共方法
`static File`	`createTempFile(String remoteFilePath, File rootDir)` 在临时磁盘上创建一个唯一文件，用于存放具有给定路径的下载文件。
`void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` `downloadFile(String,File)` 的替代形式，允许调用方下载文件的某个部分并保存到特定目标文件。
`void`	`downloadFile(String remoteFilePath, File destFile)` `downloadFile(String)` 的替代形式，允许调用方指定应将远程内容放入的目标文件。
`File`	`downloadFile(String remoteFilePath)` 将远程文件下载到本地磁盘上的临时文件。
`void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` 下载远程 zip 文件中与给定过滤器匹配的文件。
`void`	`enablePartialDownloadCache(boolean enablePartialDownloadCache)`
`void`	`setMetadataCheck(boolean enableMetadataCheck)`
`void`	`setResolveSymlinks(boolean resolveSymlinks)`
`void`	`setUseMd5(boolean useMd5)`

受保护的方法
`AndroidBuildFetcher`	`getBuildFetcher()` 返回 AndroidBuildFetcher，如果不存在，则创建一个。
`void`	`setBuildEnvironment(String buildEnvironment)`

字段

REMOTE_ZIP_CACHE

protected static final ConcurrentMap<String, RemoteZip> REMOTE_ZIP_CACHE

远程 zip 文件的缓存，按远程路径编制索引。

公共构造函数

AndroidBuildDownloader

public AndroidBuildDownloader ()

公共方法

createTempFile

public static File createTempFile (String remoteFilePath, 
                File rootDir)

在临时磁盘上创建一个唯一文件，用于存放具有给定路径的下载文件。

根据路径中的基本文件名构造文件名

参数
`remoteFilePath`	`String`：用于构造名称的远程路径
`rootDir`	`File`

返回
`File`

抛出
`BuildRetrievalError`

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

downloadFile(String,File) 的替代形式，允许调用方下载文件的某个部分并保存到特定目标文件。

参数
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。
`destFile`	`File`：用于存放下载内容的文件。不应存在。
`startOffset`	`long`：远程文件中的起始偏移量。
`size`	`long`：要从远程文件下载的字节数。将其设置为负值可下载整个文件。

抛出
`BuildRetrievalError`

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile)

downloadFile(String) 的替代形式，允许调用方指定应将远程内容放入的目标文件。

参数
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。
`destFile`	`File`：用于存放下载内容的文件。不应存在。

抛出
`BuildRetrievalError`

downloadFile

public File downloadFile (String remoteFilePath)

将远程文件下载到本地磁盘上的临时文件。

参数
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。

返回
`File`	下载的临时本地 `File`。

抛出
`BuildRetrievalError`

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                List<String> includeFilters, 
                List<String> excludeFilters)

下载远程 zip 文件中与给定过滤器匹配的文件。

只有当远程 zip 文件中的文件的路径与任何包含过滤器匹配但不与任何排除过滤器匹配时，才会下载该文件。

参数
`destDir`	`File`：用于存放下载内容的文件。
`remoteFilePath`	`String`：要下载的文件的远程路径，相对于实现特定的根目录。
`includeFilters`	`List`：用于下载匹配文件的过滤器列表。
`excludeFilters`	`List`：用于跳过下载匹配文件的过滤器列表。

抛出
`BuildRetrievalError`
`IOException`

enablePartialDownloadCache

public void enablePartialDownloadCache (boolean enablePartialDownloadCache)

参数
`enablePartialDownloadCache`	`boolean`

setMetadataCheck

public void setMetadataCheck (boolean enableMetadataCheck)

参数
`enableMetadataCheck`	`boolean`

setResolveSymlinks

public void setResolveSymlinks (boolean resolveSymlinks)

参数
`resolveSymlinks`	`boolean`

setUseMd5

public void setUseMd5 (boolean useMd5)

参数
`useMd5`	`boolean`

受保护的方法

getBuildFetcher

protected AndroidBuildFetcher getBuildFetcher ()

返回 AndroidBuildFetcher，如果不存在，则创建一个。

返回
`AndroidBuildFetcher`

抛出
`GeneralSecurityException`
`IOException`

setBuildEnvironment

protected void setBuildEnvironment (String buildEnvironment)

参数
`buildEnvironment`	`String`