Informações de criação

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


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