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 (String buildId, String buildTargetName) Crée un |
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 | allowStagingRemoteFile (boolean stageRemoteFile) Définit l’autorisation pour autoriser la préparation de fichiers distants. |
void | cleanUp () Nettoyer tous les fichiers de build temporaires |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) Version de |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Copiez tout le |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Opération inverse de |
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 |
getFiles () Renvoie tous | |
getProperties () Renvoie une copie des propriétés actuellement définies sur | |
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 |
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 |
final VersionedFile | getVersionedFile (String name) Méthode d'assistance pour récupérer un |
getVersionedFileKeys () Renvoie l'ensemble de clés disponibles pour interroger | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer une liste de |
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 |
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 |
void | setProperties ( BuildInfoProperties... properties) Définissez les |
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 |
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 |
AllowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Définit l’autorisation pour autoriser la préparation de fichiers distants.
Paramètres | |
---|---|
stageRemoteFile | boolean |
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 |
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
publicgetAppPackageFiles ()
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
publicgetBuildAttributes ()
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-userdebugRetour | |
---|---|
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
publicgetFiles ()
Renvoie tous VersionedFile
stockés dans ce BuildInfo
.
Retour | |
---|---|
obtenirPropriétés
publicgetProperties ()
Renvoie une copie des propriétés actuellement définies sur IBuildInfo
.
Retour | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Renvoie l'ensemble de clés disponibles pour interroger VersionedFile
via getFile(BuildInfoFileKey)
.
Retour | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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 gestion 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
protectedgetVersionedFileMap ()
Retour | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Retour | |
---|---|
MultiMap <String, VersionedFile > |