BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Subclases directas conocidas AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo AppBuildInfo Un IBuildInfo que representa una aplicación para Android y sus paquetes de prueba.  DeviceBuildInfo Un IBuildInfo que representa una compilación completa del dispositivo Android y, de manera opcional, sus pruebas.  FolderBuildInfo Implementación concreta de un IFolderBuildInfo.  OtatoolsBuildInfo Un IBuildInfo que contiene artefactos de otatools.

Subcategorías indirectas conocidas AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo AppDeviceBuildInfo Esta clase dejó de estar disponible. Usa IDeviceBuildInfo directamente.  ClusterBuildInfo Una clase IBuildInfo para compilaciones que se canalizan desde TFC.  DeviceFolderBuildInfo Un IDeviceBuildInfo que también contiene otros artefactos de compilación en un directorio del sistema de archivos local.  OtaDeviceBuildInfo Un IDeviceBuildInfo que se usa para pruebas de actualización inalámbrica.

---

Implementación genérica de un IBuildInfo que debe asociarse con un ITestDevice.

Resumen

Constructores públicos
BuildInfo() Crea un BuildInfo con valores de atributos predeterminados.
BuildInfo(String buildId, String buildTargetName) Crea un BuildInfo.

Métodos públicos
void	addAppPackageFile(File appPackageFile, String version) Agrega el archivo apk local y su versión asociada.
void	addBuildAttribute(String attributeName, String attributeValue) Agrega un atributo de compilación.
void	addBuildAttributes( buildAttributes) Cómo agregar atributos de compilación
void	allowStagingRemoteFile(boolean stageRemoteFile) Establece el permiso para permitir la etapa de preparación de archivos remotos.
void	cleanUp() Limpia los archivos de compilación temporales.
void	cleanUp( doNotClean) Versión de cleanUp() en la que no se borran algunos archivos.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Copia todos los VersionedFile de una compilación determinada a esta.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Operación inversa a toProto() para recuperar la instancia.
	getAppPackageFiles() Obtiene una copia del conjunto de archivos APK de la app local y sus versiones.
	getBuildAttributes() Obtén un conjunto de pares nombre-valor de atributos adicionales que describen la compilación.
String	getBuildBranch() Es un método opcional para mostrar la rama del control de código fuente de la que se produjo la compilación que se está probando.
String	getBuildFlavor() Es un método opcional para mostrar el tipo de compilación que se está probando.
String	getBuildId() Muestra el identificador único de la compilación en prueba.
String	getBuildTargetName() Muestra el nombre completo de la compilación que se está probando.
String	getDeviceSerial()
File	getFile(String name) Es un método auxiliar para recuperar un archivo con un nombre determinado.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Es un método auxiliar para recuperar un archivo con un BuildInfoFileKey determinado.
	getFiles() Muestra todos los VersionedFile almacenados en este BuildInfo.
	getProperties() Devuelve una copia de las propiedades configuradas actualmente en IBuildInfo.
	getRemoteFiles() Obtén las rutas de acceso de los artefactos de compilación cuya descarga se retrasa.
String	getTestTag() Muestra un nombre único para las pruebas que se ejecutan.
String	getVersion(BuildInfoKey.BuildInfoFileKey key) Es un método auxiliar para recuperar una versión de archivo con un BuildInfoFileKey determinado.
String	getVersion(String name) Método auxiliar para recuperar una versión de archivo con un nombre determinado.
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar un VersionedFile con un BuildInfoFileKey determinado.
final VersionedFile	getVersionedFile(String name) Método de ayuda para recuperar un VersionedFile con un nombre determinado.
	getVersionedFileKeys() Muestra el conjunto de claves disponibles para consultar VersionedFile a través de getFile(BuildInfoFileKey).
final	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Método de ayuda para recuperar una lista de VersionedFile asociadas con un BuildInfoFileKey determinado.
int	hashCode()
void	removeBuildAttribute(String attributeName) Quita un atributo de seguimiento determinado.
void	setBuildBranch(String branch) Cómo configurar la rama de compilación
void	setBuildFlavor(String buildFlavor) Establece el tipo de compilación.
void	setBuildId(String buildId) Establece el identificador único de la compilación en prueba.
void	setDeviceSerial(String serial) Establece el número de serie ITestDevice asociado con esta compilación.
void	setFile(String name, File file, String version) Almacena un archivo con el nombre determinado en esta información de compilación.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Almacena un archivo con un BuildInfoFileKey en esta información de compilación.
void	setProperties(BuildInfoProperties... properties) Establece el BuildInfoProperties para la instancia IBuildInfo.
void	setTestTag(String testTag) Establece el nombre único de las pruebas que se ejecutan.
File	stageRemoteFile(String fileName, File workingDir) Prepara un archivo que forme parte de los archivos remotos en el directorio raíz de la información de compilación.
BuildInformation.BuildInfo	toProto() Serializa la instancia de BuildInfo en un protobuf.
String	toString()

