Esta página se ha traducido con Cloud Translation API.

Información de compilación

public class BuildInfo
extends Object implements IBuildInfo

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

Subclases directas conocidas

AppBuildInfo , DeviceBuildInfo , FolderBuildInfo , OtatoolsBuildInfo

Información de compilación de aplicaciones	Un `IBuildInfo` que representa una aplicación de Android y sus paquetes de prueba.
Información de construcción del dispositivo	Un `IBuildInfo` que representa una compilación completa de un dispositivo Android y (opcionalmente) sus pruebas.
CarpetaBuildInfo	Implementación concreta de un `IFolderBuildInfo` .
OtatoolsBuildInfo	Un `IBuildInfo` que contiene artefactos de otatools.

Subclases indirectas conocidas

AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo

AppDeviceBuildInfo	Esta clase está en desuso. Utilice `IDeviceBuildInfo` directamente.
Información de construcción de clúster	Una clase `IBuildInfo` para compilaciones canalizadas desde TFC.
DispositivoCarpetaBuildInfo	Un `IDeviceBuildInfo` que también contiene otros artefactos de compilación contenidos en un directorio en el sistema de archivos local.
OtaDeviceBuildInfo	Un `IDeviceBuildInfo` utilizado 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 una `BuildInfo` utilizando valores de atributos predeterminados.
`BuildInfo (String buildId, String buildTargetName)` Crea una `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)` Agregue un atributo de compilación.
`void`	`addBuildAttributes ( buildAttributes)` `addBuildAttributes ( buildAttributes)` Agregar atributos de compilación
`void`	`allowStagingRemoteFile (boolean stageRemoteFile)` Establece el permiso para permitir la preparación de archivos remotos.
`void`	`cleanUp ()` Limpiar cualquier archivo de compilación temporal
`void`	`cleanUp ( doNotClean)` `cleanUp ( doNotClean)` Versión de `cleanUp()` donde algunos archivos no se eliminan.
`IBuildInfo`	`clone ()`
`final void`	`copyAllFileFrom ( BuildInfo build)` Copie todo el `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 aplicación local y sus versiones.
	`getBuildAttributes ()` Obtenga un conjunto de pares nombre-valor de atributos adicionales que describen la compilación.
`String`	`getBuildBranch ()` Método opcional para devolver la rama de control de código fuente desde la que se produjo la compilación que se está probando.
`String`	`getBuildFlavor ()` Método opcional para devolver el tipo de compilación que se está probando.
`String`	`getBuildId ()` Devuelve el identificador único de la compilación bajo prueba.
`String`	`getBuildTargetName ()` Devuelve el nombre completo de la compilación que se está probando.
`String`	`getDeviceSerial ()`
`File`	`getFile (String name)` Método auxiliar para recuperar un archivo con el nombre de pila.
`File`	`getFile ( BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar un archivo con una `BuildInfoFileKey` dada.
	`getFiles ()` Devuelve todos `VersionedFile` almacenados en este `BuildInfo` .
	`getProperties ()` Devuelve una copia de las propiedades actualmente configuradas en `IBuildInfo` .
	`getRemoteFiles ()` Obtenga las rutas de los artefactos de compilación cuya descarga se retrasó.
`String`	`getTestTag ()` Devuelve un nombre único para las pruebas que se ejecutan.
`String`	`getVersion ( BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar una versión de archivo con una `BuildInfoFileKey` dada.
`String`	`getVersion (String name)` Método auxiliar para recuperar una versión de archivo con el nombre de pila.
`VersionedFile`	`getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar un `VersionedFile` con una `BuildInfoFileKey` determinada.
`final VersionedFile`	`getVersionedFile (String name)` Método auxiliar para recuperar un `VersionedFile` con un nombre determinado.
	`getVersionedFileKeys ()` Devuelve el conjunto de claves disponibles para consultar `VersionedFile` mediante `getFile(BuildInfoFileKey)` .
`final`	`getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)` Método auxiliar para recuperar una lista de `VersionedFile` asociados con un `BuildInfoFileKey` determinado.
`int`	`hashCode ()`
`void`	`removeBuildAttribute (String attributeName)` Eliminar un nombre de atributo determinado del seguimiento.
`void`	`setBuildBranch (String branch)` Establecer la rama de compilación
`void`	`setBuildFlavor (String buildFlavor)` Establece el tipo de construcción.
`void`	`setBuildId (String buildId)` Establece el identificador único de la compilación bajo prueba.
`void`	`setDeviceSerial (String serial)` Configure 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 de pila en esta información de compilación.
`void`	`setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)` Almacena un archivo con una `BuildInfoFileKey` en esta información de compilación.
`void`	`setProperties ( BuildInfoProperties... properties)` Establezca `BuildInfoProperties` para la instancia `IBuildInfo` .
`void`	`setTestTag (String testTag)` Establece el nombre exclusivo de las pruebas que se ejecutan.
`File`	`stageRemoteFile (String fileName, File workingDir)` Prepare un archivo que forme parte de archivos remotos en el directorio raíz de la información de compilación.
`BuildInformation.BuildInfo`	`toProto ()` Serializar una instancia de BuildInfo en un protobuf.
`String`	`toString ()`

Métodos protegidos
`void`	`addAllBuildAttributes ( BuildInfo build)` Método auxiliar para copiar atributos, ramas y tipos de compilación 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)` Permitir aplicar algunas de las `IBuildInfo.BuildInfoProperties` y posiblemente realizar un manejo diferente.
`MultiMap <String, String>`	`getAttributesMultiMap ()`
	`getVersionedFileMap ()`
`MultiMap <String, VersionedFile >`	`getVersionedFileMapFull ()`

Constructores públicos

Información de compilación

public BuildInfo ()

Crea una BuildInfo utilizando valores de atributos predeterminados.

Información de compilación

public BuildInfo (String buildId, 
                String buildTargetName)

Crea una BuildInfo

Parámetros
`buildId`	`String` : la identificación de compilación
`buildTargetName`	`String` : el nombre del objetivo de compilación

Métodos públicos

agregarAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Agrega el archivo apk local y su versión asociada. Tenga en cuenta que las aplicaciones se devolverán desde getAppPackageFiles() en el orden en que fueron agregadas por este método.

Parámetros
`appPackageFile`	`File`
`version`	`String`

agregarBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

agregar atributos de compilación

public void addBuildAttributes ( buildAttributes)

Agregar atributos de compilación

Parámetros
`buildAttributes`	: Mapa de atributos a agregar

permitirStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

Parámetros
`stageRemoteFile`	`boolean`

limpiar

public void cleanUp ()

Limpiar cualquier archivo de compilación temporal

limpiar

public void cleanUp ( doNotClean)

Versión de cleanUp() donde algunos archivos no se eliminan.

Parámetros
`doNotClean`

clon

public IBuildInfo clone ()

Devoluciones
`IBuildInfo`

copiar todo el archivo desde

public final void copyAllFileFrom (BuildInfo build)

Copie todo el VersionedFile de una compilación determinada a esta.

Parámetros
`build`	`BuildInfo`

es igual

public boolean equals (Object obj)

Parámetros
`obj`	`Object`

Devoluciones
`boolean`

DesdeProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

Parámetros
`protoBuild`	`BuildInformation.BuildInfo`

Devoluciones
`IBuildInfo`

obtenerAppPackageFiles

public  getAppPackageFiles ()

Obtiene una copia del conjunto de archivos apk de la aplicación local y sus versiones. El orden devuelto coincide con el orden en que se agregaron las aplicaciones a IAppBuildInfo .

Devoluciones

obtener atributos de compilación

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

Método opcional para devolver la rama de control de código fuente desde la que se produjo la compilación que se está probando.

Devoluciones
`String`	la rama de compilación o `null` si no está configurada/no aplicable

getBuildFlavor

public String getBuildFlavor ()

Método opcional para devolver el tipo de compilación que se está probando.

Una implementación común para las compilaciones de la plataforma Android es devolver (compilar producto)-(compilar sistema operativo)-(compilar variante). es decir, generic-linux-userdebug

Devoluciones
`String`	el tipo de compilación o `null` si no está configurado o no corresponde

obtener ID de compilación

public String getBuildId ()

Devuelve el identificador único de la compilación bajo prueba. Nunca debe ser nulo. El valor predeterminado es UNKNOWN_BUILD_ID .

Devoluciones
`String`

getBuildTargetName

public String getBuildTargetName ()

Devuelve 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 del tipo de compilación y el nombre de la rama. [es decir, (nombre de la sucursal)-(tipo de compilación)]

Devoluciones
`String`

getDeviceSerial

public String getDeviceSerial ()

Devoluciones
`String`

Obtener el archivo

public File getFile (String name)

Método auxiliar para recuperar un archivo con el nombre de pila.

Devoluciones
`File`	el archivo de imagen o `null` si no se encuentra

Obtener el archivo

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar un archivo con una BuildInfoFileKey dada.

Parámetros
`key`	`BuildInfoKey.BuildInfoFileKey` : la `BuildInfoFileKey` que se solicita.

Devoluciones
`File`	el archivo de imagen o `null` si no se encuentra

obtener archivos

public  getFiles ()

Devuelve todos VersionedFile almacenados en este BuildInfo .

Devoluciones

obtenerPropiedades

public  getProperties ()

Devuelve una copia de las propiedades actualmente configuradas en IBuildInfo .

Devoluciones

obtener archivos remotos

public  getRemoteFiles ()

Obtenga las rutas de los artefactos de compilación cuya descarga se retrasó.

Devoluciones

obtener etiqueta de prueba

public String getTestTag ()

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

Devoluciones
`String`

obtener versión

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar una versión de archivo con una BuildInfoFileKey dada.

Parámetros
`key`	`BuildInfoKey.BuildInfoFileKey` : la `BuildInfoFileKey` solicitada.

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

obtener versión

public String getVersion (String name)

Método auxiliar para recuperar una versión de archivo con el nombre de pila.

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

obtener archivo versionado

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar un VersionedFile con una BuildInfoFileKey determinada.

Parámetros
`key`	`BuildInfoKey.BuildInfoFileKey` : la `BuildInfoFileKey` solicitada.

Devoluciones
`VersionedFile`	El archivo versionado o `null` si no se encuentra

obtener archivo versionado

public final VersionedFile getVersionedFile (String name)

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

Devoluciones
`VersionedFile`	El archivo versionado o `null` si no se encuentra

obtener claves de archivo versionadas

public  getVersionedFileKeys ()

Devuelve el conjunto de claves disponibles para consultar VersionedFile mediante getFile(BuildInfoFileKey) .

Devoluciones

obtener archivos versionados

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Parámetros
`key`	`BuildInfoKey.BuildInfoFileKey` : la `BuildInfoFileKey` solicitada.

Devoluciones
	El archivo versionado o `null` si no se encuentra

código hash

public int hashCode ()

Devoluciones
`int`

eliminar BuildAttribute

public void removeBuildAttribute (String attributeName)

Eliminar un nombre de atributo determinado del seguimiento.

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

setBuildBranch

public void setBuildBranch (String branch)

Establecer la rama de compilación

Parámetros
`branch`	`String` : el nombre de la rama

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Establece el tipo de construcción.

establecerBuildId

public void setBuildId (String buildId)

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

Parámetros
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

establecer archivo

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

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

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

establecer archivo

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

Almacena un archivo con una 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)`
`version`	`String` : la versión del archivo

