Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

AndroidBuildArtifactHelper

public class AndroidBuildArtifactHelper
extends Object

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

Classe auxiliar usada para consultar a API Android Build em busca de artefatos de build.

Resumo

Constantes
`String`	`BUILD_ATTEMPT_LATEST`
`String`	`PLATFORM_LINUX`
`String`	`PLATFORM_MAC`
`String`	`PLATFORM_MAC_ARM64`

Construtores públicos
`AndroidBuildArtifactHelper(String buildEnv)` Construtor de AndroidBuildArtifactHelper.
`AndroidBuildArtifactHelper(String buildEnv, boolean strictMode)`
`AndroidBuildArtifactHelper(String buildEnv, boolean strictMode, boolean throwOnQueryFailure)`

Métodos públicos
`RemoteBuildInfo`	`queryForBuild(Build build, String branch, String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)` Executa a consulta real para buscar informações do artefato de build usando a chamada de API "buildartifact.list".
`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)` Consulte informações sobre artefatos de build por ramificação, ID do build e variante.
`RemoteBuildInfo`	`queryForLatestBuild(String branch, String buildFlavor, String os, String pattern)` Consulte as informações do artefato de build por ramificação e variante: o build mais recente bem-sucedido será usado se existir um. Caso contrário, `null` será retornado.
`RemoteBuildInfo`	`queryForLatestBuild(String branch, String buildFlavor, String os)` Consulte as informações do artefato de build por ramificação e variante: o build mais recente bem-sucedido será usado se existir um. Caso contrário, `null` será retornado.

Métodos protegidos
`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)` O objetivo original era oferecer suporte a destinos com um sufixo "fastboot".
`Build`	`getLatestBuild(String branch, String buildFlavor, String os)`
`RemoteBuildInfo`	`queryForBuild(String branch, String buildId, String buildFlavor, String os, String pattern, Set<String> exclusionPatterns)`

Constantes

BUILD_ATTEMPT_LATEST

public static final String BUILD_ATTEMPT_LATEST

Valor da constante: "latest"

PLATFORM_LINUX

protected static final String PLATFORM_LINUX

Valor da constante: "linux"

PLATFORM_MAC

protected static final String PLATFORM_MAC

Valor da constante: "mac"

PLATFORM_MAC_ARM64

protected static final String PLATFORM_MAC_ARM64

Valor da constante: "mac_arm64"

Construtores públicos

AndroidBuildArtifactHelper

public AndroidBuildArtifactHelper (String buildEnv)

Construtor de AndroidBuildArtifactHelper.

Parâmetros
`buildEnv`	`String`: o ambiente da API Build a ser usado.

Gera
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

AndroidBuildArtifactHelper

public AndroidBuildArtifactHelper (String buildEnv, 
                boolean strictMode)

Parâmetros
`buildEnv`	`String`
`strictMode`	`boolean`

Gera
`BuildRetrievalError`

AndroidBuildArtifactHelper

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

Parâmetros
`buildEnv`	`String`
`strictMode`	`boolean`
`throwOnQueryFailure`	`boolean`

Gera
`BuildRetrievalError`

Métodos públicos

queryForBuild

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

Executa a consulta real para buscar informações do artefato de build usando a chamada de API "buildartifact.list".

Parâmetros
`build`	`Build`: uma instância de metadados `Build` opcional, caso uma chamada build.get anterior já tenha sido feita para obter as informações de build descritas por `buildId` e `buildFlavor`. Quando `null`, um novo build.get será feito. Quando não `null`, nenhuma verificação adicional consistente será realizada em `buildId` e `buildFlavor`.
`exclusionPatterns`	`Set`: só se aplica se não houver padrões positivos

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`

queryForBuild

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

Parâmetros
`build`	`Build`
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`

queryForBuildById

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

Consulte informações sobre artefatos de build por ramificação, ID do build e variante.

O parâmetro de ramificação aqui é opcional. Ele serve para compatibilidade com versões anteriores em relação ao formato de consulta de controle de lançamento antigo. A consulta real é feita pelo ID e pelo sabor do build. Se um parâmetro de ramificação for fornecido, mas entrar em conflito com a ramificação real do build, uma resposta null será retornada mesmo que um build possa ser encontrado.

Parâmetros
`exclusionPatterns`	`Set`: só aplique se não houver um padrão positivo

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`

queryForLatestBuild

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

Consulte as informações do artefato de build por ramificação e variante: o build mais recente bem-sucedido será usado se existir um. Caso contrário, null será retornado.

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`

queryForLatestBuild

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

Consulte as informações do artefato de build por ramificação e variante: o build mais recente bem-sucedido será usado se existir um. Caso contrário, null será retornado.

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`

Métodos protegidos

getBuild

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

Parâmetros
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`

Retorna
`Build`

Gera
`BuildRetrievalError`

getBuildArtifactList

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

Parâmetros
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`
`pattern`	`String`
`exclusionPatterns`	`Set`

Retorna
`List<String>`

Gera
`BuildRetrievalError`

getBuildFlavor

protected static String getBuildFlavor (String buildFlavor, 
                String os)

O objetivo original era oferecer suporte a destinos com um sufixo "fastboot". Essa lógica não é mais considerada relevante e pode ser removida no futuro para evitar confusão. Vamos manter esse método por enquanto para evitar adicionar um sufixo inesperado ao sabor de build. Consulte (b/448820244)

Parâmetros
`buildFlavor`	`String`
`os`	`String`

Retorna
`String`

getLatestBuild

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

Parâmetros
`branch`	`String`
`buildFlavor`	`String`
`os`	`String`

Retorna
`Build`

Gera
`BuildRetrievalError`

queryForBuild

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

Parâmetros
`branch`	`String`
`buildId`	`String`
`buildFlavor`	`String`
`os`	`String`
`pattern`	`String`
`exclusionPatterns`	`Set`

Retorna
`RemoteBuildInfo`

Gera
`BuildRetrievalError`