Métodos protegidos
void	addAllBuildAttributes(BuildInfo build) Es un método auxiliar para copiar atributos de compilación, rama y variante de otra compilación.
void	addAllFiles(BuildInfo build) Método auxiliar para copiar todos los archivos de la otra compilación.
boolean	applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Permite aplicar algunos de los IBuildInfo.BuildInfoProperties y, posiblemente, realizar un control diferente.
MultiMap<String, String>	getAttributesMultiMap()
	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

Constructores públicos

BuildInfo

public BuildInfo ()

Crea un BuildInfo con valores de atributos predeterminados.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo.

Parámetros
buildId	String: El ID de compilación
buildTargetName	String: El nombre del destino de compilación

Métodos públicos

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Agrega el archivo apk local y su versión asociada. Ten en cuenta que los APKs se mostrarán desde getAppPackageFiles() en el orden en que se agregaron con este método.

Parámetros
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Agrega un atributo de compilación. Esto no permite anular un atributo de nombre existente.

Parámetros
attributeName	String: Es el nombre único del atributo.
attributeValue	String: Es el valor del atributo.

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Cómo agregar atributos de compilación

Parámetros
buildAttributes	: Es el mapa de los atributos que se agregarán.

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Establece el permiso para permitir la etapa de preparación de archivos remotos.

Parámetros
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

Limpia los archivos de compilación temporales.

cleanUp

public void cleanUp ( doNotClean)

Versión de cleanUp() en la que no se borran algunos archivos.

Parámetros
doNotClean

clonar

public IBuildInfo clone ()

Muestra
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia todos los VersionedFile de una compilación determinada a esta.

Parámetros
build	BuildInfo

equals

public boolean equals (Object obj)

Parámetros
obj	Object

Muestra
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operación inversa a toProto() para recuperar la instancia.

Parámetros
protoBuild	BuildInformation.BuildInfo

Muestra
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Obtiene una copia del conjunto de archivos APK de la app local y sus versiones. El orden que se muestra coincide con el orden en que se agregaron los apks a IAppBuildInfo.

Muestra

getBuildAttributes

public  getBuildAttributes ()

Obtén un conjunto de pares nombre-valor de atributos adicionales que describen la compilación.

Muestra
	un ERROR(/Map) de atributos de compilación. No será null, pero puede estar vacío.

getBuildBranch

public String getBuildBranch ()

Es un método opcional para mostrar la rama del control de código fuente de la que se produjo la compilación que se está probando.

Muestra
String	la rama de compilación o null si no se establece o no corresponde

getBuildFlavor

public String getBuildFlavor ()

Es un método opcional para mostrar el tipo de compilación que se está probando.

Una implementación común para las compilaciones de la plataforma de Android es mostrar (producto de compilación)-(SO de compilación)-(variante de compilación). ie generic-linux-userdebug

Muestra
String	El tipo de compilación o null si no se establece o no es aplicable

getBuildId

public String getBuildId ()

Muestra el identificador único de la compilación en prueba. Nunca debe ser nulo. La configuración predeterminada es UNKNOWN_BUILD_ID.

Muestra
String

getBuildTargetName

public String getBuildTargetName ()

Muestra el nombre completo de la compilación que se está probando.

Una implementación común es construir el nombre del destino de compilación a partir de una combinación de la variante de compilación y el nombre de la rama. [es decir, (nombre de la rama)-(sabor de compilación)]

Muestra
String

getDeviceSerial

public String getDeviceSerial ()

Muestra
String

getFile

public File getFile (String name)

Es un método auxiliar para recuperar un archivo con un nombre determinado.

Muestra
File	el archivo de imagen o null si no se encuentra

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Es un método auxiliar para recuperar un archivo con un BuildInfoFileKey determinado.

Parámetros
key	BuildInfoKey.BuildInfoFileKey: Es el BuildInfoFileKey que se solicita.

Muestra
File	el archivo de imagen o null si no se encuentra

getFiles

public  getFiles ()

Muestra todos los VersionedFile almacenados en este BuildInfo.

Muestra

getProperties

public  getProperties ()

Devuelve una copia de las propiedades configuradas actualmente en IBuildInfo.

Muestra

getRemoteFiles

public  getRemoteFiles ()

Obtén las rutas de acceso de los artefactos de compilación cuya descarga se retrasa.

Muestra

getTestTag

public String getTestTag ()

Muestra un nombre único para las pruebas que se ejecutan.

