Información de compilación

public class BuildInfo
extends Object implements IBuildInfo

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

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

Resumen

Constructores públicos

BuildInfo()

Crea un BuildInfo con los 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 pruebas de archivos remotos.

void cleanUp()

Cómo borrar 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 de 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()

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.

String getBuildFlavor()

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

String getBuildId()

Muestra el identificador único de la compilación que se está probando.

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

getFiles()

Muestra todos los VersionedFile almacenados en este BuildInfo.

getProperties()

Muestra una copia de las propiedades establecidas actualmente en IBuildInfo.

getRemoteFiles()

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

String getTestTag()

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

String getVersion(BuildInfoKey.BuildInfoFileKey key)

Método de ayuda para recuperar una versión de archivo con un BuildInfoFileKey determinado.

String getVersion(String name)

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

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile(String name)

Es un 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)

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

int hashCode()

void removeBuildAttribute(String attributeName)

Quita un attributeName específico del seguimiento.

void setBuildBranch(String branch)

Cómo configurar la rama de compilación

void setBuildFlavor(String buildFlavor)

Configura la variante de compilación.

void setBuildId(String buildId)

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

void setDeviceSerial(String serial)

Configura el número de serie ITestDevice asociado a esta compilación.

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

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

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

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

void setProperties(BuildInfoProperties... properties)

Configura 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)

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

BuildInformation.BuildInfo toProto()

Serializa una instancia BuildInfo en un protobuf.

String toString()

Métodos protegidos

void addAllBuildAttributes(BuildInfo build)

Método de ayuda para copiar atributos de compilación, ramas y variantes de otra compilación.

void addAllFiles(BuildInfo build)

Es un método de ayuda para copiar todos los archivos de la otra compilación.

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

Permitir la aplicación de algunos de los IBuildInfo.BuildInfoProperties y quizás un manejo diferente.

MultiMap<String, String> getAttributesMultiMap()
getVersionedFileMap()
MultiMap<String, VersionedFile> getVersionedFileMapFull()

Constructores públicos

Información de compilación

public BuildInfo ()

Crea un BuildInfo con los valores de atributos predeterminados.

Información de compilación

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo.

Parámetros
buildId String: Es el ID de compilación.
buildTargetName String: Es 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 devolverán getAppPackageFiles() en el orden en que los agregó 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 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 void cleanUp ()

Cómo borrar archivos de compilación temporales

Limpieza

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

copiarTodosArchivoDe

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

de Proto

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 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  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 ()

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 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 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 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 String getDeviceSerial ()

Muestra
String

getFile

public 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  getFiles ()

Muestra todos los VersionedFile almacenados en este BuildInfo.

Muestra

getProperties

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

hashCode

public int hashCode ()

Muestra
int

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 void setBuildBranch (String branch)

Cómo configurar la rama de compilación

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Configura la variante de compilación.

setBuildId

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

toString

public String toString ()

Muestra
String

Métodos protegidos

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Método de ayuda para copiar atributos de compilación, ramas y variantes de otra compilación.

Parámetros
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Es un método de ayuda 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 produce una excepción cuando se crea el vínculo duro.

applyBuildProperties

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

Permitir la aplicación de algunos de los IBuildInfo.BuildInfoProperties y quizás un manejo diferente.

Parámetros
origFileConsidered VersionedFile: Es el valor actual de VersionedFile.
build IBuildInfo: Es 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. Falso de lo contrario.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Muestra
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Muestra

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Muestra
MultiMap<String, VersionedFile>