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

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Adicionar atributos de compilação

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

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildTargetName ()

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

abstract String getDeviceSerial ()
abstract File getFile (String name)

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

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

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

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

abstract void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

abstract void setBuildId (String buildId)

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

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

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

abstract void setProperties ( BuildInfoProperties... properties)

Defina BuildInfoProperties para a instância IBuildInfo .

abstract void setTestTag (String testTag)

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

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

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 de compilação é 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 esse método.

Parâmetros
appPackageFile File

version String

addBuildAttribute

public abstract 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 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 compilaçã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 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 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 (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 abstract 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 abstract 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 compilaçã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.

getFile

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

devoluções

getTestTag

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

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

Parâmetros
branch String : o nome do ramo

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Defina o tipo de construção.

setBuildId

public abstract void setBuildId (String buildId)

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