Informations sur la compilation

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é avec 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 compilation.

void addBuildAttributes( buildAttributes)

Ajouter des attributs de compilation

void allowStagingRemoteFile(boolean stageRemoteFile)

Définit l'autorisation d'autoriser la préproduction des fichiers distants.

void cleanUp()

Nettoyez tous les fichiers de compilation temporaires

void cleanUp( doNotClean)

Version de cleanUp() dans laquelle certains fichiers ne sont pas supprimés.

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

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

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

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

getAppPackageFiles()

Récupère une copie de l'ensemble des fichiers APK d'application locaux et de leurs versions.

getBuildAttributes()

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

String getBuildBranch()

Méthode facultative pour renvoyer la branche de contrôle du code source avec laquelle la compilation en cours de test a été à partir duquel elles sont produites.

String getBuildFlavor()

Méthode facultative permettant de renvoyer le type de compilation testé.

String getBuildId()

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

String getBuildTargetName()

Renvoyez le nom complet de la compilation en cours de test.

String getDeviceSerial()

File getFile(String name)

Méthode d'assistance permettant de récupérer un fichier portant le nom donné.

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

getFiles()

Renvoie toutes les VersionedFile stockées 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 compilation dont le téléchargement est retardé.

String getTestTag()

Renvoyez 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 portant 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 l'ensemble de clés disponible 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 attribut "attributeName" donné du suivi.

void setBuildBranch(String branch)

Définir la branche de compilation

void setBuildFlavor(String buildFlavor)

Définissez le type de compilation.

void setBuildId(String buildId)

Définit l'identifiant unique de la compilation testée.

void setDeviceSerial(String serial)

Définissez le série ITestDevice associé à ce build.

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

Stocke un fichier portant le nom donné dans ces informations de compilation.

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

Stocke un fichier associé à un BuildInfoFileKey dans ces informations de compilation.

void setProperties(BuildInfoProperties... properties)

Définissez le paramètre 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)

Préparez un fichier faisant partie de fichiers distants dans le répertoire racine des informations de compilation.

BuildInformation.BuildInfo toProto()

Sérialiser une instance BuildInfo en protobuf

String toString()

Méthodes protégées

void addAllBuildAttributes(BuildInfo build)

Méthode d'assistance permettant de copier les attributs de compilation, la branche et le type de produit d'une autre compilation.

void addAllFiles(BuildInfo build)

Méthode d'assistance permettant de copier tous les fichiers de l'autre compilation.

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

Autoriser à appliquer certains des IBuildInfo.BuildInfoProperties et d'appliquer un traitement différent.

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

Constructeurs publics

Informations sur la compilation

public BuildInfo ()

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

Informations sur la compilation

public BuildInfo (String buildId, 
                String buildTargetName)

Crée un BuildInfo

Paramètres
buildId String: ID de la compilation
buildTargetName String: nom de la cible de compilation

Méthodes publiques

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Ajoute le fichier APK local et sa version associée. Notez que les APK sont renvoyés depuis 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 compilation. Cette règle ne permet pas de remplacer un nom d'attribut existant.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Ajouter des attributs de compilation

Paramètres
buildAttributes : carte des attributs à ajouter.

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Définit l'autorisation d'autoriser la préproduction des fichiers distants.

Paramètres
stageRemoteFile boolean

nettoyage

public void cleanUp ()

Nettoyez tous les fichiers de compilation temporaires

nettoyage

public void cleanUp ( doNotClean)

Version de cleanUp() dans laquelle certains fichiers ne sont pas supprimés.

Paramètres
doNotClean

cloner

public IBuildInfo clone ()

Renvoie
IBuildInfo

copierToutFichierDe

public final void copyAllFileFrom (BuildInfo build)

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

Paramètres
build BuildInfo

equals

public boolean equals (Object obj)

Paramètres
obj Object

Renvoie
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

Paramètres
protoBuild BuildInformation.BuildInfo

Renvoie
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Récupère une copie de l'ensemble des fichiers APK d'application locaux et de leurs versions. La commande retournée correspond à l'ordre dans lequel les APK ont été ajoutés à IAppBuildInfo.

Renvoie

getBuildAttributes

public  getBuildAttributes ()

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

Renvoie
Une ERROR(/Map) d'attributs de compilation. Ne correspond pas à null, mais peut être vide.

getBuildBranch

public String getBuildBranch ()

Méthode facultative pour renvoyer la branche de contrôle du code source avec laquelle la compilation en cours de test a été à partir duquel elles sont produites.

Renvoie
String Branche de compilation ou null s'il n'est pas défini/non applicable

getBuildFlavor

public String getBuildFlavor ()

Méthode facultative permettant de renvoyer le type de compilation testé.

Une implémentation courante pour les builds de plate-forme Android consiste à renvoyer (build produit)-(build os)-(version de compilation). Exemple d'application générique : linux-userdebug

Renvoie
String Type de compilation ou null s'il n'est pas défini/non applicable

getBuildId

public String getBuildId ()