Muestra
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Es un método auxiliar para recuperar una versión de archivo con un BuildInfoFileKey determinado.

Parámetros
key	BuildInfoKey.BuildInfoFileKey: El BuildInfoFileKey solicitado.

Muestra
String	la versión de la imagen o null si no se encuentra

getVersion

public String getVersion (String name)

Método auxiliar para recuperar una versión de archivo con un nombre determinado.

Muestra
String	la versión de la imagen o null si no se encuentra

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar un VersionedFile con un BuildInfoFileKey determinado.

Parámetros
key	BuildInfoKey.BuildInfoFileKey: El BuildInfoFileKey solicitado.

Muestra
VersionedFile	El archivo con control de versiones o null si no se encuentra

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Método de ayuda para recuperar un VersionedFile con un nombre determinado.

Muestra
VersionedFile	El archivo con control de versiones o null si no se encuentra

getVersionedFileKeys

public  getVersionedFileKeys ()

Muestra el conjunto de claves disponibles para consultar VersionedFile a través de getFile(BuildInfoFileKey).

Muestra

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Método de ayuda para recuperar una lista de VersionedFile asociadas con un BuildInfoFileKey determinado. Si la clave permite almacenar una lista.

Parámetros
key	BuildInfoKey.BuildInfoFileKey: El BuildInfoFileKey solicitado.

Muestra
	El archivo con control de versiones o null si no se encuentra

hashCode

public int hashCode ()

Muestra
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Quita un atributo de seguimiento determinado.

Parámetros
attributeName	String: Es el atributo para el que se detendrá el seguimiento.

setBuildBranch

public void setBuildBranch (String branch)

Cómo configurar la rama de compilación

Parámetros
branch	String: El nombre de la rama

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Establece el tipo de compilación.

setBuildId

public void setBuildId (String buildId)

Establece el identificador único de la compilación en prueba. Nunca debe ser nulo.

Parámetros
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Establece el número de serie ITestDevice asociado con esta compilación.

Parámetros
serial	String: Es el número de serie del ITestDevice con el que se ejecutó esta compilación.

setFile

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

Almacena un archivo con el nombre determinado en esta información de compilación.

Parámetros
name	String: El nombre único del archivo
file	File: El ERROR(/File) local
version	String: Es la versión del archivo.

setFile

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

Almacena un archivo con un BuildInfoFileKey en esta información de compilación.

Parámetros
key	BuildInfoKey.BuildInfoFileKey: El nombre único del archivo basado en BuildInfoFileKey.
file	File: El ERROR(/File) local
version	String: Es la versión del archivo.

setProperties

public void setProperties (BuildInfoProperties... properties)

Establece el BuildInfoProperties para la instancia IBuildInfo. Anula las propiedades existentes que se hayan configurado antes.

Parámetros
properties	BuildInfoProperties: Es la lista de propiedades que se agregarán.

setTestTag

public void setTestTag (String testTag)

Establece el nombre único de las pruebas que se ejecutan.

Parámetros
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Prepara un archivo que forme parte de los archivos remotos en el directorio raíz de la información de compilación.

TODO(b/138416078): Quita esta interfaz y su llamador cuando los módulos que requiere una prueba se puedan compilar correctamente en el directorio del módulo de prueba.

Parámetros
fileName	String: Es el nombre del archivo que se ubicará en los archivos remotos.
workingDir	File: Es un objeto ERROR(/File) del directorio para preparar el archivo.

Muestra
File	el objeto ERROR(/File) del archivo preparado en workingDir local

toProto

public BuildInformation.BuildInfo toProto ()

Serializa la instancia de BuildInfo en un protobuf.

Muestra
BuildInformation.BuildInfo

toString

public String toString ()

Muestra
String

Métodos protegidos

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Es un método auxiliar para copiar atributos de compilación, rama y variante de otra compilación.

Parámetros
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Método auxiliar para copiar todos los archivos de la otra compilación.

Crea nuevos vínculos duros a los archivos para que cada compilación tenga una ruta de acceso única al archivo.

Parámetros
build	BuildInfo

Arroja
	si se arroja una excepción cuando se crea el vínculo duro.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Permite aplicar algunos de los IBuildInfo.BuildInfoProperties y, posiblemente, realizar un control diferente.

Parámetros
origFileConsidered	VersionedFile: El VersionedFile que se está viendo actualmente.
build	IBuildInfo: La compilación original que se clona
receiver	IBuildInfo: Es la compilación que recibe la información.

Muestra
boolean	Es verdadero si aplicamos las propiedades y se debe omitir el manejo adicional. De lo contrario, es falso.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Muestra
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Muestra

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Muestra
MultiMap<String, VersionedFile>