InformaciónDeCompilación

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Subcategorías indirectas conocidas AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo, IDeviceBuildInfoBuild, IDeviceBuildInfoBuild, IDeviceBuildInfoBuildDeviceFolderBuildInfo. AppBuildInfo. Un IBuildInfo que representa una aplicación para Android y sus paquetes de prueba.  AppDeviceBuildInfo. Esta clase dejó de estar disponible. Usa IDeviceBuildInfo directamente.  Información de compilación Implementación genérica de un IBuildInfo que debe asociarse con un ITestDevice.  ClusterBuildInfo. Una clase IBuildInfo para compilaciones canalizadas desde TFC.  DeviceBuildInfo. Un IBuildInfo que representa una compilación completa de dispositivo Android y sus pruebas (opcionalmente).  DeviceFolderBuildInfo. Un IDeviceBuildInfo que también contiene otros artefactos de compilación contenidos en un directorio en el sistema de archivos local.  FolderBuildInfo Implementación concreta de un IFolderBuildInfo.  IAppBuildInfo. Esta interfaz dejó de estar disponible. Usa IBuildInfo directamente.  IDeviceBuildInfo. Un IBuildInfo que representa una compilación completa de dispositivo Android y sus pruebas (opcionalmente).  IFolderBuildInfo. Un IBuildInfo abstracto simple cuyos artefactos de compilación se encuentran en un sistema de archivos local .  OtaDeviceBuildInfo. Es un IDeviceBuildInfo que se usa para pruebas de actualizaciones inalámbricas.  OtatoolsBuildInfo Un IBuildInfo que contiene artefactos otatools.

---

Contiene información sobre la compilación que se está probando.

Resumen

Constantes
String	REMOTE_FILE_PREFIX Es el prefijo que se usa en el nombre para indicar que el archivo está configurado para demorarse en la descarga.
String	REMOTE_FILE_VERSION El archivo remoto no tiene control de versiones.
String	UNKNOWN_BUILD_ID Valor predeterminado cuando se desconoce el ID de compilación.

Métodos públicos
default void	addAppPackageFile(File appPackageFile, String version) Agrega el archivo APK local y su versión asociada.
abstract void	addBuildAttribute(String attributeName, String attributeValue) Agrega un atributo de compilación.
default void	addBuildAttributes( buildAttributes) Cómo agregar atributos de compilación
default void	allowStagingRemoteFile(boolean stageRemoteFile) Establece el permiso para permitir la etapa de pruebas de archivos remotos.
abstract void	cleanUp() Cómo borrar archivos de compilación temporales
abstract void	cleanUp( doNotDelete) Versión de cleanUp() en la que no se borran algunos archivos.
abstract IBuildInfo	clone() Clona el objeto IBuildInfo.
default	getAppPackageFiles() Obtiene una copia del conjunto de archivos de APK de la app local y sus versiones.
abstract	getBuildAttributes() Obtén un conjunto de pares nombre-valor de atributos adicionales que describen la compilación.
abstract String	getBuildBranch() Método opcional para mostrar la rama de control de origen que se utilizó para la compilación que se está probando con el que se produce.
abstract String	getBuildFlavor() Método opcional para mostrar el tipo de compilación que se está probando.
abstract String	getBuildId() Muestra el identificador único de la compilación que se está probando.
abstract String	getBuildTargetName() Muestra el nombre completo de la compilación que se está probando.
abstract String	getDeviceSerial()
abstract File	getFile(String name) Es un método de ayuda para recuperar un archivo con un nombre determinado.
default File	getFile(BuildInfoKey.BuildInfoFileKey key) Es un método de ayuda para recuperar un archivo con un BuildInfoFileKey determinado.
abstract	getFiles() Muestra todos los VersionedFile almacenados en este BuildInfo.
abstract	getProperties() Muestra una copia de las propiedades establecidas actualmente en IBuildInfo.
default	getRemoteFiles() Obtén las rutas de acceso de los artefactos de compilación que tienen demoras en la descarga.
abstract String	getTestTag() Muestra un nombre único para las pruebas que se ejecutan.
default String	getVersion(BuildInfoKey.BuildInfoFileKey key) Método de ayuda para recuperar una versión de archivo con un BuildInfoFileKey determinado.
abstract String	getVersion(String name) Es un método de ayuda para recuperar una versión de archivo con un nombre determinado.
default VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Es un método de ayuda para recuperar un VersionedFile con un BuildInfoFileKey determinado.
default VersionedFile	getVersionedFile(String name) Es un método de ayuda para recuperar un VersionedFile con un nombre determinado.
default	getVersionedFileKeys() Muestra el conjunto de claves disponibles para consultar VersionedFile a través de getFile(BuildInfoFileKey).
default	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Es un método de ayuda para recuperar una lista de VersionedFile asociados con un BuildInfoFileKey determinado.
default void	removeBuildAttribute(String attributeName) Quita un attributeName específico del seguimiento.
abstract void	setBuildBranch(String branch) Cómo configurar la rama de compilación
abstract void	setBuildFlavor(String buildFlavor) Configura la variante de compilación.
abstract void	setBuildId(String buildId) Establece el identificador único de la compilación que se está probando.
abstract void	setDeviceSerial(String serial) Configura el número de serie ITestDevice asociado a esta compilación.
abstract void	setFile(String name, File file, String version) Almacena un archivo con un nombre dado en esta información de compilación.
default void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Almacena un archivo a partir de un BuildInfoFileKey en esta información de compilación.
abstract void	setProperties(BuildInfoProperties... properties) Configura el BuildInfoProperties para la instancia IBuildInfo.
abstract void	setTestTag(String testTag) Establece el nombre único de las pruebas que se ejecutan.
default File	stageRemoteFile(String fileName, File workingDir) Almacena en etapa intermedia un archivo que forma parte de archivos remotos en el directorio raíz de la información de compilación.
default BuildInformation.BuildInfo	toProto() Serializa una instancia BuildInfo en un protobuf.

