IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Contient des informations sur la version testée.

Résumé

Constantes

String REMOTE_FILE_PREFIX

Préfixe utilisé dans le nom pour indiquer que le fichier est configuré pour être téléchargé en différé.

String REMOTE_FILE_VERSION

Le fichier distant n'est pas versionné.

String UNKNOWN_BUILD_ID

Valeur par défaut lorsque l'ID de build est inconnu.

Méthodes publiques

default void addAppPackageFile (File appPackageFile, String version)

Ajoute le fichier apk local et sa version associée.

abstract void addBuildAttribute (String attributeName, String attributeValue)

Ajoutez un attribut de construction.

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Ajouter des attributs de construction

abstract void cleanUp ()

Nettoyez tous les fichiers de construction temporaires

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

Version de cleanUp() où certains fichiers ne sont pas supprimés.

abstract IBuildInfo clone ()

Clone l'objet IBuildInfo .

default getAppPackageFiles ()

Obtient une copie de l'ensemble des fichiers apk de l'application locale et de leurs versions.

abstract getBuildAttributes ()

Obtenez un ensemble de paires nom-valeur d'attributs supplémentaires décrivant la génération.

abstract String getBuildBranch ()

Méthode facultative pour retourner la branche de contrôle de code source à partir de laquelle la build testée a été produite.

abstract String getBuildFlavor ()

Méthode facultative pour renvoyer le type de build testé.

abstract String getBuildId ()

Renvoie l'identifiant unique de la construction testée.

abstract String getBuildTargetName ()

Renvoie le nom complet du build testé.

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

Méthode d'assistance pour récupérer un fichier avec un nom donné.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer un fichier avec un BuildInfoFileKey donné.

abstract getFiles ()

Renvoie tous VersionedFile stockés dans ce BuildInfo .

abstract getProperties ()

Retourne une copie des propriétés actuellement définies sur IBuildInfo .

default getRemoteFiles ()

Obtenez les chemins d'accès aux artefacts de build dont le téléchargement est retardé.

abstract String getTestTag ()

Renvoie un nom unique pour les tests en cours d'exécution.

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer une version de fichier avec un BuildInfoFileKey donné.

abstract String getVersion (String name)

Méthode d'assistance pour récupérer une version de fichier avec le nom donné.

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer un VersionedFile avec un BuildInfoFileKey donné.

default VersionedFile getVersionedFile (String name)

Méthode d'assistance pour récupérer un VersionedFile avec un nom donné.

default getVersionedFileKeys ()

Renvoie le jeu de clés disponibles pour interroger VersionedFile via getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer une liste de VersionedFile associés à un BuildInfoFileKey donné.

default void removeBuildAttribute (String attributeName)

Supprimer un nom d'attribut donné du suivi.

abstract void setBuildBranch (String branch)

Définir la branche de construction

abstract void setBuildFlavor (String buildFlavor)

Définissez la saveur de construction.

abstract void setBuildId (String buildId)

Définit l'identifiant unique de la construction sous test.

abstract void setDeviceSerial (String serial)

Définissez le numéro de série ITestDevice associé à cette version.

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

Stocke un fichier avec le nom donné dans cette information de construction.

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

Stocke un fichier auquel est attribué un BuildInfoFileKey dans cette information de build.

abstract void setProperties ( BuildInfoProperties... properties)

Définissez les BuildInfoProperties pour l'instance IBuildInfo .

abstract void setTestTag (String testTag)

Définit le nom unique des tests en cours d'exécution.

default File stageRemoteFile (String fileName, File workingDir)

Mettez en scène un fichier qui fait partie des fichiers distants dans le répertoire racine des informations de build.

default BuildInformation.BuildInfo toProto ()

Sérialisez une instance BuildInfo dans un protobuf.

Constantes

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Préfixe utilisé dans le nom pour indiquer que le fichier est configuré pour être téléchargé en différé.

Valeur constante : "fichier_distant :"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Le fichier distant n'est pas versionné.

Valeur constante : ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Valeur par défaut lorsque l'ID de build est inconnu.

Valeur constante : "-1"

Méthodes publiques

addAppPackageFileaddAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Ajoute le fichier apk local et sa version associée. Notez que les apks seront renvoyés par getAppPackageFiles() dans l'ordre dans lequel ils ont été ajoutés par cette méthode.

Paramètres
appPackageFile File

version String

addBuildAttributeaddBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Ajoutez un attribut de construction. Cela ne permet pas de remplacer un nom d'attribut existant.

Paramètres
attributeName String : le nom d'attribut unique

attributeValue String : la valeur de l'attribut

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Ajouter des attributs de construction

Paramètres
buildAttributes : Carte des attributs à ajouter

nettoyer

public abstract void cleanUp ()

Nettoyez tous les fichiers de construction temporaires

nettoyer

public abstract void cleanUp ( doNotDelete)

Version de cleanUp() où certains fichiers ne sont pas supprimés.

Paramètres
doNotDelete

cloner

public abstract IBuildInfo clone ()

Clone l'objet IBuildInfo .

Retour
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Obtient une copie de l'ensemble des fichiers apk de l'application locale et de leurs versions. L'ordre renvoyé correspond à l'ordre dans lequel les apks ont été ajoutés à IAppBuildInfo .

Retour

getBuildAttributes

public abstract  getBuildAttributes ()

Obtenez un ensemble de paires nom-valeur d'attributs supplémentaires décrivant la génération.

Retour
une ERROR(/Map) des attributs de construction. Ne sera pas null , mais peut être vide.

getBuildBranch

public abstract String getBuildBranch ()

Méthode facultative pour retourner la branche de contrôle de code source à partir de laquelle la build testée a été produite.

