Informações de construção

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 seus pacotes de teste. Informações de construção do dispositivo Um IBuildInfo que representa uma compilação completa de um dispositivo Android e (opcionalmente) seus testes. PastaBuildInfo Implementação concreta de um IFolderBuildInfo . OtatoolsBuildInfo Um IBuildInfo que contém artefatos otatools.

Subclasses indiretas conhecidas AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo Esta classe está obsoleta. Use IDeviceBuildInfo diretamente. ClusterBuildInfo Uma classe IBuildInfo para compilações canalizadas do TFC. DeviceFolderBuildInfo Um IDeviceBuildInfo que também contém outros artefatos de compilação 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 um IBuildInfo que deve ser associado a um ITestDevice .

Resumo

Construtores públicos
BuildInfo () Cria um BuildInfo usando valores de atributos 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 sua versão associada.
void	addBuildAttribute (String attributeName, String attributeValue) Adicione um atributo de construção.
void	addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Adicionar atributos de compilação
void	cleanUp () Limpe todos os arquivos de compilação temporários
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Versão de cleanUp() onde alguns arquivos não são excluídos.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Copie todo o VersionedFile de uma determinada compilação para esta.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Operação inversa a toProto() para recuperar a instância.
	getAppPackageFiles () Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões.
	getBuildAttributes () Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a construção.
String	getBuildBranch () Método opcional para retornar a ramificação de controle do código-fonte a partir da qual o build que está sendo 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 () Retorne o nome completo do build que está sendo testado.
String	getDeviceSerial ()
File	getFile (String name) Método auxiliar para recuperar um arquivo com determinado nome.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um arquivo com um BuildInfoFileKey fornecido.
	getFiles () Retorna todos VersionedFile s armazenados neste BuildInfo .
	getProperties () Retorna uma cópia das propriedades atualmente definidas no IBuildInfo .
	getRemoteFiles () Obtenha os caminhos para artefatos de construção com download atrasado.
String	getTestTag () Retorne um nome exclusivo para os testes que estão sendo executados.
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 determinado nome.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um VersionedFile com um determinado BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) Método auxiliar para recuperar um VersionedFile com um determinado nome.
	getVersionedFileKeys () Retorna o conjunto de chaves disponíveis para consultar VersionedFile via getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar uma lista de VersionedFile s associados a um determinado BuildInfoFileKey .
int	hashCode ()
void	removeBuildAttribute (String attributeName) Remova um determinado attributeName do rastreamento.
void	setBuildBranch (String branch) Defina o branch de construção
void	setBuildFlavor (String buildFlavor) Defina o tipo de construção.
void	setBuildId (String buildId) Define o identificador exclusivo do build em teste.
void	setDeviceSerial (String serial) Defina o serial ITestDevice associado a esta compilação.
void	setFile (String name, File file, String version) Armazena um arquivo com o nome fornecido nesta informação de compilação.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Armazena um arquivo com BuildInfoFileKey nesta informação de compilação.
void	setProperties ( BuildInfoProperties... properties) Configure 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) Prepare um arquivo que faça parte de arquivos remotos no diretório raiz das informações de compilação.
BuildInformation.BuildInfo	toProto () Serialize uma instância BuildInfo em um protobuf.
String	toString ()

Métodos protegidos
void	addAllBuildAttributes ( BuildInfo build) Método auxiliar para copiar atributos de compilação, ramificação e variação de outra compilação.
void	addAllFiles ( BuildInfo build) Método auxiliar para copiar todos os arquivos da outra compilação.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Permitir aplicar alguns dos IBuildInfo.BuildInfoProperties e possivelmente fazer um tratamento diferente.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

Construtores públicos

Informações de construção

public BuildInfo ()

Cria um BuildInfo usando valores de atributos padrão.

Informações de construção

public BuildInfo (String buildId, 
                String buildTargetName)

Cria um BuildInfo

Parâmetros
buildId	String : o ID da compilação
buildTargetName	String : o nome do destino de compilação

Métodos públicos

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Adiciona o arquivo apk local e sua versão associada. Observe que os apks serão retornados de getAppPackageFiles() na ordem em que foram adicionados por este método.

Parâmetros
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Adicione um atributo de construção. Isso não permite substituir um atributo existente.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Adicionar atributos de compilação

Parâmetros
buildAttributes	: Mapa de atributos a serem adicionados

limpar

public void cleanUp ()

Limpe todos os arquivos de compilação temporários

limpar

public void cleanUp ( doNotClean)

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

Parâmetros
doNotClean

clone

public IBuildInfo clone ()

Devoluções
IBuildInfo

copiarAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copie todo o VersionedFile de uma determinada compilação para esta.

Parâmetros
build	BuildInfo

é igual a

public boolean equals (Object obj)

Parâmetros
obj	Object

Devoluções
boolean

deProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

Parâmetros
protoBuild	BuildInformation.BuildInfo

Devoluções
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões. A ordem retornada corresponde à ordem em que os apks foram adicionados ao IAppBuildInfo .

Devoluções

getBuildAttributes

public  getBuildAttributes ()

Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a construção.

Devoluções
	um ERROR(/Map) de atributos de construção. Não será null , mas pode estar vazio.

getBuildBranch

public String getBuildBranch ()

