Informações do build

public class BuildInfo
extends Object implements IBuildInfo

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

Implementação genérica de um IBuildInfo que precisa ser associado. com 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 a versão associada a ele.

void addBuildAttribute(String attributeName, String attributeValue)

Adicionar um atributo de build.

void addBuildAttributes( buildAttributes)

Adicionar atributos de build

void allowStagingRemoteFile(boolean stageRemoteFile)

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

void cleanUp()

Limpe 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)

Copia 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 de apps locais e as 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 do controle de origem em que o build que está sendo testado que são produzidos.

String getBuildFlavor()

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

String getBuildId()

Retorna o identificador exclusivo da versão 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 determinado.

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

getFiles()

Retorna todos os VersionedFiles armazenados nesse BuildInfo.

getProperties()

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

getRemoteFiles()

Acessa os caminhos dos artefatos de build que estão com o 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 extrair uma versão de arquivo com um BuildInfoFileKey.

String getVersion(String name)

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

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile(String name)

Método auxiliar para extrair 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 extrair uma lista de VersionedFiles associados a um determinado BuildInfoFileKey.

int hashCode()

void removeBuildAttribute(String attributeName)

Remove um attributeName específico do acompanhamento.

void setBuildBranch(String branch)

Definir a ramificação de build

void setBuildFlavor(String buildFlavor)

Define a variação de build.

void setBuildId(String buildId)

Define o identificador exclusivo da versão em teste.

void setDeviceSerial(String serial)

Define o número de série ITestDevice associado a esse build.

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

Armazena um arquivo com determinado nome nas informações do build.

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

Armazena um arquivo que recebe um BuildInfoFileKey nas informações do 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)

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

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, ramificação 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)

Permitir a aplicação de IBuildInfo.BuildInfoProperties e talvez faça um tratamento diferente.

MultiMap<String, String> getAttributesMultiMap()
getVersionedFileMap()
MultiMap<String, VersionedFile> getVersionedFileMapFull()

Construtores públicos

Informações do build

public BuildInfo ()

Cria um BuildInfo usando valores de atributo padrão.

Informações do build

public BuildInfo (String buildId, 
                String buildTargetName)

Cria um BuildInfo.

Parâmetros
buildId String: o ID do build.
buildTargetName String: o nome do destino do 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)

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

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Adicionar atributos de build

Parâmetros
buildAttributes : mapa de atributos a serem adicionados

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

Parâmetros
stageRemoteFile boolean

limpeza

public void cleanUp ()

Limpe todos os arquivos de build temporários

limpeza

public void cleanUp ( doNotClean)

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

Parâmetros
doNotClean

clonar

public IBuildInfo clone ()

Retorna
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia 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 de apps locais e as versões deles. O pedido devolvido 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
uma ERROR(/Map) de atributos de build. Não será null, mas pode estar em branco.

getBuildBranch

public String getBuildBranch ()

Método opcional para retornar a ramificação do controle de origem em que o build que está sendo testado que são produzidos.

Retorna
String a ramificação do 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 (produto de build)-(SO de build)-(variante de build). ou seja general-linux-userdebug

Retorna
String a variação de build ou null, se não for definida/não aplicável.

getBuildId

public String getBuildId ()

Retorna o identificador exclusivo da versão em teste. Nunca deve 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 é construir o nome do destino do build a partir de uma combinação dos a variação de build e o nome da ramificação. [ou seja (nome da ramificação)-(variação do 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 determinado.

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.

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 nesse BuildInfo.

Retorna

getProperties

public  getProperties ()

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

Retorna

getRemoteFiles

public  getRemoteFiles ()

Acessa os caminhos dos artefatos de build que estão com o download atrasado.

Retorna

getTestTag

public String getTestTag ()

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

Retorna
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

Parâmetros
key BuildInfoKey.BuildInfoFileKey: o BuildInfoFileKey solicitado.
Retorna
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 determinado.

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

Parâmetros
key BuildInfoKey.BuildInfoFileKey: o BuildInfoFileKey solicitado.
Retorna
VersionedFile O arquivo com controle de versão ou null, se não for encontrado

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

Retorna
VersionedFile O arquivo com controle de 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).

Retorna

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para extrair uma lista de VersionedFiles associados a um determinado BuildInfoFileKey. Se a chave permite armazenar uma lista.

Parâmetros
key BuildInfoKey.BuildInfoFileKey: o BuildInfoFileKey solicitado.
Retorna
O arquivo com controle de versão ou null, se não for encontrado

hashCode

public int hashCode ()

Retorna
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Remove um determinado attributeName do acompanhamento.

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

setBuildBranch

public void setBuildBranch (String branch)

Definir a ramificação de build

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Define a variação de build.

setBuildId

public void setBuildId (String buildId)

Define o identificador exclusivo da versão em teste. Nunca deve ser nulo.

Parâmetros
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

Define o número de série ITestDevice associado a esse build.

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

setFile

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

Armazena um arquivo com determinado nome nas informações do 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 que recebe um BuildInfoFileKey nas informações do 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. Substituir qualquer 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 dos testes que estão sendo executados.

Parâmetros
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

TODO(b/138416078): remover esta interface e o autor da chamada quando os módulos forem exigidos por um teste pode ser corretamente compilado como saída para o diretório do módulo de teste.

Parâmetros
fileName String: nome do arquivo que será localizado nos arquivos remotos.
workingDir File: um objeto ERROR(/File) do diretório em que o arquivo será organizado.
Retorna
File o objeto ERROR(/File) do arquivo preparado no workDir local.

toProto

public BuildInformation.BuildInfo toProto ()

Serialize uma instância 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 de build, ramificação e variação de outro build.

Parâmetros
build BuildInfo

adicionarTodososArquivos

protected void addAllFiles (BuildInfo build)

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

Cria novos links físicos para os arquivos, de modo que cada compilação tenha um caminho de arquivo exclusivo para o .

Parâmetros
build BuildInfo

Gera
se uma exceção for lançada durante a criação do link físico.

applyBuildProperties

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

Permitir a aplicação de IBuildInfo.BuildInfoProperties e talvez faça um tratamento diferente.

Parâmetros
origFileConsidered VersionedFile: o momento analisado em VersionedFile.
build IBuildInfo: o build original que está sendo clonado.
receiver IBuildInfo: o build que recebe as informações.
Retorna
boolean "True", se aplicamos as propriedades e outros processamentos precisam ser ignorados. Falso caso contrário.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Retorna
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Retorna

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Retorna
MultiMap<String, VersionedFile>