Renvoie l'identifiant unique de la compilation testée. Ne doit jamais être nulle. La valeur par défaut est UNKNOWN_BUILD_ID.

Renvoie
String

getBuildTargetName

public String getBuildTargetName ()

Renvoyez le nom complet de la compilation en cours de test.

Une implémentation courante consiste à construire le nom de la cible de compilation à partir d'une combinaison le type de compilation et le nom de la branche. [ie (nom de la branche)-(type de compilation)]

Renvoie
String

getDeviceSerial

public String getDeviceSerial ()

Renvoie
String

getFile

public File getFile (String name)

Méthode d'assistance permettant de récupérer un fichier portant le nom donné.

Renvoie
File Le fichier image ou null s'il est introuvable

getFile

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: BuildInfoFileKey demandé.
Renvoie
File Le fichier image ou null s'il est introuvable

getFiles

public  getFiles ()

Renvoie toutes les VersionedFile stockées dans ce BuildInfo.

Renvoie

getProperties

public  getProperties ()

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

Renvoie

getRemoteFiles

public  getRemoteFiles ()

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

Renvoie

getTestTag

public String getTestTag ()

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

Renvoie
String

getVersion

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: BuildInfoFileKey demandé.
Renvoie
String la version de l'image ou null si elle est introuvable.

getVersion

public String getVersion (String name)

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

Renvoie
String la version de l'image ou null si elle est 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: BuildInfoFileKey demandé.
Renvoie
VersionedFile Fichier avec gestion des versions ou null s'il est introuvable

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

Renvoie
VersionedFile Fichier avec gestion des versions ou null s'il est introuvable

getVersionedFileKeys

public  getVersionedFileKeys ()

Renvoie l'ensemble de clés disponible pour interroger VersionedFile via getFile(BuildInfoFileKey).

Renvoie

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Paramètres
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey demandé.
Renvoie
Fichier avec gestion des versions ou null s'il est introuvable

hashCode

public int hashCode ()

Renvoie
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Supprimez un attribut "attributeName" donné du suivi.

Paramètres
attributeName String: attribut permettant d'arrêter le suivi

setBuildBranch

public void setBuildBranch (String branch)

Définir la branche de compilation

Paramètres
branch String: nom de la branche

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Définissez le type de compilation.

setBuildId

public void setBuildId (String buildId)

Définit l'identifiant unique de la compilation testée. Ne doit jamais être nulle.

Paramètres
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

Définissez le série ITestDevice associé à ce build.

Paramètres
serial String: numéro de série du ITestDevice avec lequel cette compilation a été exécutée.

Définir un fichier

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

Stocke un fichier portant le nom donné dans ces informations de compilation.

Paramètres
name String: nom unique du fichier
file File: ERROR(/File) locale
version String: version du fichier

Définir un fichier

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

Stocke un fichier associé à un BuildInfoFileKey dans ces informations de compilation.

Paramètres
key BuildInfoKey.BuildInfoFileKey: nom unique du fichier basé sur BuildInfoFileKey.
file File: ERROR(/File) locale
version String: version du fichier

setProperties

public void setProperties (BuildInfoProperties... properties)

Définissez le paramètre BuildInfoProperties pour l'instance IBuildInfo. Remplacer au choix les propriétés existantes.

Paramètres
properties BuildInfoProperties: liste des établissements à ajouter.

setTestTag

public void setTestTag (String testTag)

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

Paramètres
testTag String

imageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Préparez un fichier faisant partie de fichiers distants dans le répertoire racine des informations de compilation.

TODO(b/138416078): supprimer cette interface et son appelant lorsque les modules sont requis par un test peut être correctement compilée en sortie dans le répertoire du module de test lui-même.

Paramètres
fileName String: nom du fichier qui se trouvera dans les fichiers distants.
workingDir File: objet ERROR(/File) du répertoire dans lequel placer le fichier.
Renvoie
File L'objet ERROR(/File) du fichier stocké dans le workDir local.

toProto

public BuildInformation.BuildInfo toProto ()

Sérialiser une instance BuildInfo en protobuf

Renvoie
BuildInformation.BuildInfo

toString

public String toString ()

Renvoie
String

Méthodes protégées

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Méthode d'assistance permettant de copier les attributs de compilation, la branche et le type de produit d'une autre compilation.

Paramètres
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Méthode d'assistance permettant de copier tous les fichiers de l'autre compilation.

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

Paramètres
build BuildInfo

Génère
si une exception est levée lors de la création du hardlink.

applyBuildProperties

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

Autoriser à appliquer certains des IBuildInfo.BuildInfoProperties et d'appliquer un traitement différent.

Paramètres
origFileConsidered VersionedFile: VersionedFile actuellement examiné.
build IBuildInfo: build d'origine en cours de clonage
receiver IBuildInfo: compilation recevant les informations.
Renvoie
boolean "True" si nous appliquons les propriétés et que toute autre manipulation doit être ignorée. Faux sinon.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Renvoie
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Renvoie

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Renvoie
MultiMap<String, VersionedFile>