establecerPropiedades

public void setProperties (BuildInfoProperties... properties)

Establezca BuildInfoProperties para la instancia IBuildInfo . Anule cualquier propiedad existente establecida anteriormente.

Parámetros
`properties`	`BuildInfoProperties` : la lista de propiedades para agregar.

estableceretiquetadeprueba

public void setTestTag (String testTag)

Establece el nombre exclusivo de las pruebas que se ejecutan.

Parámetros
`testTag`	`String`

escenarioRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

TODO(b/138416078): elimine esta interfaz y su llamador cuando los módulos requeridos por una prueba se puedan generar correctamente en el directorio del módulo de prueba.

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

Devoluciones
`File`	el objeto `ERROR(/File)` del archivo preparado en el directorio de trabajo local.

aProto

public BuildInformation.BuildInfo toProto ()

Serializar una instancia de BuildInfo en un protobuf.

Devoluciones
`BuildInformation.BuildInfo`

Encadenar

public String toString ()

Devoluciones
`String`

Métodos protegidos

agregar todos los atributos de compilación

protected void addAllBuildAttributes (BuildInfo build)

Método auxiliar para copiar atributos, ramas y tipos de compilación de otra compilación.

Parámetros
`build`	`BuildInfo`

agregar todos los archivos

protected void addAllFiles (BuildInfo build)

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

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

Parámetros
`build`	`BuildInfo`

Lanza
	si se produce una excepción al crear el vínculo físico.

aplicarBuildProperties

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

Permitir aplicar algunas de las IBuildInfo.BuildInfoProperties y posiblemente realizar un manejo diferente.

Parámetros
`origFileConsidered`	`VersionedFile` : El `VersionedFile` actualmente examinado.
`build`	`IBuildInfo` : la compilación original se está clonando
`receiver`	`IBuildInfo` : la compilación que recibe la información.

Devoluciones
`boolean`	Es cierto si aplicamos las propiedades y se debe omitir el manejo posterior. Falso en caso contrario.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Devoluciones
`MultiMap <String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Devoluciones

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Devoluciones
`MultiMap <String, VersionedFile >`