Informations sur la construction

public class BuildInfo
extends Object implements IBuildInfo

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


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

void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Ajouter des attributs de build

void cleanUp ()

Nettoyer tous les fichiers de build 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 tout le VersionedFile d'une version donnée vers celle-ci.

boolean equals (Object obj)

static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Opération inverse de 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 build.

String getBuildBranch ()

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

String getBuildFlavor ()

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

String getBuildId ()

Renvoie l'identifiant unique de la build en cours de test.

String getBuildTargetName ()

Renvoie le nom complet de la build en cours de test.

String getDeviceSerial ()

File getFile (String name)

Méthode d'assistance pour récupérer un fichier portant 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 ()

Renvoie 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 un 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 l'ensemble 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)

Supprimez 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 build en cours de 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 un nom donné dans ces informations de build.

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

Stocke un fichier doté d'une BuildInfoFileKey dans ces informations 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)

Placez un fichier faisant 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, la branche et la version de build à partir d'une autre build.

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 d'effectuer une manipulation différente.

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

Constructeurs publics

Informations sur la construction

public BuildInfo ()

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

Informations sur la construction

public BuildInfo (String buildId, 
                String buildTargetName)

Crée un BuildInfo

Paramètres
buildId String : l'identifiant du build

buildTargetName String : le nom de la cible de build

Méthodes publiques

addAppPackageFile

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

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

Paramètres
attributeName String : le nom unique de l'attribut

attributeValue String : la valeur de l'attribut

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Ajouter des attributs de build

Paramètres
buildAttributes : Carte des attributs à ajouter

nettoyer

public void cleanUp ()

Nettoyer tous les fichiers de build 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

copierAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copiez tout le VersionedFile d'une version donnée vers celle-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 de 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 au IAppBuildInfo .

Retour

getBuildAttributes

public  getBuildAttributes ()

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

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

obtenirBuildBranch

public String getBuildBranch ()

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

Retour
String la branche de construction ou null si elle n'est pas définie/non applicable

getBuildFlavor

public String getBuildFlavor ()

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

Une implémentation courante pour les versions de 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éfinie/non applicable

getBuildId

public String getBuildId ()

Renvoie l'identifiant unique de la build en cours de test. Ne devrait jamais être nul. La valeur par défaut est UNKNOWN_BUILD_ID .

Retour
String

getBuildTargetName

public String getBuildTargetName ()

Renvoie le nom complet de la build en cours de test.

Une implémentation courante consiste à construire le nom de la cible de build à partir d’une combinaison de la version de build et du nom de branche. [c'est-à-dire (nom de la branche) - (version de construction)]

Retour
String

getDeviceSerial

public String getDeviceSerial ()

Retour
String

obtenir un fichier

public File getFile (String name)

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

Retour
File le fichier image ou null s'il n'est pas trouvé

obtenir un fichier

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 : la BuildInfoFileKey demandée.

Retour
File le fichier image ou null s'il n'est pas trouvé

obtenir des fichiers

public  getFiles ()

Renvoie tous VersionedFile stockés dans ce BuildInfo .

Retour

obtenirPropriétés

public  getProperties ()

Renvoie 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

obtenirTestTag

public String getTestTag ()

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

Retour
String

obtenir la version

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 : la BuildInfoFileKey demandée.

Retour
String la version de l'image ou null si elle n'est pas trouvée

obtenir la version

public String getVersion (String name)

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

Retour
String la version de l'image ou null si elle n'est pas trouvée

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 : la BuildInfoFileKey demandée.

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 l'ensemble 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 clé permet de stocker une liste.

Paramètres
key BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey demandée.

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

Code de hachage

public int hashCode ()

Retour
int

supprimerBuildAttribute

public void removeBuildAttribute (String attributeName)

Supprimez un nom d'attribut donné du suivi.

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

setBuildBranch

public void setBuildBranch (String branch)

Définir la branche de construction

Paramètres
branch String : le nom de la branche

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Définissez la saveur de construction.

setBuildId

public void setBuildId (String buildId)

Définit l'identifiant unique de la build en cours de test. Ne devrait jamais être nul.

Paramètres
buildId String

setDeviceSerial

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 du ITestDevice avec lequel cette build a été exécutée.

setFichier

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

Stocke un fichier avec un nom donné dans ces informations de build.

Paramètres
name String : le nom unique du fichier

file File : l' ERROR(/File)

version String : la version du fichier

setFichier

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

Stocke un fichier doté d'une BuildInfoFileKey dans ces informations 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

définirPropriétés

public void setProperties (BuildInfoProperties... properties)

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

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

définirTestTag

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)

Placez un fichier faisant 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 pour stocker le fichier.

Retour
File l'objet ERROR(/File) du fichier stocké dans le répertoire de travail local.

versProto

public BuildInformation.BuildInfo toProto ()

Sérialisez une instance BuildInfo dans un protobuf.

Retour
BuildInformation.BuildInfo

versChaîne

public String toString ()

Retour
String

Méthodes protégées

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Méthode d'assistance pour copier les attributs, la branche et la version de build à partir d'une autre build.

Paramètres
build BuildInfo

ajouterTous les fichiers

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 au fichier.

Paramètres
build BuildInfo

Jetés
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 d'effectuer une manipulation différente.

Paramètres
origFileConsidered VersionedFile : 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 les manipulations ultérieures doivent être ignorées. 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 >