Diferencia entre revisiones de «Manual básico de ANT»
Contenido eliminado Contenido añadido
mSin resumen de edición |
|||
Línea 1:
{{fusionar|Apache Ant}}
{{a wikilibros}}
'''Apache Ant''' es una herramienta usada en programación para la realización de tareas mecánicas y repetitivas, normalmente durante la fase de compilador|compilación y construcción (build). Es similar a Make pero sin las engorrosas dependencias del sistema operativo.
Esta herramienta, hecha en [[Lenguaje de programación]] [[Lenguaje de programación Java|Java]], tiene la ventaja de no depender de las órdenes de Intérprete de comandos|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.
==
ANT fue creado por James Duncan Davidson mientras realizaba la transformación de un proyecto de Sun Microsystems en Open Source (concretamente la implementación de Servlets y JSP de Sun que luego se llamaría Jakarta Tomcat). En un entorno cerrado Make funcionaba correctamente bajo plataforma Solaris, pero para el entorno de open source, donde no era posible determinar la plataforma bajo la que se iba a compilar, era necesaria otra forma de trabajar. Así nació Ant como un simple intérprete que cogía un archivo XML para compilar Tomcat independientemente de la plataforma sobre la que operaba. A partir de este punto la herramienta fue adoptando nuevas funcionalidades y actualmente es un estándar en el mundo Java.
==
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:
ant
+--- bin // contains launcher scripts
Línea 27 ⟶ 30:
// - migrate your build files and get rid of 'deprecated' warning
// - ... and more ;-)
solo se necesitan los directorio bin y lib para ejecutar ANT.
==
Una vez obtenida la anterior distribución de ANT, se deben seguir los siguientes pasos:
Dependiendo del sistema operativo en el que nos encontremos tendremos los siguientes ejemplos de configuración:
Línea 61 ⟶ 64:
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).
Línea 68 ⟶ 73:
La estructura de un fichero buildfile podría ser la siguiente:
buildfile
+--- project // proyecto del buildfile
Línea 86 ⟶ 91:
|
+--- task_1 // tarea 1 de target_3
==
A continuación se muestra un ejemplo de una archivo build.xml:
<project name="MyProject" default="dist" basedir=".">
Línea 123 ⟶ 127:
</project>
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 name="src" location="src"/>
Lo siguiente que aparece en el ejemplo son los objetivos. El primero de ellos es '''init''':
<target name="init">
Línea 143 ⟶ 145:
</target>
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'''
<target name="compile" depends="init" description="compile the source " >
Línea 153:
</target>
En la declaración del objetivo podemos ver los siguiente atributos:
Línea 164 ⟶ 163:
El siguiente objetivo que compone el buildfile es '''dist'''.
<target name="dist" depends="compile" description="generate the distribution" >
<mkdir dir="${dist}/lib"/>
<jar jarfile="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}"/>
</target>
En este caso, '''dist''' depende del objetivo '''compile''' para ejecutarse, luego, antes de lanzar sus tareas se debe haber ejecutado '''compile'''.
Línea 175 ⟶ 172:
Por
<target name="clean" description="clean up" >
Línea 183 ⟶ 179:
</target>
Compuesto por
▲Compuesto por dos tareas '''delete'''. Simplemente borra los directorios temporales necesarios para la creación del jar.
Línea 201 ⟶ 197:
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.
==
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:
ant -buildfile buildfile_alt.xml
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:
ant clean
Línea 212 ⟶ 208:
En este caso se ignorara el objetivo indicado en la cabecera del proyecto.
==Referencias==
Para ampliar conocimientos en el uso de ANT, podéis consultar el siguiente enlace:
*http://ant.apache.org/manual/▼
|