為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

AndroidBuildFetcher

public class AndroidBuildFetcher
extends Object

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

用於從 Android Build API 下載檔案的輔助程式類別。

摘要

公用建構函式
`AndroidBuildFetcher(String buildEnv)` AndroidBuildFetcher 的建構函式。

公用方法
`void`	`fetchArtifact(String target, String buildId, String resourceId, String attemptId, File outputFile)` Download artifact to local file.
`void`	`fetchArtifact(String target, String buildId, String resourceId, String attemptId, File outputFile, long startOffset, long size)` 將構件的一部分下載到本機檔案，並提供指定範圍。
`void`	`fetchDeviceBlob(String deviceName, String binaryType, String version, File outputFile)` 將裝置 Blob 下載至本機檔案。
`BuildArtifactMetadata`	`getArtifactMetadata(String target, String buildId, String resourceId, String attemptId)` 取得建構構件的中繼資料。
`void`	`setUseMd5(boolean useMd5)`

公用建構函式

AndroidBuildFetcher

public AndroidBuildFetcher (String buildEnv)

AndroidBuildFetcher 的建構函式。

參數
`buildEnv`	`String`：要使用的 Build API 環境。

擲回
	java.io.IOException
	java.security.GeneralSecurityException
`GeneralSecurityException`
`IOException`

公用方法

fetchArtifact

public void fetchArtifact (String target, 
                String buildId, 
                String resourceId, 
                String attemptId, 
                File outputFile)

將構件下載至本機檔案。

參數
`target`	`String`：構件目標。如果為空值，下載就會失敗。
`buildId`	`String`：構件 buildId。如果為空值，下載就會失敗。
`resourceId`	`String`：要下載的檔案名稱。如果為空值，下載就會失敗。
`attemptId`	`String`：最新、目前或嘗試 ID，預設為最新。
`outputFile`	`File`：將檔案下載至這個本機檔案。

擲回
	com.android.tradefed.build.BuildRetrievalError
	java.io.IOException
`BuildRetrievalError`
`IOException`

fetchArtifact

public void fetchArtifact (String target, 
                String buildId, 
                String resourceId, 
                String attemptId, 
                File outputFile, 
                long startOffset, 
                long size)

使用指定範圍將部分構件下載到本機檔案。

參數
`target`	`String`：構件目標。如果為空值，下載就會失敗。
`buildId`	`String`：構件 buildId。如果為空值，下載就會失敗。
`resourceId`	`String`：要下載的檔案名稱。如果為空值，下載就會失敗。
`attemptId`	`String`：最新、目前或嘗試 ID，預設為最新。
`outputFile`	`File`：將檔案下載至這個本機檔案。
`startOffset`	`long`：要下載的檔案起始位移。
`size`	`long`：要下載的位元組數。設為負值即可擷取整個檔案。

擲回
	com.android.tradefed.build.BuildRetrievalError
	java.io.IOException
`BuildRetrievalError`
`IOException`

fetchDeviceBlob

public void fetchDeviceBlob (String deviceName, 
                String binaryType, 
                String version, 
                File outputFile)

將裝置 Blob 下載至本機檔案。

參數
`deviceName`	`String`：如果這個值為空值，下載作業就會失敗。
`binaryType`	`String`：radio.img 或 bootloader.img。如果這個值為空值，下載作業就會失敗。
`version`	`String`：裝置版本。如果這個值為空值，下載作業就會失敗。
`outputFile`	`File`：本機檔案。將 Blob 下載到這個本機檔案。

擲回
	java.io.IOException
`IOException`

getArtifactMetadata

public BuildArtifactMetadata getArtifactMetadata (String target, 
                String buildId, 
                String resourceId, 
                String attemptId)

取得建構構件的中繼資料。

參數
`target`	`String`：構件目標。如果為空值，下載就會失敗。
`buildId`	`String`：構件 buildId。如果為空值，下載就會失敗。
`resourceId`	`String`：要下載的檔案名稱。如果為空值，下載就會失敗。
`attemptId`	`String`：最新、目前或嘗試 ID，預設為最新。

傳回
`BuildArtifactMetadata`	`BuildArtifactMetadata` 物件。

擲回
	java.io.IOException
`IOException`

setUseMd5

public void setUseMd5 (boolean useMd5)

參數
`useMd5`	`boolean`