À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

Sous-classes directes connues

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	`IBuildInfo` représentant une application Android et ses packages de test
DeviceBuildInfo	`IBuildInfo` représentant une version complète d'appareil Android et (facultatif) ses tests.
FolderBuildInfo	Implémentation concrète d'un `IFolderBuildInfo`.
OtatoolsBuildInfo	`IBuildInfo` contenant des artefacts otatools

Sous-classes indirectes connues

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Cette classe est obsolète. Utilisez directement `IDeviceBuildInfo`.
ClusterBuildInfo	Classe `IBuildInfo` pour les compilations transmises à partir de TFC.
DeviceFolderBuildInfo	`IDeviceBuildInfo` contenant également d'autres artefacts de compilation contenus dans un répertoire du système de fichiers local.
OtaDeviceBuildInfo	`IDeviceBuildInfo` utilisé pour les tests de mise à jour OTA.

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 de 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 permettant de mettre en scène des fichiers distants.
`void`	`cleanUp()` Nettoyer 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é vers celui-ci.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` Inversez l'opération `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 le build.
`String`	`getBuildBranch()` Méthode facultative permettant de renvoyer la branche de contrôle source à partir de laquelle le build testé a été créé.
`String`	`getBuildFlavor()` Méthode facultative permettant de renvoyer le type de compilation en cours de test.
`String`	`getBuildId()` Renvoie l'identifiant unique du build en cours de test.
`String`	`getBuildTargetName()` Renvoie le nom complet du build en cours de test.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Méthode d'assistance permettant de récupérer un fichier avec un nom donné.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Méthode d'assistance permettant de récupérer un fichier avec un `BuildInfoFileKey` donné.
	`getFiles()` Renvoie tous les `VersionedFile` stockés dans cet objet `BuildInfo`.
	`getProperties()` Renvoie une copie des propriétés actuellement définies sur `IBuildInfo`.
	`getRemoteFiles()` Obtenez les chemins d'accès des artefacts de compilation dont le téléchargement est retardé.
`String`	`getTestTag()` Renvoie un nom unique pour les tests exécutés.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Méthode d'assistance permettant de récupérer une version de fichier avec un `BuildInfoFileKey` donné.
`String`	`getVersion(String name)` Méthode d'assistance permettant de récupérer une version de fichier avec un nom donné.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Méthode d'assistance permettant de récupérer un `VersionedFile` avec un `BuildInfoFileKey` donné.
`final VersionedFile`	`getVersionedFile(String name)` Méthode d'assistance permettant de récupérer un `VersionedFile` avec un nom donné.
	`getVersionedFileKeys()` Renvoie l'ensemble des clés disponibles pour interroger `VersionedFile` via `getFile(BuildInfoFileKey)`.
`final`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Méthode d'assistance permettant de récupérer une liste de `VersionedFile` associés à un `BuildInfoFileKey` donné.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Supprimez un 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 du build en cours de test.
`void`	`setDeviceSerial(String serial)` Définissez le numéro de série `ITestDevice` associé à ce build.
`void`	`setFile(String name, File file, String version)` Stocke un fichier avec le nom donné dans ces informations de compilation.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Stocke un fichier donné un `BuildInfoFileKey` dans ces informations de compilation.
`void`	`setProperties(BuildInfoProperties... properties)` Définissez `BuildInfoProperties` pour l'instance `IBuildInfo`.
`void`	`setTestTag(String testTag)` Définit le nom unique des tests exécutés.
`File`	`stageRemoteFile(String fileName, File workingDir)` Mettez en scène un fichier qui fait partie de fichiers distants dans le répertoire racine des informations de compilation.
`BuildInformation.BuildInfo`	`toProto()` Sérialisez l'instance BuildInfo dans un 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 la saveur d'un autre build.
`void`	`addAllFiles(BuildInfo build)` Méthode d'assistance permettant de copier tous les fichiers de l'autre build.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Autorisez l'application de certains `IBuildInfo.BuildInfoProperties` et éventuellement une gestion différente.
`MultiMap<String, String>`	`getAttributesMultiMap()`
	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Constructeurs publics

BuildInfo

public BuildInfo ()

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

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crée un BuildInfo

Paramètres
`buildId`	`String`: ID de 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 seront renvoyés à partir de 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. Cela ne permet pas de remplacer un attributeName existant.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Ajouter des attributs de compilation

Paramètres
`buildAttributes`	: mappage des attributs à ajouter

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Définit l'autorisation permettant de mettre en scène des fichiers distants.

Paramètres
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

Nettoyer les fichiers de compilation temporaires

cleanUp

public void cleanUp ( doNotClean)

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

