IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Contiene información sobre la compilación bajo prueba.

Resumen

Constantes

String REMOTE_FILE_PREFIX

Prefijo utilizado en el nombre para indicar que la descarga del archivo está programada para retrasarse.

String REMOTE_FILE_VERSION

El archivo remoto no tiene versión.

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

default void allowStagingRemoteFile (boolean stageRemoteFile)

Establece el permiso para permitir la preparación de archivos remotos.

abstract void cleanUp ()

Limpiar 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 nombre-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 desde la que 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 de pila.

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

default getRemoteFiles ()

Obtenga las rutas de los artefactos de compilación cuya descarga se retrasó.

abstract String getTestTag ()

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

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 de pila.

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 mediante getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

Eliminar un nombre de atributo determinado del seguimiento.

abstract void setBuildBranch (String branch)

Establecer la rama de compilación

abstract void setBuildFlavor (String buildFlavor)

Establece el tipo de construcción.

abstract void setBuildId (String buildId)

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

abstract void setDeviceSerial (String serial)

Configure 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 de pila 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 forme parte de archivos remotos en el directorio raíz de la información de compilación.

default BuildInformation.BuildInfo toProto ()

Serializar 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 la descarga del archivo está programada para retrasarse.

Valor constante: "archivo_remoto:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

El archivo remoto no tiene versión.

Valor constante: ""

DESCONOCIDO_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

agregarBuildAttribute

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

Limpiar 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

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

Devoluciones
String el número de serie ITestDevice en el 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 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 abstract  getFiles ()

Devuelve todos VersionedFile almacenados en este BuildInfo .

Devoluciones

obtenerPropiedades

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

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

Establecer la rama de compilación

Parámetros
branch String : el nombre de la rama

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Establece el tipo de construcción.

establecerBuildId

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)

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

estableceretiquetadeprueba

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