Propiedades de hormiga

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.

  1. 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.

  1. 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.