Paramètres
`doNotClean`

clone

public IBuildInfo clone ()

Renvoie
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copiez tous les VersionedFile d'un build donné vers 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)

Inversez l'opération 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. L'ordre renvoyé 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 le build.

Renvoie
	un `ERROR(/Map)` d'attributs de compilation. Ne doit pas être `null`, mais peut être vide.

getBuildBranch

public String getBuildBranch ()

Méthode facultative permettant de renvoyer la branche de contrôle source à partir de laquelle le build testé a été créé.

Renvoie
`String`	la branche de compilation ou `null` si non défini/non applicable

getBuildFlavor

public String getBuildFlavor ()

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

Une implémentation courante pour les builds de la plate-forme Android consiste à renvoyer (build product)-(build os)-(build variant). ie generic-linux-userdebug

Renvoie
`String`	la saveur de compilation ou `null` si elle n'est pas définie ou n'est pas applicable

getBuildId

public String getBuildId ()

Renvoie l'identifiant unique du build en cours de test. Ne doit jamais être "null". La valeur par défaut est UNKNOWN_BUILD_ID.

Renvoie
`String`

getBuildTargetName

public String getBuildTargetName ()

Renvoie le nom complet du build en cours de test.

Une implémentation courante consiste à créer le nom de la cible de compilation à partir d'une combinaison de la saveur de compilation et du nom de la branche. [ie (nom de la branche)-(saveur 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 avec un nom donné.

Renvoie
`File`	le fichier image ou `null` si celui-ci est introuvable

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

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

Renvoie
`File`	le fichier image ou `null` si celui-ci est introuvable

getFiles

public  getFiles ()

Renvoie tous les VersionedFile stockés dans cet objet 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 des artefacts de compilation dont le téléchargement est retardé.

Renvoie

getTestTag

public String getTestTag ()

Renvoie un nom unique pour les tests exécutés.

Renvoie
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance permettant de 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 permettant de récupérer une version de fichier avec un 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 permettant de récupérer un VersionedFile avec un BuildInfoFileKey donné.

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

Renvoie
`VersionedFile`	Le fichier versionné ou `null`, le cas échéant

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

Renvoie
`VersionedFile`	Le fichier versionné ou `null`, le cas échéant

getVersionedFileKeys

public  getVersionedFileKeys ()

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

Renvoie

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance permettant de 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`: `BuildInfoFileKey` demandé.

Renvoie
	Le fichier versionné ou `null`, le cas échéant

hashCode

public int hashCode ()

Renvoie
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Supprimez un attributeName donné du suivi.

Paramètres
`attributeName`	`String`: attribut à arrêter de suivre

setBuildBranch

public void setBuildBranch (String branch)

Définir la branche de compilation

Paramètres
`branch`	`String`: nom de l'agence

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Définissez le type de compilation.

setBuildId

public void setBuildId (String buildId)

Définit l'identifiant unique du build en cours de test. Ne doit jamais être "null".

Paramètres
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

setFile

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

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

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

setFile

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

Stocke un fichier donné un BuildInfoFileKey dans ces informations de compilation.

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

setProperties

public void setProperties (BuildInfoProperties... properties)

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

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

setTestTag

public void setTestTag (String testTag)

Définit le nom unique des tests exécutés.

Paramètres
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

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

Paramètres
`fileName`	`String`: nom du fichier à rechercher dans les fichiers distants.
`workingDir`	`File`: objet `ERROR(/File)` du répertoire à mettre en scène.

Renvoie
`File`	l'objet `ERROR(/File)` du fichier mis en scène dans le répertoire de travail local.

toProto

public BuildInformation.BuildInfo toProto ()

Sérialisez l'instance BuildInfo dans un 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 la saveur d'un autre build.

Paramètres
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

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

Crée des liens physiques vers les fichiers afin que chaque build dispose d'un chemin d'accès unique au fichier.

Paramètres
`build`	`BuildInfo`

Génère
	si une exception est générée lors de la création du lien physique.

applyBuildProperties

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

Autorisez l'application de certains IBuildInfo.BuildInfoProperties et éventuellement une gestion différente.

Paramètres
`origFileConsidered`	`VersionedFile`: `VersionedFile` actuellement consulté.
`build`	`IBuildInfo`: build d'origine cloné
`receiver`	`IBuildInfo`: compilation recevant les informations.

Renvoie
`boolean`	"True" si nous avons appliqué les propriétés et que la gestion ultérieure doit être ignorée. Sinon, cette valeur est "false".

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Renvoie
`MultiMap<String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Renvoie

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Renvoie
`MultiMap<String, VersionedFile>`