Retour
String la branche de construction ou null si non défini/non applicable

getBuildFlavor

public abstract String getBuildFlavor ()

Méthode facultative pour renvoyer le type de build testé.

Une implémentation courante pour les builds de la plate-forme Android consiste à renvoyer (build product)-(build os)-(build variant). c'est-à-dire générique-linux-userdebug

Retour
String la saveur de construction ou null si non défini/non applicable

getBuildId

public abstract String getBuildId ()

Renvoie l'identifiant unique de la construction testée. Ne doit jamais être nul. Par défaut, UNKNOWN_BUILD_ID .

Retour
String

getBuildTargetName

public abstract String getBuildTargetName ()

Renvoie le nom complet du build testé.

Une implémentation courante consiste à construire le nom de la cible de génération à partir d'une combinaison du type de génération et du nom de la branche. [c'est-à-dire (nom de la branche)-(saveur de construction)]

Retour
String

getDeviceSerial

public abstract String getDeviceSerial ()

Retour
String la série ITestDevice sur laquelle cette build a été exécutée. Renvoie null si aucun périphérique n'est associé à cette version.

obtenirFichier

public abstract File getFile (String name)

Méthode d'assistance pour récupérer un fichier avec un nom donné.

Retour
File le fichier image ou null si introuvable

obtenirFichier

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer un fichier avec un BuildInfoFileKey donné.

Paramètres
key BuildInfoKey.BuildInfoFileKey : le BuildInfoFileKey qui est demandé.

Retour
File le fichier image ou null si introuvable

obtenir des fichiers

public abstract  getFiles ()

Renvoie tous VersionedFile stockés dans ce BuildInfo .

Retour

getProperties

public abstract  getProperties ()

Retourne une copie des propriétés actuellement définies sur IBuildInfo .

Retour

getRemoteFiles

public  getRemoteFiles ()

Obtenez les chemins d'accès aux artefacts de build dont le téléchargement est retardé.

Retour

getTestTag

public abstract String getTestTag ()

Renvoie un nom unique pour les tests en cours d'exécution.

Retour
String

obtenirVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer une version de fichier avec un BuildInfoFileKey donné.

Paramètres
key BuildInfoKey.BuildInfoFileKey : Le BuildInfoFileKey demandé.

Retour
String la version de l'image ou null si introuvable

obtenirVersion

public abstract String getVersion (String name)

Méthode d'assistance pour récupérer une version de fichier avec le nom donné.

Retour
String la version de l'image ou null si introuvable

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer un VersionedFile avec un BuildInfoFileKey donné.

Paramètres
key BuildInfoKey.BuildInfoFileKey : Le BuildInfoFileKey demandé.

Retour
VersionedFile Le fichier versionné ou null s'il n'est pas trouvé

getVersionedFile

public VersionedFile getVersionedFile (String name)

Méthode d'assistance pour récupérer un VersionedFile avec un nom donné.

Retour
VersionedFile Le fichier versionné ou null s'il n'est pas trouvé

getVersionedFileKeys

public  getVersionedFileKeys ()

Renvoie le jeu de clés disponibles pour interroger VersionedFile via getFile(BuildInfoFileKey) .

Retour

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer une liste de VersionedFile associés à un BuildInfoFileKey donné. Si la touche permet de stocker une liste.

Paramètres
key BuildInfoKey.BuildInfoFileKey : Le BuildInfoFileKey demandé.

Retour
Le fichier versionné ou null s'il n'est pas trouvé

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Supprimer un nom d'attribut donné du suivi.

Paramètres
attributeName String : l'attribut pour arrêter le tracking

setBuildBranch

public abstract void setBuildBranch (String branch)

Définir la branche de construction

Paramètres
branch String : le nom de la branche

setBuildFlavorsetBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Définissez la saveur de construction.

setBuildId

public abstract void setBuildId (String buildId)

Définit l'identifiant unique de la construction sous test. Ne doit jamais être nul.

Paramètres
buildId String

setDeviceSerialsetDeviceSerial

public abstract void setDeviceSerial (String serial)

Définissez le numéro de série ITestDevice associé à cette version.

Paramètres
serial String : le numéro de série de l' ITestDevice avec lequel ce build a été exécuté.

setFile

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

Stocke un fichier avec le nom donné dans cette information de construction.

Paramètres
name String : le nom unique du fichier

file File : l' ERROR(/File)

version String : la version du fichier

setFile

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

Stocke un fichier auquel est attribué un BuildInfoFileKey dans cette information de build.

Paramètres
key BuildInfoKey.BuildInfoFileKey : le nom unique du fichier basé sur BuildInfoFileKey .

file File : l' ERROR(/File)

version String : la version du fichier

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

Définissez les BuildInfoProperties pour l'instance IBuildInfo . Remplacer toutes les propriétés existantes définies auparavant.

Paramètres
properties BuildInfoProperties : La liste des propriétés à ajouter.

setTestTag

public abstract void setTestTag (String testTag)

Définit le nom unique des tests en cours d'exécution.

Paramètres
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Mettez en scène un fichier qui fait partie des fichiers distants dans le répertoire racine des informations de build.

TODO(b/138416078) : Supprimez cette interface et son appelant lorsque les modules requis par un test peuvent être correctement générés dans le répertoire du module de test lui-même.

Paramètres
fileName String : Nom du fichier à localiser dans les fichiers distants.

workingDir File : un objet ERROR(/File) du répertoire où stocker le fichier.

Retour
File l'objet ERROR(/File) du fichier stocké dans workingDir local.

versProto

public BuildInformation.BuildInfo toProto ()

Sérialisez une instance BuildInfo dans un protobuf.

Retour
BuildInformation.BuildInfo