BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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


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 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 sua versão associada.

void addBuildAttribute (String attributeName, String attributeValue)

Adicione um atributo de compilaçã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 para toProto() para obter a instância de volta.

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 compilação.

String getBuildBranch ()

Método opcional para retornar a ramificação de controle de origem da qual a compilação que está sendo testada foi produzida.

String getBuildFlavor ()

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

String getBuildId ()

Retorna o identificador exclusivo da compilação em teste.

String getBuildTargetName ()

Retorna o nome completo da compilação que está sendo testada.

String getDeviceSerial ()

File getFile (String name)

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

File getFile ( BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar um arquivo com uma BuildInfoFileKey fornecida.

getFiles ()

Retorna todos VersionedFile s armazenados neste BuildInfo .

getProperties ()

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

getRemoteFiles ()

Obtenha os caminhos para os artefatos de construção cujo download está 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 o nome fornecido.

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 a ramificação de compilação

void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

void setBuildId (String buildId)

Define o identificador exclusivo da compilação 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 construção.

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

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

void setProperties ( BuildInfoProperties... properties)

Defina BuildInfoProperties para a instância IBuildInfo .

void setTestTag (String testTag)

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

File stageRemoteFile (String fileName, File workingDir)

Prepare um arquivo que faz 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 build, branch e variação de outro build.

void addAllFiles ( BuildInfo build)

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

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

Permite aplicar algumas das IBuildInfo.BuildInfoProperties e possivelmente fazer um tratamento 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 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 esse método.

Parâmetros
appPackageFile File

version String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Adicione um atributo de compilação. 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 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

copyAllFileFrom

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 para toProto() para obter a instância de volta.

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 compilaçã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 de origem da qual a compilação que está sendo testada foi produzida.

devoluções
String a ramificação de compilaçã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 (build product)-(build os)-(build variant). isto é, generic-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 da compilação em teste. Nunca deve ser nulo. O padrão é UNKNOWN_BUILD_ID .

devoluções
String

getBuildTargetName

public String getBuildTargetName ()

Retorna o nome completo da compilação que está sendo testada.

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

devoluções
String

getDeviceSerial

public String getDeviceSerial ()

devoluções
String

getFile

public File getFile (String name)

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

devoluções
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 uma BuildInfoFileKey fornecida.

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

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

getFiles

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 os artefatos de construção cujo download está atrasado.

devoluções

getTestTag

public String getTestTag ()

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

devoluções
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.

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

getVersion

public String getVersion (String name)

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

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 com versão 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 com versão 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 tecla permite armazenar uma lista.

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

devoluções
O arquivo com versão ou null se não for encontrado

hashCode

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 a ramificação de compilação

Parâmetros
branch String : o nome do ramo

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

setBuildId

public void setBuildId (String buildId)

Define o identificador exclusivo da compilação 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 construçã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 dado um 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)

Defina BuildInfoProperties para a instância IBuildInfo . Substitua quaisquer propriedades existentes definidas anteriormente.

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

setTestTag

public void setTestTag (String testTag)

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

Parâmetros
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Prepare um arquivo que faz 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 requeridos por um teste puderem ser construídos adequadamente para o diretório do próprio 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 no local workingDir.

toProto

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 build, branch e variação de outro build.

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

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

applyBuildProperties

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

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

Parâmetros
origFileConsidered VersionedFile : O atualmente examinado em VersionedFile .

build IBuildInfo : a compilação original sendo clonada

receiver IBuildInfo : a compilação que recebe as informações.

devoluções
boolean Verdadeiro se aplicamos as propriedades e a manipulação adicional deve ser ignorada. Falso caso contrário.

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 >