Método opcional para retornar a ramificação de controle do código-fonte a partir da qual o build que está sendo testado foi produzido.

Devoluções
String	o branch de construção 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 compilações da plataforma Android é retornar (construir produto)-(build os)-(build variante). ou seja, genérico-linux-userdebug

Devoluções
String	o tipo de compilação ou null se não definido/não aplicável

getBuildId

public String getBuildId ()

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

Devoluções
String

getBuildTargetName

public String getBuildTargetName ()

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

Uma implementação comum é construir o nome do destino de compilação a partir de uma combinação do tipo de compilação e do nome da ramificação. [ou seja, (nome da filial) - (sabor de construção)]

Devoluções
String

getDeviceSerial

public String getDeviceSerial ()

Devoluções
String

obter arquivo

public File getFile (String name)

Método auxiliar para recuperar um arquivo com determinado nome.

Devoluções
File	o arquivo de imagem ou null se não for encontrado

obter arquivo

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.

Devoluções
File	o arquivo de imagem ou null se não for encontrado

getArquivos

public  getFiles ()

Retorna todos VersionedFile s armazenados neste BuildInfo .

Devoluções

obterPropriedades

public  getProperties ()

Retorna uma cópia das propriedades atualmente definidas no IBuildInfo .

Devoluções

getRemoteFiles

public  getRemoteFiles ()

Obtenha os caminhos para artefatos de construção com download atrasado.

Devoluções

getTestTag

public String getTestTag ()

Retorne um nome exclusivo para os testes que estão sendo executados.

Devoluções
String

getVersão

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.

Devoluções
String	a versão da imagem ou null se não for encontrado

getVersão

public String getVersion (String name)

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

Devoluções
String	a versão da imagem ou null se não for encontrado

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar um VersionedFile com um determinado BuildInfoFileKey .

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

Devoluções
VersionedFile	O arquivo versionado ou null se não for encontrado

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Método auxiliar para recuperar um VersionedFile com um determinado nome.

Devoluções
VersionedFile	O arquivo versionado ou null se não for encontrado

getVersionedFileKeys

public  getVersionedFileKeys ()

Retorna o conjunto de chaves disponíveis para consultar VersionedFile via getFile(BuildInfoFileKey) .

Devoluções

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar uma lista de VersionedFile s associados a um determinado BuildInfoFileKey . Se a chave permitir armazenar uma lista.

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

Devoluções
	O arquivo versionado ou null se não for encontrado

código hash

public int hashCode ()

Devoluções
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Remova um determinado attributeName do rastreamento.

Parâmetros
attributeName	String : o atributo para interromper o rastreamento

setBuildBranch

public void setBuildBranch (String branch)

Defina o branch de construção

Parâmetros
branch	String : o nome da filial

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

setBuildId

public void setBuildId (String buildId)

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

Parâmetros
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Defina o serial ITestDevice associado a esta compilação.

Parâmetros
serial	String : o número de série do ITestDevice com o qual esta compilação foi executada.

setArquivo

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

Armazena um arquivo com o nome fornecido nesta informação de compilação.

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

setArquivo

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

Armazena um arquivo com BuildInfoFileKey nesta informação de compilação.

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

definirPropriedades

public void setProperties (BuildInfoProperties... properties)

Configure BuildInfoProperties para a instância IBuildInfo . Substitua quaisquer propriedades existentes definidas antes.

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

definirTestTag

public void setTestTag (String testTag)

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

Parâmetros
testTag	String

estágioRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Prepare um arquivo que faça parte de arquivos remotos no diretório raiz das informações de compilação.

TODO(b/138416078): Remova esta interface e seu chamador quando os módulos exigidos por um teste puderem ser construídos corretamente como saída para o próprio diretório do módulo de teste.

Parâmetros
fileName	String : Nome do arquivo a ser localizado nos arquivos remotos.
workingDir	File : um objeto ERROR(/File) do diretório para preparar o arquivo.

Devoluções
File	o objeto ERROR(/File) do arquivo preparado em workingDir local.

paraProto

public BuildInformation.BuildInfo toProto ()

Serialize uma instância BuildInfo em um protobuf.

Devoluções
BuildInformation.BuildInfo

para sequenciar

public String toString ()

Devoluções
String

Métodos protegidos

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Método auxiliar para copiar atributos de compilação, ramificação e variação de outra compilação.

Parâmetros
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Método auxiliar para copiar todos os arquivos da outra compilação.

Cria novos hardlinks para os arquivos para que cada compilação tenha um caminho de arquivo exclusivo para o arquivo.

Parâmetros
build	BuildInfo

Lança
	se uma exceção for lançada ao criar o hardlink.

aplicarBuildProperties

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

Permitir aplicar alguns dos IBuildInfo.BuildInfoProperties e possivelmente fazer um tratamento diferente.

Parâmetros
origFileConsidered	VersionedFile : O VersionedFile atualmente visualizado.
build	IBuildInfo : a compilação original sendo clonada
receiver	IBuildInfo : o build que recebe as informações.

Devoluções
boolean	Verdadeiro se aplicamos as propriedades e o manuseio adicional deve ser ignorado. Caso contrário, falso.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Devoluções
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Devoluções

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Devoluções
MultiMap <String, VersionedFile >