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 |
abstract IBuildInfo | clone () Clona el objeto |
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 |
abstract | getFiles () Devuelve todos |
abstract | getProperties () Devuelve una copia de las propiedades establecidas actualmente en |
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 |
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 |
default VersionedFile | getVersionedFile (String name) Método auxiliar para recuperar un |
default | getVersionedFileKeys () Devuelve el conjunto de claves disponibles para consultar |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar una lista de |
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 |
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 |
abstract void | setProperties ( BuildInfoProperties... properties) Establezca |
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 |
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 |
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
public abstractgetBuildAttributes ()
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-userdebugDevoluciones | |
---|---|
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 abstractgetFiles ()
Devuelve todos VersionedFile
almacenados en este BuildInfo
.
Devoluciones | |
---|---|
obtener propiedades
public abstractgetProperties ()
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 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
publicgetVersionedFileKeys ()
Devuelve el conjunto de claves disponibles para consultar VersionedFile
a través de getFile(BuildInfoFileKey)
.
Devoluciones | |
---|---|
getVersionedFiles
publicgetVersionedFiles (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 |