# Manual básico de ANT

Apache Ant es una herramienta usada en programación (véase Fundamentos de programación) para la realización de tareas mecánicas y repetitivas, normalmente durante la fase de compilación y construcción (build). Es similar a Make pero desarrollado en lenguaje Java y requiere la plataforma Java.
Esta herramienta, hecha en el lenguaje de programación Java, tiene la ventaja de no depender de las órdenes del shell de cada sistema operativo, sino que se basa en archivos de configuración XML y clases Java para la realización de las distintas tareas, siendo idónea como solución multi-plataforma.

# Ejecución de Apache Ant
## ¿Qué se necesita para ejecutar ANT?

Para utilizar ANT basta con disponer de una distribución binaria de ANT y tener instalado la versión 1.4 o superior del JDK. La distribución binaria consiste en la siguiente estructura de directorios:
De dichos directorios, sólo se necesitan bin y lib para ejecutar ANT.

## Algunas consideraciones a tener en cuenta

* Al ser una herramienta basada en XML, los archivos Ant deben ser escritos en XML.
* La mayoría de las antiguas herramientas — las que se usan todos los días, como <javac>, <exec> y <java> — tienen malas configuraciones por defecto, valores para opciones que no son coherentes con las tareas más recientes.
* Cuando se expanden las propiedades en una cadena o un elemento de texto, las propiedades no definidas no son planteadas como error, sino que se dejan como una referencia sin expandir (ej.: ${unassigned.property}).
* No es un lenguaje para un flujo de trabajo general, y no debería ser usado como tal.

## Ejecución de ANT

Para ejecutar ANT basta con escribir ant en la línea de comandos. Si se ha especificado la ejecución de un objetivo por defecto en la cabecera del proyecto del fichero build.xml no es necesario el uso de ningún parámetro ya que, como acabamos de ver en el ejemplo anterior, se ejecutara este por defecto. Para utilizar un buildfile diferente de build.xml hay que añadir el parámetro -buildfile nombre_fichero, donde nombre_fichero es el buildfile que se quiere utilizar:
Si se desea ejecutar uno o varios objetivos concretos, se debe añadir el nombre de este o estos objetivos en la línea de comandos vv:
En este caso se ignorará el objetivo indicado en la cabecera del proyecto.

# Configuración

Una vez obtenida la anterior distribución de ANT, se deben seguir los siguientes pasos:
- Añadir el directorio "bin" al path. - Asignar a la variable de entorno "ANT_HOME" la ruta donde se ha instalado ANT. - Opcionalmente, asignar a la variable de entorno "JAVA_HOME" la ruta donde se ha instalado el JDK.
Dependiendo del sistema operativo en el que nos encontremos tendremos los siguientes ejemplos de configuración:
Windows y OS/2 (Suponiendo que se ha instalado ANT en c:\ant\)
set ANT_HOME=c:\ant set JAVA_HOME=c:\jdk1.2.2 set PATH=%PATH%;%ANT_HOME%\bin
Unix (bash) (Suponiendo que se ha instalado ANT en /usr/local/ant)
export ANT_HOME=/usr/local/ant export JAVA_HOME=/usr/local/jdk-1.2.2 export PATH=${PATH}:${ANT_HOME}/bin
Unix (csh) setenv ANT_HOME /usr/local/ant setenv JAVA_HOME /usr/local/jdk-1.2.2 set path=( $path $ANT_HOME/bin )

## Estructura de un fichero build.xml

Los ficheros buildfiles de ANT están escritos en XML. Cada buildfile contiene un proyecto (project) y al menos un objetivo (target). Cada objetivo puede contener varias tareas (task) que son fragmentos de código a ejecutar. Un proyecto, además, puede constar de diversas propiedades. Cada propiedad consta de nombre y valor y son usadas para asignar valores a los atributos de los task.
La estructura de un fichero buildfile podría ser la siguiente:

## Ejemplo de buildfile

