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

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

AndroidBuildArtifactHelper

public class AndroidBuildArtifactHelper
extends Object

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

用於查詢 Android Build API 的輔助類別，可取得建構構件。

摘要

常數
`String`	`BUILD_ATTEMPT_LATEST`
`String`	`PLATFORM_LINUX`
`String`	`PLATFORM_MAC`
`String`	`PLATFORM_MAC_ARM64`

公用建構函式
`AndroidBuildArtifactHelper(String buildEnv)` AndroidBuildArtifactHelper 的建構函式。
`AndroidBuildArtifactHelper(String buildEnv, boolean strictMode)`
`AndroidBuildArtifactHelper(String buildEnv, boolean strictMode, boolean throwOnQueryFailure)`

公用方法
`RemoteBuildInfo`	`queryForBuild(Build build, String branch, String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)` 透過 buildartifact.list API 呼叫執行實際查詢，擷取建構構件資訊。
`RemoteBuildInfo`	`queryForBuild(Build build, String branch, String buildId, String buildFlavor, String os)`
`RemoteBuildInfo`	`queryForBuildById(String branch, String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)` 依分支、建構作業 ID 和風味查詢建構作業構件資訊。
`RemoteBuildInfo`	`queryForLatestBuild(String branch, String buildFlavor, String os, String pattern)` 依分支版本和變種版本查詢建構構件資訊：如有最新建構成功版本，則會使用該版本，否則會傳回 `null`
`RemoteBuildInfo`	`queryForLatestBuild(String branch, String buildFlavor, String os)` 依分支版本和變種版本查詢建構構件資訊：如有最新建構成功版本，則會使用該版本，否則會傳回 `null`

受保護的方法
`Build`	`getBuild(String branch, String buildId, String buildFlavor, String os)`
`List<String>`	`getBuildArtifactList(String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)`
`static String`	`getBuildFlavor(String buildFlavor, String os)` 這項功能的原始目的是支援帶有「fastboot」後置字元的目標。
`Build`	`getLatestBuild(String branch, String buildFlavor, String os)`
`RemoteBuildInfo`	`queryForBuild(String branch, String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)`

常數

BUILD_ATTEMPT_LATEST

public static final String BUILD_ATTEMPT_LATEST

常數值： "latest"

PLATFORM_LINUX

protected static final String PLATFORM_LINUX

常數值： "linux"

PLATFORM_MAC

protected static final String PLATFORM_MAC

常數值： "mac"

PLATFORM_MAC_ARM64

protected static final String PLATFORM_MAC_ARM64

常數值： "mac_arm64"

公用建構函式

AndroidBuildArtifactHelper

public AndroidBuildArtifactHelper (String buildEnv)

AndroidBuildArtifactHelper 的建構函式。

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

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

AndroidBuildArtifactHelper

public AndroidBuildArtifactHelper (String buildEnv, 
                boolean strictMode)

參數
`buildEnv`	`String`
`strictMode`	`boolean`

擲回
`BuildRetrievalError`

AndroidBuildArtifactHelper

public AndroidBuildArtifactHelper (String buildEnv, 
                boolean strictMode, 
                boolean throwOnQueryFailure)

參數
`buildEnv`	`String`
`strictMode`	`boolean`
`throwOnQueryFailure`	`boolean`

擲回
`BuildRetrievalError`

公用方法

queryForBuild

public RemoteBuildInfo queryForBuild (Build build, 
                String branch, 
                String buildId, 
                String buildFlavor, 
                String os, 
                String pattern, 
                Set<String> exclusionPatterns)

透過 buildartifact.list API 呼叫，執行實際查詢來擷取建構構件資訊。

參數
`build`	`Build`：選用的 `Build` 中繼資料執行個體，以防先前已進行 build.get 呼叫，取得 `buildId` 和 `buildFlavor` 所述的建構資訊；如果是 `null`，系統會進行新的 build.get；如果不是 `null`，系統不會對 `buildId` 和 `buildFlavor` 執行額外的一致性檢查
`exclusionPatterns`	`Set`：僅適用於沒有正向模式的情況

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`

queryForBuild

public RemoteBuildInfo queryForBuild (Build build, 
                String branch, 
                String buildId, 
                String buildFlavor, 
                String os)

參數
`build`	`Build`
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`

queryForBuildById

public RemoteBuildInfo queryForBuildById (String branch, 
                String buildId, 
                String buildFlavor, 
                String os, 
                String pattern, 
                Set<String> exclusionPatterns)

依分支、建構作業 ID 和風味查詢建構作業構件資訊。

請注意，這裡的分支參數為選用，目的是為了與舊版啟動控制查詢格式向後相容。實際查詢作業是依據建構 ID 和變種版本進行，如果提供分支版本參數，但與建構的實際分支版本發生衝突，即使可以找到建構版本，系統仍會傳回 null 回應。

參數
`exclusionPatterns`	`Set`：只有在沒有正向模式時才套用

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`

queryForLatestBuild

public RemoteBuildInfo queryForLatestBuild (String branch, 
                String buildFlavor, 
                String os, 
                String pattern)

依分支版本和變種版本查詢建構構件資訊：如有最新建構成功版本，則會使用該版本，否則會傳回 null

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`

queryForLatestBuild

public RemoteBuildInfo queryForLatestBuild (String branch, 
                String buildFlavor, 
                String os)

依分支版本和變種版本查詢建構構件資訊：如有最新建構成功版本，則會使用該版本，否則會傳回 null

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`

受保護的方法

getBuild

protected Build getBuild (String branch, 
                String buildId, 
                String buildFlavor, 
                String os)

參數
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`

傳回
`Build`

擲回
`BuildRetrievalError`

getBuildArtifactList

protected List<String> getBuildArtifactList (String buildId, 
                String buildFlavor, 
                String os, 
                String pattern, 
                Set<String> exclusionPatterns)

參數
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`
`pattern`	`String`
`exclusionPatterns`	`Set`

傳回
`List<String>`

擲回
`BuildRetrievalError`

getBuildFlavor

protected static String getBuildFlavor (String buildFlavor, 
                String os)

這項功能的原始目的是支援具有「fastboot」後置字串的目標。這項邏輯已不適用，日後可能會移除，以免造成混淆。我們目前保留這個方法，以免在建構風味中加入非預期的後置字串。請參閱 (b/448820244)

參數
`buildFlavor`	`String`
`os`	`String`

傳回
`String`

getLatestBuild

protected Build getLatestBuild (String branch, 
                String buildFlavor, 
                String os)

參數
`branch`	`String`
`buildFlavor`	`String`
`os`	`String`

傳回
`Build`

擲回
`BuildRetrievalError`

queryForBuild

protected RemoteBuildInfo queryForBuild (String branch, 
                String buildId, 
                String buildFlavor, 
                String os, 
                String pattern, 
                Set<String> exclusionPatterns)

參數
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`
`pattern`	`String`
`exclusionPatterns`	`Set`

傳回
`RemoteBuildInfo`

擲回
`BuildRetrievalError`