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