A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Subclasses diretas conhecidas

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	Um `IBuildInfo` que representa um aplicativo Android e os pacotes de teste dele.
DeviceBuildInfo	Um `IBuildInfo` que representa um build completo de dispositivo Android e (opcionalmente) os testes dele.
FolderBuildInfo	Implementação concreta de um `IFolderBuildInfo`.
OtatoolsBuildInfo	Um `IBuildInfo` que contém artefatos otatools.

Subclasses indiretas conhecidas

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Esta classe foi descontinuada. Use `IDeviceBuildInfo` diretamente.
ClusterBuildInfo	Uma classe `IBuildInfo` para builds transmitidos do TFC.
DeviceFolderBuildInfo	Um `IDeviceBuildInfo` que também contém outros artefatos de build contidos em um diretório no sistema de arquivos local.
OtaDeviceBuildInfo	Um `IDeviceBuildInfo` usado para testes de atualização over-the-air.

Implementação genérica de uma IBuildInfo que precisa ser associada a uma ITestDevice.

Resumo

Construtores públicos
`BuildInfo()` Cria um `BuildInfo` usando valores de atributo padrão.
`BuildInfo(String buildId, String buildTargetName)` Cria um `BuildInfo`

Métodos públicos
`void`	`addAppPackageFile(File appPackageFile, String version)` Adiciona o arquivo apk local e a versão associada.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` Adicione um atributo de build.
`void`	`addBuildAttributes( buildAttributes)` Adicionar atributos de build
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Define a permissão para permitir a preparação de arquivos remotos.
`void`	`cleanUp()` Limpar todos os arquivos de build temporários
`void`	`cleanUp( doNotClean)` Versão de `cleanUp()` em que alguns arquivos não são excluídos.
`IBuildInfo`	`clone()`
`final void`	`copyAllFileFrom(BuildInfo build)` Copiar todos os `VersionedFile` de um build específico para este.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` Operação inversa para `toProto()` para recuperar a instância.
	`getAppPackageFiles()` Recebe uma cópia do conjunto de arquivos APK do app local e das versões deles.
	`getBuildAttributes()` Receba um conjunto de pares de nome-valor de atributos adicionais que descrevem o build.
`String`	`getBuildBranch()` Método opcional para retornar a ramificação de controle de origem em que o build testado foi produzido.
`String`	`getBuildFlavor()` Método opcional para retornar o tipo de build que está sendo testado.
`String`	`getBuildId()` Retorna o identificador exclusivo do build em teste.
`String`	`getBuildTargetName()` Retorna o nome completo do build que está sendo testado.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Método auxiliar para recuperar um arquivo com o nome especificado.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar um arquivo com um `BuildInfoFileKey` fornecido.
	`getFiles()` Retorna todos os `VersionedFile`s armazenados neste `BuildInfo`.
	`getProperties()` Retorna uma cópia das propriedades definidas no `IBuildInfo`.
	`getRemoteFiles()` Receba os caminhos para artefatos de build que são de download atrasado.
`String`	`getTestTag()` Retorna um nome exclusivo para os testes em execução.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar uma versão de arquivo com um `BuildInfoFileKey` fornecido.
`String`	`getVersion(String name)` Método auxiliar para recuperar uma versão de arquivo com o nome fornecido.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para extrair um `VersionedFile` com um `BuildInfoFileKey` específico.
`final VersionedFile`	`getVersionedFile(String name)` Método auxiliar para extrair um `VersionedFile` com um nome específico.
	`getVersionedFileKeys()` Retorna o conjunto de chaves disponível para consultar `VersionedFile` usando `getFile(BuildInfoFileKey)`.
`final`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar uma lista de `VersionedFile`s associadas a uma determinada `BuildInfoFileKey`.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Remove um determinado attributeName do rastreamento.
`void`	`setBuildBranch(String branch)` Definir a ramificação do build
`void`	`setBuildFlavor(String buildFlavor)` Defina o sabor do build.
`void`	`setBuildId(String buildId)` Define o identificador exclusivo do build em teste.
`void`	`setDeviceSerial(String serial)` Defina o número de série `ITestDevice` associado a este build.
`void`	`setFile(String name, File file, String version)` Armazena um arquivo com o nome fornecido nessas informações de build.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Armazena um arquivo com um `BuildInfoFileKey` nessas informações de build.
`void`	`setProperties(BuildInfoProperties... properties)` Defina o `BuildInfoProperties` para a instância `IBuildInfo`.
`void`	`setTestTag(String testTag)` Define o nome exclusivo dos testes que estão sendo executados.
`File`	`stageRemoteFile(String fileName, File workingDir)` Colocar um arquivo que faz parte de arquivos remotos no diretório raiz das informações de build em estágio.
`BuildInformation.BuildInfo`	`toProto()` Serializa a instância do BuildInfo em um protobuf.
`String`	`toString()`

