Ant - Fichiers de propriétés

La définition des propriétés directement dans le fichier de construction est très bien, si vous travaillez avec une poignée de propriétés. Cependant, pour un grand projet, il est judicieux de stocker les propriétés dans un fichier de propriétés distinct.

Le stockage des propriétés dans un fichier séparé offre les avantages suivants:

• Il vous permet de réutiliser le même fichier de construction, avec des paramètres de propriété différents pour différents environnements d'exécution. Par exemple, le fichier de propriétés de construction peut être géré séparément pour les environnements DEV, TEST et PROD.

• C'est utile lorsque vous ne connaissez pas les valeurs d'une propriété (dans un environnement particulier) à l'avance. Cela vous permet d'effectuer la génération dans d'autres environnements où la valeur de la propriété est connue.

Il n'y a pas de règle absolue, mais généralement le fichier de propriétés est nommé build.properties et est placé le long du build.xmlfichier. Vous pouvez créer plusieurs fichiers de propriétés de construction en fonction des environnements de déploiement, tels quebuild.properties.dev et build.properties.test.

Le contenu du fichier de propriétés de construction est similaire au fichier de propriétés java normal. Ils contiennent une propriété par ligne. Chaque propriété est représentée par un nom et une paire de valeurs. Les paires nom et valeur sont séparées par un signe égal (=). Il est fortement recommandé que les propriétés soient annotées avec des commentaires appropriés. Les commentaires sont répertoriés à l'aide du caractère dièse (#).

L'exemple suivant montre un build.xml fichier et son associé build.properties fichier -

build.xml

<?xml version = "1.0"?>
<project name = "Hello World Project" default = "info">
   <property file = "build.properties"/>
   
   <target name = "info">
      <echo>Apache Ant version is ${ant.version} - You are at ${sitename} </echo>
   </target>
</project>

build.properties

# The Site Name
sitename = www.tutorialspoint.com
buildversion = 3.3.2

Dans l'exemple ci-dessus, sitenameest une propriété personnalisée qui est mappée au nom du site Web. Vous pouvez déclarer un nombre illimité de propriétés personnalisées de cette manière. Une autre propriété personnalisée répertoriée dans l'exemple ci-dessus est labuildversion, qui, dans ce cas, fait référence à la version de la construction.

En plus de ce qui précède, Ant est livré avec un certain nombre de propriétés de construction prédéfinies, qui sont répertoriées dans la section précédente, mais sont à nouveau représentées ci-dessous.

N ° Sr.	Propriétés et description
1	ant.file L'emplacement complet du fichier de construction.
2	ant.version La version de l'installation d'Apache Ant.
3	basedir Le basedir de la construction, comme spécifié dans le basedir attribut du project élément.
4	ant.java.version La version du JDK utilisée par Ant.
5	ant.project.name Le nom du projet, tel que spécifié dans le name atrribut de la project élément.
6	ant.project.default-target La cible par défaut du projet actuel.
sept	ant.project.invoked-targets Liste séparée par des virgules des cibles qui ont été appelées dans le projet en cours.
8	ant.core.lib L'emplacement complet du fichier jar Ant.
9	ant.home Le répertoire de base de l'installation de Ant.
dix	ant.library.dir Le répertoire de base des fichiers de la bibliothèque Ant - généralement le dossier ANT_HOME / lib.

L'exemple présenté dans ce chapitre utilise le ant.version propriété intégrée.