Información de compilación

public class BuildInfo
extends Object implements IBuildInfo

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


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

Limpie 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 de nombre y valor de atributos adicionales que describen la compilación.

String getBuildBranch ()

Método opcional para devolver la rama de control de código fuente a partir de la cual 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 dado.

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 establecidas actualmente en IBuildInfo .

getRemoteFiles ()

Obtenga las rutas para los artefactos de compilación que se retrasan en la descarga.

String getTestTag ()

Devuelve un nombre único para las pruebas que se están ejecutando.

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 dado.

VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile (String name)

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

getVersionedFileKeys ()

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

final getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar una lista de VersionedFile asociados con una BuildInfoFileKey determinada.

int hashCode ()

void removeBuildAttribute (String attributeName)

Quitar un nombre de atributo dado del seguimiento.

void setBuildBranch (String branch)

Establecer la rama de compilación

void setBuildFlavor (String buildFlavor)

Establezca el sabor de construcción.

void setBuildId (String buildId)

Establece el identificador único de la compilación bajo prueba.

void setDeviceSerial (String serial)

Establezca 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 dado 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 sea parte de los archivos remotos en el directorio raíz de la información de compilación.

BuildInformation.BuildInfo toProto ()

Serialice una instancia de BuildInfo en un protobuf.

String toString ()

Métodos protegidos

void addAllBuildAttributes ( BuildInfo build)

Método auxiliar para copiar atributos de compilación, rama y tipo 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

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

Parámetros
attributeName String : el nombre de atributo único

attributeValue String : el valor del atributo

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Agregar atributos de compilación

Parámetros
buildAttributes : Mapa de atributos a agregar

limpiar

public void cleanUp ()

Limpie 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

copiarTodoArchivoDesde

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

Ubicación:Proto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

Parámetros
protoBuild BuildInformation.BuildInfo

Devoluciones
IBuildInfo

getAppPackageFiles

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

getBuildAttributes

public  getBuildAttributes ()

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

Devoluciones
un ERROR(/Map) de 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 a partir de la cual se produjo la compilación que se está probando.

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

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 (producto de compilación)-(sistema operativo de compilación)-(variante de compilación). es decir, generic-linux-userdebug

Devoluciones
String el tipo de compilación o null si no se establece/no corresponde

getBuildId

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 de destino de la 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)-(sabor 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 dado.

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

obtener propiedades

public  getProperties ()

Devuelve una copia de las propiedades establecidas actualmente en IBuildInfo .

Devoluciones

obtener archivos remotos

public  getRemoteFiles ()

Obtenga las rutas para los artefactos de compilación que se retrasan en la descarga.

Devoluciones

obtener etiqueta de prueba

public String getTestTag ()

Devuelve un nombre único para las pruebas que se están ejecutando.

Devoluciones
String

getVersion

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

getVersion

public String getVersion (String name)

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

Devoluciones
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 una BuildInfoFileKey determinada.

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

Devoluciones
VersionedFile El archivo versionado o null si no se encuentra

getVersionedFile

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

getVersionedFileKeys

public  getVersionedFileKeys ()

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

Devoluciones

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Método auxiliar para recuperar una lista de VersionedFile asociados con una BuildInfoFileKey dada. Si la tecla 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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Quitar un nombre de atributo dado 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

establecerConstruirSabor

public void setBuildFlavor (String buildFlavor)

Establezca el sabor de construcción.

setBuildId

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)

Establezca 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 dado 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

establecer propiedades

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.

establecer etiqueta de prueba

public void setTestTag (String testTag)

Establece el nombre exclusivo de las pruebas que se ejecutan.

Parámetros
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Prepare un archivo que sea parte de los 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 puedan generarse correctamente como salida al directorio del módulo de prueba.

Parámetros
fileName String : Nombre del archivo a ubicar en archivos remotos.

workingDir File : un objeto ERROR(/File) del directorio para preparar el archivo.

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

aProto

public BuildInformation.BuildInfo toProto ()

Serialice una instancia de BuildInfo en un protobuf.

Devoluciones
BuildInformation.BuildInfo

Encadenar

public String toString ()

Devoluciones
String

Métodos protegidos

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Método auxiliar para copiar atributos de compilación, rama y tipo de otra compilación.

Parámetros
build BuildInfo

agregarTodosLosArchivos

protected void addAllFiles (BuildInfo build)

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

Crea nuevos enlaces fijos a los archivos para que cada compilación tenga una ruta de archivo única al archivo.

Parámetros
build BuildInfo

Lanza
si se lanza una excepción al crear el enlace fijo.

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 que se está clonando

receiver IBuildInfo : la compilación que recibe la información.

Devoluciones
boolean Verdadero 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 >