IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Contiene información sobre la compilación que se está probando.

Resumen

constantes

String REMOTE_FILE_PREFIX

Prefijo utilizado en el nombre para indicar que el archivo está configurado para una descarga retrasada.

String REMOTE_FILE_VERSION

El archivo remoto no está versionado.

String UNKNOWN_BUILD_ID

Valor predeterminado cuando se desconoce el ID de compilación.

Métodos públicos

default void addAppPackageFile (File appPackageFile, String version)

Agrega el archivo apk local y su versión asociada.

abstract void addBuildAttribute (String attributeName, String attributeValue)

Agregue un atributo de compilación.

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Agregar atributos de compilación

abstract void cleanUp ()

Limpie cualquier archivo de compilación temporal

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Clona el objeto IBuildInfo .

default getAppPackageFiles ()

Obtiene una copia del conjunto de archivos apk de la aplicación local y sus versiones.

abstract getBuildAttributes ()

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

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildTargetName ()

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

abstract String getDeviceSerial ()
abstract File getFile (String name)

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

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

abstract getFiles ()

Devuelve todos VersionedFile almacenados en este BuildInfo .

abstract getProperties ()

Devuelve una copia de las propiedades establecidas actualmente en IBuildInfo .

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion (String name)

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

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

Quitar un nombre de atributo dado del seguimiento.

abstract void setBuildBranch (String branch)

Establecer la rama de compilación

abstract void setBuildFlavor (String buildFlavor)

Establezca el sabor de construcción.

abstract void setBuildId (String buildId)

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

abstract void setDeviceSerial (String serial)

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

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

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

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

Almacena un archivo con una BuildInfoFileKey en esta información de compilación.

abstract void setProperties ( BuildInfoProperties... properties)

Establezca BuildInfoProperties para la instancia IBuildInfo .

abstract void setTestTag (String testTag)

Establece el nombre exclusivo de las pruebas que se ejecutan.

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

default BuildInformation.BuildInfo toProto ()

Serialice una instancia de BuildInfo en un protobuf.

constantes

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Prefijo utilizado en el nombre para indicar que el archivo está configurado para una descarga retrasada.

Valor constante: "archivo_remoto:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

El archivo remoto no está versionado.

Valor constante: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Valor predeterminado cuando se desconoce el ID de compilación.

Valor constante: "-1"

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

Limpie cualquier archivo de compilación temporal

limpiar

public abstract void cleanUp ( doNotDelete)

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

Parámetros
doNotDelete

clon

public abstract IBuildInfo clone ()

Clona el objeto IBuildInfo .

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

Devoluciones
String la serie ITestDevice en la que se ejecutó esta compilación. Devuelve null si no hay ningún dispositivo asociado con esta compilación.

Obtener el archivo

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

Devuelve todos VersionedFile almacenados en este BuildInfo .

Devoluciones

obtener propiedades

public abstract  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 abstract 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 abstract 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 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  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

Establecer la rama de compilación

Parámetros
branch String : el nombre de la rama

establecerConstruirSabor

public abstract void setBuildFlavor (String buildFlavor)

Establezca el sabor de construcción.

setBuildId

public abstract void setBuildId (String buildId)

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

Parámetros
buildId String

setDeviceSerial

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