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 (String buildId, String buildTargetName) Crea una |
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 |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Copie todo el |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Operación inversa a |
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 |
getFiles () Devuelve todos | |
getProperties () Devuelve una copia de las propiedades establecidas actualmente en | |
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 |
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 |
final VersionedFile | getVersionedFile (String name) Método auxiliar para recuperar un |
getVersionedFileKeys () Devuelve el conjunto de claves disponibles para consultar | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar una lista de |
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 |
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 |
void | setProperties ( BuildInfoProperties... properties) Establezca |
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 |
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 |
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 |
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
publicgetAppPackageFiles ()
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
publicgetBuildAttributes ()
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-userdebugDevoluciones | |
---|---|
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
publicgetFiles ()
Devuelve todos VersionedFile
almacenados en este BuildInfo
.
Devoluciones | |
---|---|
obtener propiedades
publicgetProperties ()
Devuelve una copia de las propiedades establecidas actualmente en IBuildInfo
.
Devoluciones | |
---|---|
obtener archivos remotos
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Devuelve el conjunto de claves disponibles para consultar VersionedFile
a través de getFile(BuildInfoFileKey)
.
Devoluciones | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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
protectedgetVersionedFileMap ()
Devoluciones | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Devoluciones | |
---|---|
MultiMap <String, VersionedFile > |