BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Sous-classes directes connues AppBuildInfo , DeviceBuildInfo , DossierBuildInfo , OtatoolsBuildInfo AppBuildInfo Un IBuildInfo qui représente une application Android et son ou ses packages de test. DeviceBuildInfo Un IBuildInfo qui représente une version complète d'un appareil Android et (éventuellement) ses tests. DossierBuildInfo Implémentation concrète d'un IFolderBuildInfo . OtatoolsBuildInfo Un IBuildInfo qui contient des artefacts otatools.

Sous-classes indirectes connues AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo Cette classe est obsolète. Utilisez IDeviceBuildInfo directement. ClusterBuildInfo Une classe IBuildInfo pour les builds canalisées à partir de TFC. DeviceFolderBuildInfo Un IDeviceBuildInfo qui contient également d'autres artefacts de génération contenus dans un répertoire sur le système de fichiers local. OtaDeviceBuildInfo Un IDeviceBuildInfo utilisé pour les tests de mise à jour en direct.

---

Implémentation générique d'un IBuildInfo qui doit être associé à un ITestDevice .

Résumé

Constructeurs publics
BuildInfo () Crée un BuildInfo à l'aide des valeurs d'attribut par défaut.
BuildInfo (String buildId, String buildTargetName) Crée un BuildInfo

Méthodes publiques
void	addAppPackageFile (File appPackageFile, String version) Ajoute le fichier apk local et sa version associée.
void	addBuildAttribute (String attributeName, String attributeValue) Ajoutez un attribut de construction.
void	addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Ajouter des attributs de construction
void	cleanUp () Nettoyez tous les fichiers de construction temporaires
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Version de cleanUp() où certains fichiers ne sont pas supprimés.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Copiez tous les VersionedFile d'un build donné vers celui-ci.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Opération inverse à toProto() pour récupérer l'instance.
	getAppPackageFiles () Obtient une copie de l'ensemble des fichiers apk de l'application locale et de leurs versions.
	getBuildAttributes () Obtenez un ensemble de paires nom-valeur d'attributs supplémentaires décrivant la génération.
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.
String	getBuildFlavor () Méthode facultative pour renvoyer le type de build testé.
String	getBuildId () Renvoie l'identifiant unique de la construction testée.
String	getBuildTargetName () Renvoie le nom complet du build testé.
String	getDeviceSerial ()
File	getFile (String name) Méthode d'assistance pour récupérer un fichier avec un nom donné.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer un fichier avec un BuildInfoFileKey donné.
	getFiles () Renvoie tous VersionedFile stockés dans ce BuildInfo .
	getProperties () Retourne une copie des propriétés actuellement définies sur IBuildInfo .
	getRemoteFiles () Obtenez les chemins d'accès aux artefacts de build dont le téléchargement est retardé.
String	getTestTag () Renvoie un nom unique pour les tests en cours d'exécution.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer une version de fichier avec un BuildInfoFileKey donné.
String	getVersion (String name) Méthode d'assistance pour récupérer une version de fichier avec le nom donné.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer un VersionedFile avec un BuildInfoFileKey donné.
final VersionedFile	getVersionedFile (String name) Méthode d'assistance pour récupérer un VersionedFile avec un nom donné.
	getVersionedFileKeys () Renvoie le jeu de clés disponibles pour interroger VersionedFile via getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer une liste de VersionedFile associés à un BuildInfoFileKey donné.
int	hashCode ()
void	removeBuildAttribute (String attributeName) Supprimer un nom d'attribut donné du suivi.
void	setBuildBranch (String branch) Définir la branche de construction
void	setBuildFlavor (String buildFlavor) Définissez la saveur de construction.
void	setBuildId (String buildId) Définit l'identifiant unique de la construction sous test.
void	setDeviceSerial (String serial) Définissez le numéro de série ITestDevice associé à cette version.
void	setFile (String name, File file, String version) Stocke un fichier avec le nom donné dans cette information de construction.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Stocke un fichier auquel est attribué un BuildInfoFileKey dans cette information de build.
void	setProperties ( BuildInfoProperties... properties) Définissez les BuildInfoProperties pour l'instance IBuildInfo .
void	setTestTag (String testTag) Définit le nom unique des tests en cours d'exécution.
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.
BuildInformation.BuildInfo	toProto () Sérialisez une instance BuildInfo dans un protobuf.
String	toString ()

Méthodes protégées
void	addAllBuildAttributes ( BuildInfo build) Méthode d'assistance pour copier les attributs de construction, la branche et la saveur d'une autre construction.
void	addAllFiles ( BuildInfo build) Méthode d'assistance pour copier tous les fichiers de l'autre build.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Permet d'appliquer certaines des IBuildInfo.BuildInfoProperties et éventuellement de faire une manipulation différente.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

Constructeurs publics

BuildInfo

public BuildInfo ()

Crée un BuildInfo à l'aide des valeurs d'attribut par défaut.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crée un BuildInfo

Paramètres
buildId	String : l'identifiant de construction
buildTargetName	String : le nom de la cible de génération

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

Nettoyez tous les fichiers de construction temporaires

nettoyer

public void cleanUp ( doNotClean)

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

Paramètres
doNotClean

cloner

public IBuildInfo clone ()

Retour
IBuildInfo

copierToutFichierDe

public final void copyAllFileFrom (BuildInfo build)

Copiez tous les VersionedFile d'un build donné vers celui-ci.

Paramètres
build	BuildInfo

équivaut à

public boolean equals (Object obj)

Paramètres
obj	Object

Retour
boolean

deProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Opération inverse à toProto() pour récupérer l'instance.

Paramètres
protoBuild	BuildInformation.BuildInfo

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  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 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 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 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 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 build)]

Retour
String

getDeviceSerial

public String getDeviceSerial ()

Retour
String

obtenirFichier

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

Renvoie tous VersionedFile stockés dans ce BuildInfo .

Retour

getProperties

public  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 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 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 final 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 final  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é

hashCode

public int hashCode ()

Retour
int

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

Définir la branche de construction

Paramètres
branch	String : le nom de la branche

setBuildFlavorsetBuildFlavor

public void setBuildFlavor (String buildFlavor)

Définissez la saveur de construction.

setBuildId

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

toString

public String toString ()

Retour
String

Méthodes protégées

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Méthode d'assistance pour copier les attributs de construction, la branche et la saveur d'une autre construction.

Paramètres
build	BuildInfo

ajouterTousFichiers

protected void addAllFiles (BuildInfo build)

Méthode d'assistance pour copier tous les fichiers de l'autre build.

Crée de nouveaux liens physiques vers les fichiers afin que chaque build ait un chemin d'accès unique vers le fichier.

Paramètres
build	BuildInfo

Lance
	si une exception est levée lors de la création du lien physique.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Permet d'appliquer certaines des IBuildInfo.BuildInfoProperties et éventuellement de faire une manipulation différente.

Paramètres
origFileConsidered	VersionedFile : Le VersionedFile actuellement consulté.
build	IBuildInfo : la version d'origine en cours de clonage
receiver	IBuildInfo : le build recevant les informations.

Retour
boolean	Vrai si nous avons appliqué les propriétés et que toute autre manipulation doit être ignorée. Faux sinon.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Retour
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Retour

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Retour
MultiMap <String, VersionedFile >