Instalación y Configuración de Software
- Instalación del Ant

El siguiente componente a instalar es la herramienta de construcción Ant.

Nota:  A lo largo de este documento, se asume que el directorio raíz de instalación del producto, es C:\Adt (excepto donde se indique lo contrario).


1. Descarga e Instalación del Ant

La versión más reciente del Ant es la 1.5.2:

  1. En: http://ant.apache.org/bindownload.cgi

    buscamos el renglón correspondiente a .zip archive.

  2. Y descargamos el archivo: apache-ant-1.5.2-bin.zip.

    Este archivo mide 7.8M aproximadamente.

La instalación consiste en desempacar todo el contenido del archivo zip. Requiere de unos 23M en disco.

El producto instalado deberá quedar en la ruta: C:\Adt\apache-ant-1.5.2. Sin embargo, se recomienda renombrar el folder resultante (apache-ant-1.5.2) a un nombre corto y sin espacios, por ejemplo Ant.

Nota:  La documentación de Ant menciona lo siguiente:

Nota para Windows 95 y Windows 98:
En estos sistemas, el script utilizado para ejecutar Ant tendrán problemas si ANT_HOME es una nombre de archivo largo. Esto es debido a limitaciones en el manejo por parte del sistema operativo de la sentencia "for" en archivos *.bat. Se recomienda, por lo tanto, que Ant sea instalado en una ruta corta, C:\Ant.

La ruta final entonces deberá ser la siguiente: C:\Adt\Ant.

Nota:  A partir de este punto, me referiré a esa ruta como dir_ant.

2. Configuración del Ant

2.a. Modificar el Archivo Autoexec.bat

Lo primero que se requiere es agregar las siguientes líneas al archivo autoexec.bat:

  1. Definir la variable de ambiente ANT_HOME para que apunte al Directorio Base del Ant (no al folder "bin" del mismo):
    set ANT_HOME=C:\Adt\Ant
    
  2. Modificar la variable de ambiente PATH para que el sistema operativo pueda encontrar los scripts del Ant:
    set PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%PATH%
    
2.b. Corregir el archivo Ant.bat

El script dir_ant/bin/ant.bat trae un problema "de fábrica", ya que aún habiendo definido las variables como se indicó arriba, cuando se ejectua este script, éste termina con un error diciendo que la variable ANT_HOME no está definida:

ANT_HOME is set incorrectly or ant could not be located. Please set ANT_HOME.

La solución consiste en buscar las dos lineas siguientes:

if exist "%ANT_HOME%" goto checkJava

if not exist "%SystemDrive%\Program Files\ant" goto checkSystemDrive

Y modificarlas para que queden así:

if exist "%ANT_HOME%\nul" goto checkJava

if not exist "%SystemDrive%\Program Files\ant\nul" goto checkSystemDrive
2.c. Copiar el Archivo catalina-ant.jar

La siguiente tarea consiste en copiar el archivo dir_tom/server/lib/catalina-ant.jar al directorio dir_ant/lib

2.d. Copiar los Archivos de Construcción y Despliegue del Proyecto

La última tarea consiste en copiar del CD los archivos:

Para hacer lo anterior, ejecutamos los scripts:

Terminamos, una vez más, reiniciando el equipo.

3. Prueba del Ant

Para hacer la prueba, haremos lo siguiente:

  1. Comprobamos que nuestro directorio dir_code tiene la estructura requerida, y todos los archivos que hemos generado:
    
      D:\Dev
         |
         +-- curso_jsp
             |                     build.xml
             |                     build.properties
             |
             +-- src
             |   |                 p031_Holas.java
             |   |
             |   +-- pkgs
             |       |
             |       +-- pq01
             |                     p032_Holas.java
             |                     p033_Holas.java
             |                     p034_Util.java
             |
             +-- web
                 |                 p021_Hola.html
                 |                 p022_Hola.jsp
                 |
                 +-- WEB-INF
                                   web.xml
    
    
  2. Eliminamos el directorio dir_app (C:\Adt\Tomcat\webapps\curso_web) con todo su contenido.

    El Ant va a generar completamente este directorio :)

  3. En una ventana DOS, nos situamos en el directorio dir_code y escribimos ant.

    Una vez terminada la ejecución, podremos comprobar que tanto la estructura del directorio de despliegue, como toda la aplicación, han sido generadas.

Queda así finalizada la instalación del Ant.


Ayuda

Para más información sobre ant: