Gua de ejercicio Testing y Calidad

Tareas que se pueden realizar en Ant

a.- Creacin de directorios
<target name="crear" depends="eliminar">
<mkdir dir="bin" />
<mkdir dir="lib" />
<mkdir dir="out-put" />
<mkdir dir="src1" />
</target>

b.- Borrar directorios

<target name="eliminar">
<delete dir="bin" />
<delete dir="lib" />
<delete dir="out-put" />
<delete dir="src1" />
</target>

c.- Copiar directorios

<target name="copiar" depends="crear">
<copydir src="/Users/gianninacosta/Documents/workspace/ejemplo/src"
dest="/Users/gianninacosta/Documents/workspace/ejemplo/src1">
</copydir>
</target>

d.- Compilar Proyecto

<target name="compila" description="crear">
<echo>compilar programa</echo>
<javac includeantruntime="false" srcdir="/Users/gianninacosta/Documents/workspace/ejemplo/src/ejemplo"
destdir="/Users/gianninacosta/Documents/workspace/ejemplo/out-put/" />
</target>

e.- Documentar proyecto

<target name="docs" depends="compila">
<javadoc packagenames="src"
sourcepath="/Users/gianninacosta/Documents/workspace/ejemplo/src/ejemplo"
destdir="/Users/gianninacosta/Documents/workspace/ejemplo/lib/">
<!-- incluye todos los archivos que se desean documentar -->
<fileset dir="/Users/gianninacosta/Documents/workspace/ejemplo/src/ejemplo">
<include name="**" />
</fileset>
</javadoc>
</target>

f.- Empaquetar Proyecto

<target name="comprime" description="compila">
<echo>crear archivo jar</echo>
<jar jarfile="/Users/gianninacosta/Documents/workspace/ejemplo/lib/resultado.jar"
basedir="/Users/gianninacosta/Documents/workspace/ejemplo/src/ejemplo"/>
</target>

Ejecucin automtica de un constructor Ant

Se puede realizar constructores automticos de Ant, que es muy til para combinar las
tareas, ejecutndolas antes o despus, con respecto a las tareas llevadas a cabo por el
constructor interno del IDE Eclipse.
Para esto trabajaremos con el build.xml construido.
Seguir los siguientes pasos para construir constructor por defecto :
1- En el Package Explorer hacemos click derecho sobre nuestro proyecto y
seleccionamos Properties.

2- Se abrir la ventana de propiedades de nuestro proyecto y seleccionamos la seccin

Builders. Aqu se ven los constructores nuestro proyecto, en estos momentos el nico

constructor ser el constructor interno del IDE. Ahora agregaremos nuestro constructor
Ant, que hemos realizado, a la lista seleccionando New.

3- En una nueva ventana que veremos seleccionamos Ant Builder y luego Ok.

4- Ac es donde se realiza la configuracin de la ejecucin de nuestro constructor Ant

para la construccin del proyecto
Ir a la pestaa Main:
a. Especificar un nombre para el constructor, en donde dice Name: introducimos Mi
Constructor, luego en Build file: especificamos la ruta del script build.xml que
podemos buscarla rpidamente con el botn Browse Workspace al lado, mas abajo
en Base directory: especificamos el directorio raz de nuestro proyecto que podemos
buscarlo rpidamente con el botn Browse Workspace al lado. Luego de todo esto
seleccionamos la pestaa Refresh.

b. Por defecto los constructores de proyecto no actualizan luego de finalizar. Para poder
estar al tanto de lo que sucede en nuestro IDE, seleccionaremos la casilla Refresh
resources upon completion. Y luego para ser mas especficos, seleccionaremos la
opcin The project containing the selected resource para que se actualicen solo los
recursos relacionados a nuestro constructor Ant, esto ultimo lo hacemos mas que nada
por motivos de eficiencia. Pasamos a la siguiente pestaa Targets.

c- Nos corresponde decidir bajo que eventos del IDE queremos que nuestro constructor
sea ejecutado y que targets de este sern ejecutados.
Los eventos posibles son:

After a Clean: Sucede luego de que ordenamos una limpieza con la opcin Clean.
Manual Build: Sucede cuando ordenamos la construccin del proyecto.
Auto Build: Sucede en forma automtica, si esta activada la opcin de Build
Automatically. Por ejemplo se ejecuta la construccin del proyecto luego de guardar
cambios. Esta opcin puede afectar el rendimiento.
During a Clean: Sucede mientras se realiza una limpieza ordenada con la opcin
Clean.
Los eventos activadas por defecto son los dos primeros, y el target seleccionado es
el main de nuestro build.xml por lo que dir <default target selected>.

Como el constructor interno del IDE realiza la compilacin, y nuestrobuild.xml tambin,

seleccionaremos para cada evento activado (After a Clean y Manual Build) solo el
target empaqueta para que no se repita dos veces la compilacin. Esto lo podemos
hacer en el botn Set Targets para cada evento, se nos abre una pequea ventana
en la que seleccionamos nicamente empaqueta y guardamos con Ok.

d- La configuracin esta terminada. Guardamos todos los cambios en Apply y

terminamos con Ok.

En la ventana de propiedades de nuestro proyecto podemos ver al constructor interno

del IDE junto a nuestro constructor Ant, los dos activados. El orden en el que se
encuentran listados determina el orden de ejecucin, lo cual se puede modificar con los
botones Up y Down. As como se pueden agregar constructores tambin se pueden
remover, excepto que no podemos remover el constructor interno del IDE aunque lo

que si podemos hacerle es desactivarlo. Esto ultimo no es recomendable ya que el

constructor interno esta vinculado a otras tareas importantes.
Regresamos al espacio de trabajo con Ok.

Ya se puede probar el funcionamiento automtico de nuestro constructor Ant como

constructor de proyecto. Realizamos una limpieza de nuestro proyecto seleccionando
en el men Poject -> Clean, y luego veremos en la consola del IDE una salida de
datos que nos demuestra que se ah ejecutado nuestro build.xml. Lo mismo debera de
suceder si hacemos algn pequeo cambio en algn archivo de nuestro proyecto para
poder guardar los cambios y luego ordenamos la construccin en el men Project ->
Build project.

Aadir Tareas al constructor Ant generado por el IDE

No se pueden agregar tareas en el propio build.xml ya que este es regenerado
automticamente.
Para poder realizar una nueva tarea se debe crear un nuevo archivo xml llamado en
este caso: build-user.xml (este nuevo script de Ant contendra la tarea que queremos
agregar a la funcionalidad del build.xml generado por el IDE).

Los pasos son:

1- Crear archivo build-user.xml.
2- Como el archivo no se llama build.xml el editor Ant del IDE no lo reconocer como
script de Ant.
1.- Posicionarse en el Script con doble click
a. En la pestaa Package Explorer hacemos click derecho sobre nuestro script builduser.xml y seleccionamos Open With -> Other.

b- Tendremos una lista de editores, elegimos Ant Editor y aceptamos con Ok.

3- Ahora que tenemos abierto build-user.xml con el editor Ant, introducimos el

siguiente cdigo y guardamos.
1 <?eclipse.ant.import?>
2 <project default="extra">

3
4
5
6
7

<target name="extra" description="Una tarea extra definida por el usuario.">

<echo message="Esta es una tarea extra!" />
</target>
</project>

8
Notar que el script debe de comenzar con <?eclipse.ant.import?>.
4- Para que el build.xml del IDE importe nuestro script Ant necesitamos exportar el
proyecto con Ant nuevamente de la misma forma que hicimos antes, esto regenerara
el build.xml. Bsicamente lo que suceder es que el IDE buscara en el mismo directorio
donde generara su build.xml otros archivos de extensin .xml que comiencen con la
lnea: <?eclipse.ant.import?>. Despus se debe incorporar dentro del cdigo del
nuevo build.xml generado la lnea: <import file=build-user.xml/>.

Y si por ejemplo ahora queremos ejecutar este build.xml de manera configurada (Run
as), tendremos para elegir todos los targets generados por el IDE en los
cuales build es el predeterminado, y adems tendremos los targets importados de
nuestros scripts que en este caso lo nico que haba definido en mi build-user.xml era
el target extra que lo nico que hace es mostrar un mensaje en consola.