Ant - Archivos de propiedad

Establecer propiedades directamente en el archivo de compilación está bien, si está trabajando con un puñado de propiedades. Sin embargo, para un proyecto grande, tiene sentido almacenar las propiedades en un archivo de propiedades separado.

Almacenar las propiedades en un archivo separado ofrece los siguientes beneficios:

• Le permite reutilizar el mismo archivo de compilación, con diferentes configuraciones de propiedades para diferentes entornos de ejecución. Por ejemplo, el archivo de propiedades de compilación se puede mantener por separado para los entornos DEV, TEST y PROD.

• Es útil cuando no conoce los valores de una propiedad (en un entorno particular) por adelantado. Esto le permite realizar la construcción en otros entornos donde se conoce el valor de la propiedad.

No existe una regla estricta y rápida, pero normalmente el archivo de propiedades se denomina build.properties y se coloca junto al build.xmlarchivo. Puede crear varios archivos de propiedades de compilación en función de los entornos de implementación, comobuild.properties.dev y build.properties.test.

El contenido del archivo de propiedades de compilación es similar al archivo de propiedades de Java normal. Contienen una propiedad por línea. Cada propiedad está representada por un nombre y un par de valores. Los pares de nombre y valor están separados por un signo igual (=). Se recomienda encarecidamente que las propiedades se anoten con los comentarios adecuados. Los comentarios se enumeran utilizando el carácter de almohadilla (#).

El siguiente ejemplo muestra un build.xml archivo y su asociado build.properties archivo -

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

En el ejemplo anterior, sitenamees una propiedad personalizada que se asigna al nombre del sitio web. Puede declarar cualquier cantidad de propiedades personalizadas de esta manera. Otra propiedad personalizada enumerada en el ejemplo anterior es labuildversion, que, en este caso, se refiere a la versión de la compilación.

Además de lo anterior, Ant viene con una serie de propiedades de construcción predefinidas, que se enumeran en la sección anterior, pero que se representan a continuación una vez más.

No Señor.	Propiedades y descripción
1	ant.file La ubicación completa del archivo de compilación.
2	ant.version La versión de la instalación de Apache Ant.
3	basedir La base de la compilación, como se especifica en el basedir atributo del project elemento.
4	ant.java.version La versión del JDK que usa Ant.
5	ant.project.name El nombre del proyecto, como se especifica en el name Atributo de la project elemento.
6	ant.project.default-target El destino predeterminado del proyecto actual.
7	ant.project.invoked-targets Lista separada por comas de los destinos que se invocaron en el proyecto actual.
8	ant.core.lib La ubicación completa del archivo jar de Ant.
9	ant.home El directorio de inicio de la instalación de Ant.
10	ant.library.dir El directorio de inicio de los archivos de la biblioteca Ant, normalmente la carpeta ANT_HOME / lib.

El ejemplo presentado en este capítulo utiliza la ant.version propiedad incorporada.