A continuación se muestra un ejemplo de un archivo build.xml:
La primera línea se corresponde con el proyecto que compone el buildfile, en ella pueden aparecer los siguientes atributos:
A continuación aparecen un listado de propiedades, su declaración se compone del literal property y los atributos name para especificar el nombre y location para asignarles un valor.
Lo siguiente que aparece en el ejemplo son los objetivos. El primero de ellos es init:
Como se mencionó anteriormente, un objetivo esta compuesto por una o varias tareas, en este caso tenemos las tareas tstamp y mkdir, las cuales muestran la fecha y crean el directorio descrito por la propiedad build respectivamente.
El siguiente objetivo que aparece es compile
En la declaración del objetivo podemos ver los siguiente atributos:
El cuerpo del objetivo está formado por la tarea javac, que toma los ficheros fuente ubicados en la ruta indicada por el atributo srcdir y los compila en destdir.
El siguiente objetivo que compone el buildfile es dist.
En este caso, dist depende del objetivo compile para ejecutarse, luego, antes de lanzar sus tareas se debe haber ejecutado compile. En este objetivo aparece la tarea mkdir descrita anteriormente y jar, esta tarea construye un jar con el nombre MyProject concatenado con la fecha del sistema (DSTAMP) a partir de los compilados en el directorio indicado por la propiedad build.
Por ultimo tenemos el objetivo clean
Compuesto por 2 tareas delete. Simplemente borra los directorios temporales necesarios para la creación del jar.
Si repasamos la cabecera del proyecto, vemos que por defecto llama al objetivo dist, el cual depende de compile y este a su vez de init, por lo que el orden lógico de ejecución de este build.xml es:
El objetivo clean no depende del resto y tampoco se especifica en la cabecera del proyecto, por lo que se debe referenciar de forma explicita en la línea de comandos para que se ejecute.
Otro ejemplo de build.xmlpuede ser el siguiente:

## Ejemplo para una aplicación Hola Mundo
### Fichero de ejemplo build.xml

Debajo se muestra un archivo de ejemplo (build.xml) para una aplicación "Hola mundo" en Java. El archivo define cuatro objetivos - clean, clobber, compile y jar, cada uno de los cuales tiene una descripción asociada. El objetivo jar lista el objetivo compile como dependencia. Esto le dice a ANT que, antes de empezar el objetivo jar, debe completar el objetivo compile.
Dentro de cada objetivo están las acciones que debe tomar ANT para construirlo (el objetivo); éstas se realizan usando tareas (tasks) incluidas (built-in). Por ejemplo, para construir el objetivo compile, ANT debe primero crear un directorio llamado classes (ANT sólo lo hará si éste no existe previamente) y luego llamar al compilador de Java. Por lo tanto, las tareas utilizadas son mkdir y javac. Éstos realizan una tarea similar a las utilidades de línea de comandos del mismo nombre.
Otra tarea usada en este ejemplo se llama jar:
Esta tarea de Apache Ant se llama igual que la utilidad de línea de comandos común de Java, JAR, pero es en realidad una llamada al soporte de archivos jar/zip de Ant. Este detalle no es relevante para la mayoría de los usuarios finales, que obtienen el JAR que querían, con los archivos que pidieron.
Muchas de las tareas Ant delegan su trabajo a los programas externos, ya sean nativos o Java. Utilizan <exec> propia Ant y tareas <java> configurar las líneas de comandos, y manejar todos los detalles de la cartografía (mapeo) de la información en el fichero de construcción a los argumentos del programa y la interpretación del valor de retorno. Los usuarios pueden ver a las tareas hacer esto (por ejemplo, <cvs>, <signjar>, <chmod>, <rpm>), al tratar de ejecutar la tarea en un sistema sin el programa subyacente en la ruta del sistema de archivos, o sin un conjunto de desarrollo Java (JDK) completo instalado.

# Portabilidad

Una de las primeras ayudas de Ant fue solucionar los problemas de portabilidad de Make. En un Makefile las acciones necesarias para crear un objetivo se especifican como órdenes de Intérprete de comandos que son específicos de la plataforma, normalmente un shell de UNIX. Ant resuelve este problema proveyendo una gran cantidad de funcionalidades por él mismo, que pueden garantizar que permanecerán (casi) idénticas en todas las plataformas.
Por ejemplo, en el ejemplo build.xml debajo del objetivo clean borra el directorio classes y todo su contenido. En un Makefile esto normalmente se haría con la orden:
rm (véase el manual de la consola Bash) es una orden específica de UNIX, que probablemente no estará disponible si el Makefile se usa en un entorno no Unix como Windows. En un archivo de construcción Ant se puede conseguir lo mismo usando una orden propia:
Una discrepancia común entre diferentes plataformas es la manera en que las rutas de directorios se especifican. Unix usa la barra (/) para delimitar los componentes de una ruta, mientras que Windows usa la barra invertida (\). Los archivos de Ant permiten al autor elegir su convención favorita, barras o barras invertidas para directorios, comas o punto y coma para separar rutas. Ant lo convierte todo al formato apropiado para la plataforma actual.

# Referencias
## Bibliografía

Para ampliar conocimientos en el uso de ANT, por favor consultar el siguiente enlace:
http://ant.apache.org/manual/