Métodos protegidos
`void`	`addAllBuildAttributes(BuildInfo build)` Método auxiliar para copiar atributos, branches e sabores de build de outro build.
`void`	`addAllFiles(BuildInfo build)` Método auxiliar para copiar todos os arquivos do outro build.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Permite aplicar algumas das `IBuildInfo.BuildInfoProperties` e possivelmente fazer um processamento diferente.
`MultiMap<String, String>`	`getAttributesMultiMap()`
	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Construtores públicos

BuildInfo

public BuildInfo ()

Cria um BuildInfo usando valores de atributo padrão.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Cria um BuildInfo

Parâmetros
`buildId`	`String`: o ID do build
`buildTargetName`	`String`: o nome do destino de build

Métodos públicos

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Adiciona o arquivo apk local e a versão associada. Os APKs serão retornados de getAppPackageFiles() na ordem em que foram adicionados por esse método.

Parâmetros
`appPackageFile`	`File`
`version`	`String`

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Adicione um atributo de build. Isso não permite substituir um attributeName existente.

Parâmetros
`attributeName`	`String`: o nome do atributo exclusivo
`attributeValue`	`String`: o valor do atributo

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Adicionar atributos de build

Parâmetros
`buildAttributes`	: mapeamento de atributos a serem adicionados

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Define a permissão para permitir a preparação de arquivos remotos.

Parâmetros
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

Limpar todos os arquivos de build temporários

cleanUp

public void cleanUp ( doNotClean)

Versão de cleanUp() em que alguns arquivos não são excluídos.

Parâmetros
`doNotClean`

clone

public IBuildInfo clone ()

Retorna
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copiar todos os VersionedFile de um build específico para este.

Parâmetros
`build`	`BuildInfo`

equals

public boolean equals (Object obj)

Parâmetros
`obj`	`Object`

Retorna
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operação inversa para toProto() para recuperar a instância.

Parâmetros
`protoBuild`	`BuildInformation.BuildInfo`

Retorna
`IBuildInfo`

getAppPackageFiles

public  getAppPackageFiles ()

Recebe uma cópia do conjunto de arquivos APK do app local e das versões deles. A ordem retornada corresponde à ordem em que os APKs foram adicionados ao IAppBuildInfo.

Retorna

getBuildAttributes

public  getBuildAttributes ()

Receba um conjunto de pares de nome-valor de atributos adicionais que descrevem o build.

Retorna
	um `ERROR(/Map)` de atributos de build. Não será `null`, mas poderá estar vazio.

getBuildBranch

public String getBuildBranch ()

Método opcional para retornar a ramificação de controle de origem em que o build testado foi produzido.

Retorna
`String`	o branch de build ou `null`, se não definido/não aplicável

getBuildFlavor

public String getBuildFlavor ()

Método opcional para retornar o tipo de build que está sendo testado.

Uma implementação comum para builds da plataforma Android é retornar (build product)-(build os)-(build variant). ie generic-linux-userdebug

Retorna
`String`	o tipo de build ou `null`, se não definido/não aplicável

getBuildId

public String getBuildId ()

Retorna o identificador exclusivo do build em teste. Nunca pode ser nulo. O valor padrão é UNKNOWN_BUILD_ID.

Retorna
`String`

getBuildTargetName

public String getBuildTargetName ()

Retorna o nome completo do build que está sendo testado.

Uma implementação comum é criar o nome do destino de build a partir de uma combinação do sabor do build e do nome do branch. [por exemplo, (nome da ramificação)-(variação de build)]

Retorna
`String`

getDeviceSerial

public String getDeviceSerial ()

Retorna
`String`

getFile

public File getFile (String name)

Método auxiliar para recuperar um arquivo com o nome especificado.

Retorna
`File`	o arquivo de imagem ou `null` se não for encontrado

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar um arquivo com um BuildInfoFileKey fornecido.

Parâmetros
`key`	`BuildInfoKey.BuildInfoFileKey`: o `BuildInfoFileKey` solicitado.

Retorna
`File`	o arquivo de imagem ou `null` se não for encontrado

getFiles

public  getFiles ()

Retorna todos os VersionedFiles armazenados neste BuildInfo.

Retorna

getProperties

public  getProperties ()

Retorna uma cópia das propriedades definidas no IBuildInfo.

Retorna

getRemoteFiles

public  getRemoteFiles ()

Receba os caminhos para artefatos de build que são de download atrasado.

Retorna

getTestTag

public String getTestTag ()

Retorna um nome exclusivo para os testes em execução.

Retorna
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar uma versão de arquivo com um BuildInfoFileKey fornecido.

Parâmetros
`key`	`BuildInfoKey.BuildInfoFileKey`: o `BuildInfoFileKey` solicitado.

