Propiedades de hormiga
En esta página
Las propiedades son pares clave-valor donde Apache Ant intenta expandir ${clave} a valor en tiempo de ejecución.
Las propiedades Ant son muy útiles si tiene que hacer mucho procesamiento para crear instalables o hacer implementaciones personalizadas, etc.
Por ejemplo, puede marcar ${src.dir} como directorio de código fuente, ${lib.dir} como biblioteca para proyecto, ${javadoc.dir} para javadocs, etc.
En lugar de escribir la ruta completa en cada ubicación, puede hacer referencia a ellos mediante este marcador de posición.
Cómo declarar y usar propiedades en Ant.
Ant proporciona algunas propiedades integradas
Nombre de propiedad | Valor |
---|---|
basado | la ruta absoluta del directorio base del proyecto |
ant.file | la ruta absoluta del archivo de compilación. |
ant.versión | la versión de Ant |
ant.project.default-target | el nombre del objetivo predeterminado del proyecto que se está ejecutando actualmente |
hormiga.proyecto.nombre | nombre del proyecto |
ant.java.version | Versión de JVM Ant detectada |
En este ejemplo, crearemos propiedades ant personalizadas y las usaremos para crear un directorio temporal y copiar un archivo en él.
- Propiedades declaradas dentro del mismo expediente.
<project name="Test Project for Ant" default="init">
<property name="temp.dir" value="${basedir}/temp" />
<target name="init" description="initialize">
<mkdir dir="${temp.dir}" />
<copy file="${basedir}/test.xml" todir="${temp.dir}/" />
</target>
</project>
En Ant, ${basedir} se referirá a la ubicación base o la ubicación donde está presente su archivo ant. Aquí declaré una propiedad nombrada como
temp.dir
que se referirá a la ubicación basada en directorio/temp.
Entonces, llamamos a target init, reemplazará el marcador de posición ${temp.dir} con su valor real y comenzará a ejecutar nuestro script. Este destino creará un directorio llamado temp en el directorio base, copie el archivo test.xml en el directorio temporal.
- Propiedades declaradas en diferentes ficheros.
En este ejemplo, nos referiremos a las propiedades declaradas en un archivo diferente. Este es un archivo de muestra (app_version.xml) que contiene la versión de la aplicación.
<project name="Project Properties">
<property name="app.version" value="1.0" />
</project>
Para incluir este archivo, agregaremos la tarea ant de importación para importar este archivo mientras se ejecutan los objetivos ant.
<import file="app_version.xml" />
El código anterior se verá como
<project name="Test Project for Ant" default="init">
<import file="app_version.xml" />
<property name="temp.dir" value="${basedir}/temp" />
<target name="init" description="initialize">
<mkdir dir="${temp.dir}" />
<copy file="${basedir}/test.xml" todir="${temp.dir}/" />
<echo message="App version is:${app.version}" />
</target>
Una vez que se importa el archivo, se puede acceder directamente a él a través del nombre de la propiedad (app.version).
Usé el archivo .xml, el mismo caso de uso también funcionará para los archivos .properties.