Esta página foi traduzida pela API Cloud Translation.

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`	`allowStagingRemoteFile (boolean stageRemoteFile)` Define permissão para permitir a preparação de arquivos remotos.
`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

permitirStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

Parâmetros
`stageRemoteFile`	`boolean`

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 >`