Retorna
`String`	a versão da imagem ou `null` se não for encontrada

getVersion

public String getVersion (String name)

Método auxiliar para recuperar uma versão de arquivo com o nome fornecido.

Retorna
`String`	a versão da imagem ou `null` se não for encontrada

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para extrair um VersionedFile com um BuildInfoFileKey específico.

Parâmetros
`key`	`BuildInfoKey.BuildInfoFileKey`: o `BuildInfoFileKey` solicitado.

Retorna
`VersionedFile`	O arquivo com versão ou `null`, se não encontrado

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Método auxiliar para extrair um VersionedFile com um nome específico.

Retorna
`VersionedFile`	O arquivo com versão ou `null`, se não encontrado

getVersionedFileKeys

public  getVersionedFileKeys ()

Retorna o conjunto de chaves disponível para consultar VersionedFile usando getFile(BuildInfoFileKey).

Retorna

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar uma lista de VersionedFiles associadas a uma determinada BuildInfoFileKey. Se a chave permite armazenar uma lista.

Parâmetros
`key`	`BuildInfoKey.BuildInfoFileKey`: o `BuildInfoFileKey` solicitado.

Retorna
	O arquivo com versão ou `null`, se não encontrado

hashCode

public int hashCode ()

Retorna
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Remove um determinado attributeName do rastreamento.

Parâmetros
`attributeName`	`String`: o atributo a ser interrompido

setBuildBranch

public void setBuildBranch (String branch)

Definir a ramificação do build

Parâmetros
`branch`	`String`: o nome da ramificação

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Defina o sabor do build.

setBuildId

public void setBuildId (String buildId)

Define o identificador exclusivo do build em teste. Nunca pode ser nulo.

Parâmetros
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

Defina o número de série ITestDevice associado a este build.

Parâmetros
`serial`	`String`: o número de série do `ITestDevice` com que o build foi executado.

setFile

public void setFile (String name, 
                File file, 
                String version)

Armazena um arquivo com o nome fornecido nessas informações de build.

Parâmetros
`name`	`String`: o nome exclusivo do arquivo
`file`	`File`: o `ERROR(/File)` local
`version`	`String`: a versão do arquivo

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

Armazena um arquivo com um BuildInfoFileKey nessas informações de build.

Parâmetros
`key`	`BuildInfoKey.BuildInfoFileKey`: o nome exclusivo do arquivo baseado em `BuildInfoFileKey`.
`file`	`File`: o `ERROR(/File)` local
`version`	`String`: a versão do arquivo

setProperties

public void setProperties (BuildInfoProperties... properties)

Defina o BuildInfoProperties para a instância IBuildInfo. Substitua todas as propriedades definidas anteriormente.

Parâmetros
`properties`	`BuildInfoProperties`: a lista de propriedades a serem adicionadas.

setTestTag

public void setTestTag (String testTag)

Define o nome exclusivo dos testes que estão sendo executados.

Parâmetros
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Colocar um arquivo que faz parte de arquivos remotos no diretório raiz das informações de build em estágio.

Tarefa a fazer(b/138416078): remova essa interface e o chamador dela quando os módulos exigidos por um teste puderem ser criados corretamente no diretório do próprio módulo de teste.

Parâmetros
`fileName`	`String`: nome do arquivo que será localizado em arquivos remotos.
`workingDir`	`File`: um objeto `ERROR(/File)` do diretório para preparar o arquivo.

Retorna
`File`	o objeto `ERROR(/File)` do arquivo preparado no workingDir local.

toProto

public BuildInformation.BuildInfo toProto ()

Serializa a instância do BuildInfo em um protobuf.

Retorna
`BuildInformation.BuildInfo`

toString

public String toString ()

Retorna
`String`

Métodos protegidos

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Método auxiliar para copiar atributos, branches e sabores de build de outro build.

Parâmetros
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

Método auxiliar para copiar todos os arquivos do outro build.

Cria novos links físicos aos arquivos para que cada build tenha um caminho exclusivo para o arquivo.

Parâmetros
`build`	`BuildInfo`

Gera
	se uma exceção for gerada ao criar o link físico.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Permite aplicar algumas das IBuildInfo.BuildInfoProperties e possivelmente fazer um processamento diferente.

Parâmetros
`origFileConsidered`	`VersionedFile`: o `VersionedFile` que está sendo visualizado no momento.
`build`	`IBuildInfo`: o build original que está sendo clonado
`receiver`	`IBuildInfo`: o build que recebe as informações.

Retorna
`boolean`	Verdadeiro se as propriedades foram aplicadas e o processamento adicional precisa ser ignorado. Falso em outros casos.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Retorna
`MultiMap<String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Retorna

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Retorna
`MultiMap<String, VersionedFile>`