A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Subclasses indiretas conhecidas

AppBuildInfo , AppDeviceBuildInfo , BuildInfo , ClusterBuildInfo , DeviceBuildInfo , DeviceFolderBuildInfo , FolderBuildInfo , IAppBuildInfo , IDeviceBuildInfo , IFolderBuildInfo , OtaDeviceBuildInfo , OtatoolsBuildInfo

AppBuildInfo	Um `IBuildInfo` que representa um aplicativo Android e seus pacotes de teste.
AppDeviceBuildInfo	Esta classe está obsoleta. Use `IDeviceBuildInfo` diretamente.
Informações de construção	Implementação genérica de um `IBuildInfo` que deve ser associado a um `ITestDevice` .
ClusterBuildInfo	Uma classe `IBuildInfo` para compilações canalizadas do TFC.
Informações de construção do dispositivo	Um `IBuildInfo` que representa uma compilação completa de um dispositivo Android e (opcionalmente) seus testes.
DeviceFolderBuildInfo	Um `IDeviceBuildInfo` que também contém outros artefatos de compilação contidos em um diretório no sistema de arquivos local.
PastaBuildInfo	Implementação concreta de um `IFolderBuildInfo` .
IAppBuildInfo	Esta interface está obsoleta. Use `IBuildInfo` diretamente.
IDeviceBuildInfo	Um `IBuildInfo` que representa uma compilação completa de um dispositivo Android e (opcionalmente) seus testes.
IFolderBuildInfo	Um `IBuildInfo` abstrato simples cujos artefatos de construção estão contidos em um diretório do sistema de arquivos local.
OtaDeviceBuildInfo	Um `IDeviceBuildInfo` usado para testes de atualização over-the-air.
OtatoolsBuildInfo	Um `IBuildInfo` que contém artefatos otatools.

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`