IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Contém informações sobre a compilação em teste.

Resumo

Constantes

String REMOTE_FILE_PREFIX

Prefixo usado no nome para indicar que o arquivo está configurado para download atrasado.

String REMOTE_FILE_VERSION

O arquivo remoto não tem 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 sua versão associada.

abstract void addBuildAttribute (String attributeName, String attributeValue)

Adicione um atributo de construção.

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Adicionar atributos de compilação

default void allowStagingRemoteFile (boolean stageRemoteFile)

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

abstract void cleanUp ()

Limpe todos os arquivos de compilação temporários

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Clona o objeto IBuildInfo .

default getAppPackageFiles ()

Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões.

abstract getBuildAttributes ()

Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a construção.

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

Retorna o identificador exclusivo do build em teste.

abstract String getBuildTargetName ()

Retorne 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 determinado nome.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

abstract getFiles ()

Retorna todos VersionedFile s armazenados neste BuildInfo .

abstract getProperties ()

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

default getRemoteFiles ()

Obtenha os caminhos para artefatos de construção com 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 recuperar uma versão de arquivo com um BuildInfoFileKey fornecido.

abstract String getVersion (String name)

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

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile (String name)

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

default void removeBuildAttribute (String attributeName)

Remova um determinado attributeName do rastreamento.

abstract void setBuildBranch (String branch)

Defina o branch de construção

abstract void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

abstract void setBuildId (String buildId)

Define o identificador exclusivo do build em teste.

abstract void setDeviceSerial (String serial)

Defina o serial ITestDevice associado a esta compilação.

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

Armazena um arquivo com o nome fornecido nesta informação de compilação.

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

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

abstract void setProperties ( BuildInfoProperties... properties)

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

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á configurado para download atrasado.

Valor Constante: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

O arquivo remoto não tem versão.

Valor constante: ""

UNKNOWN_BUILD_ID

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

Limpe todos os arquivos de compilação temporários

limpar

public abstract void cleanUp ( doNotDelete)

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

Parâmetros
doNotDelete

clone

public abstract IBuildInfo clone ()

Clona o objeto IBuildInfo .

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

Devoluções
String o serial ITestDevice em que esta compilação foi executada. Retorna null se nenhum dispositivo estiver associado a esta compilação.

obter arquivo

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

Retorna todos VersionedFile s armazenados neste BuildInfo .

Devoluções

obterPropriedades

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Remova um determinado attributeName do rastreamento.

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

setBuildBranch

public abstract void setBuildBranch (String branch)

Defina o branch de construção

Parâmetros
branch String : o nome da filial

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

setBuildId

public abstract void setBuildId (String buildId)

Define o identificador exclusivo do build em teste. Nunca deve ser nulo.

Parâmetros
buildId String

setDeviceSerial

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