Constantes

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Es el prefijo que se usa en el nombre para indicar que el archivo está configurado para demorarse en la descarga.

Valor constante: “remote_file:”

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

El archivo remoto no tiene control de versiones.

Valor constante: ”.

ID DE COMPILACIÓN UNKNOWN_

public static final String UNKNOWN_BUILD_ID

Valor predeterminado cuando se desconoce el ID de compilación.

Valor constante: “-1”

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 devolverán getAppPackageFiles() en el orden en que los agregó este método.

Parámetros
appPackageFile	File
version	String

addBuildAttribute.

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Cómo agregar atributos de compilación

Parámetros
buildAttributes	: Mapa de atributos que se agregarán

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Establece el permiso para permitir la etapa de pruebas de archivos remotos.

Parámetros
stageRemoteFile	boolean

Limpieza

public abstract void cleanUp ()

Cómo borrar archivos de compilación temporales

Limpieza

public abstract void cleanUp ( doNotDelete)

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

Parámetros
doNotDelete

clonar

public abstract IBuildInfo clone ()

Clona el objeto IBuildInfo.

Muestra
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

Muestra

getBuildAttributes.

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

Método opcional para mostrar la rama de control de origen que se utilizó para la compilación que se está probando con el que se produce.

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

getBuildFlavor.

public abstract String getBuildFlavor ()

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 (producto de compilación)-(SO de compilación)-(variante de compilación). p. ej., genérica-linux-userdebug

Muestra
String	la variante de compilación o null si no se establece o no es aplicable

getBuildId

public abstract String getBuildId ()

Muestra el identificador único de la compilación que se está probando. Nunca debe ser nulo. La configuración predeterminada es UNKNOWN_BUILD_ID.

Muestra
String

getBuildTargetName

public abstract 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 el tipo de compilación y el nombre de la rama. [p. ej. (nombre de rama)-(variante de compilación)]

Muestra
String

getDeviceSerial

public abstract String getDeviceSerial ()

Muestra
String	el número de serie ITestDevice en el que se ejecutó esta compilación. Muestra null si no hay ningún dispositivo asociado con esta compilación.

getFile

public abstract File getFile (String name)

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

Muestra
File	el archivo de imagen o null si no lo encuentras

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

Parámetros
key	BuildInfoKey.BuildInfoFileKey: El BuildInfoFileKey que se solicita.

Muestra
File	el archivo de imagen o null si no lo encuentras

getFiles

public abstract  getFiles ()

Muestra todos los VersionedFile almacenados en este BuildInfo.

Muestra

getProperties

public abstract  getProperties ()

Muestra una copia de las propiedades establecidas actualmente en IBuildInfo.

Muestra

getRemoteFiles;

public  getRemoteFiles ()

Obtén las rutas de acceso de los artefactos de compilación que tienen demoras en la descarga.

Muestra

getTestTag

public abstract String getTestTag ()

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

Muestra
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Método de ayuda 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 abstract String getVersion (String name)

Es un método de ayuda 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)

Es un método de ayuda para recuperar un VersionedFile con un BuildInfoFileKey determinado.

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

Muestra
VersionedFile	El archivo con la versión o null si no se encuentra

getVersionedFile

public VersionedFile getVersionedFile (String name)

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

Muestra
VersionedFile	El archivo con la versión 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  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Es un método de ayuda para recuperar una lista de VersionedFile asociados con un BuildInfoFileKey determinado. Si la clave permite almacenar una lista.

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

Muestra
	El archivo con la versión o null si no se encuentra

quitarBuildAttribute

public void removeBuildAttribute (String attributeName)

Quita un attributeName específico del seguimiento.

Parámetros
attributeName	String: Es el atributo para detener el seguimiento.

setBuildBranch

public abstract void setBuildBranch (String branch)

Cómo configurar la rama de compilación

Parámetros
branch	String: Es el nombre de la rama.

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Configura la variante de compilación.

setBuildId

public abstract void setBuildId (String buildId)

Establece el identificador único de la compilación que se está probando. Nunca debe ser nulo.

Parámetros
buildId	String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Configura el número de serie ITestDevice asociado a 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 abstract void setFile (String name, 
                File file, 
                String version)

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

Parámetros
name	String: Es el nombre único del archivo.
file	File: Es 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 a partir de un BuildInfoFileKey en esta información de compilación.

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

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

Configura el BuildInfoProperties para la instancia IBuildInfo. Anular cualquiera propiedades existentes que se establecieron antes.

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

setTestTag

public abstract void setTestTag (String testTag)

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

Parámetros
testTag	String

etapaRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Almacena en etapa intermedia un archivo que forma parte de archivos remotos en el directorio raíz de la información de compilación.

TODO(b/138416078): Quita esta interfaz y su emisor cuando una prueba requiera módulos se pueden compilar correctamente como salida 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 almacenar en etapa intermedia el archivo.

Muestra
File	el objeto ERROR(/File) del archivo almacenado en el trabajo local.

ToProto

public BuildInformation.BuildInfo toProto ()

Serializa una instancia BuildInfo en un protobuf.

Muestra
BuildInformation.BuildInfo