Informações de criação

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Subclasses indiretas conhecidas AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo e BuildInfoBuildInfo, BuildInfoBuildInfo, BuildInfoBuildInfo, BuildInfoBuildInfot} AppBuildInfo (em inglês) Um IBuildInfo que representa um aplicativo Android e os pacotes de teste dele.  AppDeviceBuildInfo (em inglês) Esta classe foi descontinuada. Use IDeviceBuildInfo diretamente.  BuildInfo (em inglês) Implementação genérica de um IBuildInfo que precisa ser associado. com um ITestDevice.  ClusterBuildInfo (em inglês) Uma classe IBuildInfo para builds enviados a partir do TFC.  DeviceBuildInfo (em inglês) Uma IBuildInfo que representa o build completo de um dispositivo Android e, opcionalmente, os testes dele.  DeviceFolderBuildInfo (em inglês) Um IDeviceBuildInfo que também contém outros artefatos de build contidos em um diretório no no sistema de arquivos local.  FolderBuildInfo (em inglês) Implementação concreta de um IFolderBuildInfo.  IAppBuildInfo (em inglês) Esta interface foi descontinuada. Use IBuildInfo diretamente.  IDeviceBuildInfo (em inglês) Uma IBuildInfo que representa o build completo de um dispositivo Android e, opcionalmente, os testes dele.  IFolderBuildInfo (em inglês) Um IBuildInfo abstrato simples com artefatos de versão que contêm em um sistema de arquivos local diretório.  OtaDeviceBuildInfo (em inglês) Um IDeviceBuildInfo usado para testes de atualização over the air (OTA).  OtatoolsBuildInfo (em inglês) Um IBuildInfo que contém artefatos otatools.

---

Mantém informações sobre o build em teste.

Resumo

Constantes
String	REMOTE_FILE_PREFIX Prefixo usado no nome para indicar que o arquivo está definido para atrasar o download.
String	REMOTE_FILE_VERSION O arquivo remoto não tem controle de versão.
String	UNKNOWN_BUILD_ID Valor padrão quando o ID do build é desconhecido.

Métodos públicos
default void	addAppPackageFile(File appPackageFile, String version) Adiciona o arquivo apk local e a versão associada.
abstract void	addBuildAttribute(String attributeName, String attributeValue) Adicionar um atributo de build.
default void	addBuildAttributes( buildAttributes) Adicionar atributos de build
default void	allowStagingRemoteFile(boolean stageRemoteFile) Define a permissão para autorizar a preparação de arquivos remotos.
abstract void	cleanUp() Limpe todos os arquivos de build temporários
abstract void	cleanUp( doNotDelete) Versão de cleanUp() em que alguns arquivos não são excluídos.
abstract IBuildInfo	clone() Clona o objeto IBuildInfo.
default	getAppPackageFiles() Recebe uma cópia do conjunto de arquivos apk de apps locais e as versões deles.
abstract	getBuildAttributes() Receba um conjunto de pares de nome-valor de atributos adicionais que descrevem o build.
abstract 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.
abstract String	getBuildFlavor() Método opcional para retornar o tipo de build que está sendo testado.
abstract String	getBuildId() Retorna o identificador exclusivo da versão em teste.
abstract String	getBuildTargetName() Retorna o nome completo do build que está sendo testado.
abstract String	getDeviceSerial()
abstract File	getFile(String name) Método auxiliar para recuperar um arquivo com o nome determinado.
default File	getFile(BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um arquivo com um BuildInfoFileKey.
abstract	getFiles() Retorna todos os VersionedFiles armazenados nesse BuildInfo.
abstract	getProperties() Retorna uma cópia das propriedades atualmente definidas no IBuildInfo.
default	getRemoteFiles() Acessa os caminhos dos artefatos de build que estão com o download atrasado.
abstract String	getTestTag() Retorne um nome exclusivo para os testes que estão sendo executados.
default String	getVersion(BuildInfoKey.BuildInfoFileKey key) Método auxiliar para extrair uma versão de arquivo com um BuildInfoFileKey.
abstract String	getVersion(String name) Método auxiliar para recuperar uma versão de arquivo com o nome determinado.
default VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Método auxiliar para extrair um VersionedFile com um determinado BuildInfoFileKey.
default VersionedFile	getVersionedFile(String name) Método auxiliar para extrair um VersionedFile com um determinado nome.
default	getVersionedFileKeys() Retorna o conjunto de chaves disponíveis para consultar VersionedFile via getFile(BuildInfoFileKey).
default	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Método auxiliar para extrair uma lista de VersionedFiles associados a um determinado BuildInfoFileKey.
default void	removeBuildAttribute(String attributeName) Remove um determinado attributeName do acompanhamento.
abstract void	setBuildBranch(String branch) Definir a ramificação de build
abstract void	setBuildFlavor(String buildFlavor) Define a variação de build.
abstract void	setBuildId(String buildId) Define o identificador exclusivo da versão em teste.
abstract void	setDeviceSerial(String serial) Define o número de série ITestDevice associado a esse build.
abstract void	setFile(String name, File file, String version) Armazena um arquivo com determinado nome nas informações do build.
default void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Armazena um arquivo que recebe um BuildInfoFileKey nas informações do build.
abstract void	setProperties(BuildInfoProperties... properties) Defina o BuildInfoProperties para a instância IBuildInfo.
abstract void	setTestTag(String testTag) Define o nome exclusivo dos testes que estão sendo executados.
default 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.
default BuildInformation.BuildInfo	toProto() Serialize uma instância BuildInfo em um protobuf.

Constantes

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Prefixo usado no nome para indicar que o arquivo está definido para atrasar o download.

Valor constante: "arquivo_remoto:"

VERSÃO_DE_ARQUIVO_REMOTE

public static final String REMOTE_FILE_VERSION

O arquivo remoto não tem controle de versão.

Valor constante: ""

ID DO CRIADOR DESCONHECIDO

public static final String UNKNOWN_BUILD_ID

Valor padrão quando o ID do build é desconhecido.

Valor constante: “-1”

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 abstract 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 abstract void cleanUp ()

Limpe todos os arquivos de build temporários

limpeza

public abstract void cleanUp ( doNotDelete)

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

Parâmetros
doNotDelete

clonar

public abstract IBuildInfo clone ()

Clona o objeto IBuildInfo.

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 abstract  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 abstract 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 abstract 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 abstract 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 abstract 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 abstract String getDeviceSerial ()

Retorna
String	o número de série ITestDevice em que o build foi executado. Retornará null se nenhum dispositivo estiver associado a esse build.

getFile

public abstract 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 abstract  getFiles ()

Retorna todos os VersionedFiles armazenados nesse BuildInfo.

Retorna

getProperties

public abstract  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 abstract 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 abstract 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 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  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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Remove um determinado attributeName do acompanhamento.

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

setBuildBranch

public abstract void setBuildBranch (String branch)

Definir a ramificação de build

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Define a variação de build.

setBuildId

public abstract void setBuildId (String buildId)

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

Parâmetros
buildId	String

setDeviceSerial

public abstract 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 abstract 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 abstract 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 abstract 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