Instalación Ant en Plataformas Windows

Pasos Previos

• Instalación funcional del JDK 1.4.2 o JDK 5, según descrito en : Instalación JDK en Plataformas Windows

Descarga (Ant)

Descargar la versión más reciente de Ant :

• Ant 1.6.x [~9.3 MB]
• Descargar la versión más reciente del árbol 1.6.x
• Descargar la versión con extensión bin.zip

Instalación

• Descomprimir el archivo de Ant a través de WinZip y colocarlo dentro de un directorio temporal/instalación.
• Una vez terminada la instalación se recomienda cambiar el nombre del directorio apache-ant-1.6.x a simplemente ant ; quedando instalado en una ruta absoluta como : C:\ant\.

Configuración

Ant requiere configurarse con dos variables ambientales para su correcta operación :

• PATH : Define la ruta de acceso para los binarios del sistema; la modificación de esta variable permite accesar los ejecutables de Ant(ant) de cualquier directorio
• ANT_HOME: Define el directorio raíz donde esta instalado Ant

De acuerdo al Sistema Operativo Windows utilizado siga las siguientes instrucciones para definir la variable PATH y ANT_HOME :

• Windows NT, 2000 y XP
  • Seleccione Start- Settings -Control Panel y el icono System. En Windows NT, seleccione el Tab Environment; en Windows 2000/XP seleccione el Tab Advanced y posteriormente Variables de Entorno ("Environment Variables"). Localice "Path" en las variables del usuario ("User Variables") y variables de Sistema ("System Variables"). Debe agregar la ruta de acceso para Ant al final de esta variable, un valor típico es el siguiente :

  C:\ant\bin ( Donde C:\ es el directorio de instalación de Ant )

  • No altere los valores actuales de la variable PATH . La variable PATH es una serie de directorios separados por punto y comas (;).Windows localiza sus ejecutables a través de estas definiciones, por lo que debe tomar cautela con su modificación;.

  En el caso de la variable ANT_HOME, simplemente agregue su valor oprimiendo "Add" asignándole un valor de C:\ant.

  • Una vez modificado seleccione Set - OK - Apply
  • Los cambios a la variable PATH y ANT_HOME tomaran efecto en cada ventana de comando ("Command"), inmediatamente confirmada su modificación.
• Windows 98
  • Abra el archivo AUTOEXEC.BAT y agregue o modifique la declaración PATH y ANT_HOME como es descrito a continuación.
  • Para abrir el archivo AUTOEXEC.BAT, inicie el editor del sistema de Start - Run e introduzca sysedit. El editor del sistema mostrará diversas ventanas, seleccione aquella que despliegue AUTOEXEC.BAT
  • Localice la declaración PATH (Si no existe, agreguela); Al final de la variable agregue la ubicación del Ant como se muestra a continuación, de la misma manera agregue la declaración ANT_HOME :

  PATH C:\WINDOWS;C:\WINDOWS\COMMAND;C:\ANT\BIN ANT_HOME C:\ANT ( Donde C:\ es el directorio de instalación del Ant )

  • No altere los valores actuales de la variable PATH . La variable PATH es una serie de directorios separados por punto y comas (;).Windows localiza sus ejecutables a través de estas definiciones, por lo que debe tomar cautela con su modificación;.
  • Para que los cambios a la variable PATH y ANT_HOME tomen efecto, ejecute lo siguiente de una ventana de comando ("Command"): C:> c:\autoexec.bat; para verificar si han tomado efecto los cambios ejecute el siguiente comando: C:> path
• Windows ME
  • Del menú Start seleccione Choose programs - Accessories - System Tools - System information.Lo anterior abre una ventana titulada "Microsoft Help and Support". De esta ventana seleccionar: Menu Tools, y posteriormente seleccione System Configuration Utility.
  • Elija el Tab Environment, seguido seleccione PATH y oprima el botón de editar. Ahora agregue la ubicación del Ant, como fue descrito en las instalaciones anteriores de Windows 98-Windows 2000/NT y XP, realice los mismos pasos para la variable ANT_HOME
  • Para que los cambios a la variable PATH y CLASSPATH tomen efecto, requiere reinicializar el sistema.

Pruebas

Para verificar la correcta instalación de Ant realice la siguiente prueba:

• Invoque el comando ant de un directorio arbitrario (aleatorio) del sistema, si observa Buildfile: build.xml does not exist! ha configurado correctamente Ant, en caso contrario realice los pasos anteriores hasta que esta prueba sea ejecutada correctamente.