El proyecto que usaremos como ejemplo en este taller es Java ID3 Tag Library, una utilidad para modificar la información de un archivo MP3. Sin embargo no la usaremos por eso sino porque es un proyecto open source, que contiene código suficiente para este propósito (ya lo veremos más adelante con Sonar), tiene un buen conjunto de pruebas unitarias (aunque lo de bueno o malo lo podremos evaluar con Emma) y es relativamente fácil ejecutarlas porque no requiere una conexión con base de datos.
La única diferencia de este proyecto con su distribución oficial (hasta el 14 de abril de 2010) es el archivo build.xml del que eliminé algunas de las tareas que iremos agregando durante el desarrollo del taller. Estas tareas corresponden entre otras a la ejecución de pruebas unitarias y análisis de cobertura con Emma.
Para configurar el proyecto debe descargar el IDE Eclipse desde http://www.eclipse.org/downloads/ (puede usar Eclipse IDE for Java EE Developers o Eclipse IDE for Java Developers) e instalarle el plugin Subclipse como se indica en su guía de instalación.
En la siguiente sección vamos a cargar el proyecto en Eclipse, subirlo al repositorio creado y como ejecutar algunas de sus tareas en ANT. Después de esto, Hudson podrá comenzar su trabajo.
1. Cree una carpeta que sirva como Workspace para el proyecto. Por ejemplo c:\WorkspaceEjemplo.
2. Descargue el código de ejemplo desde aquí.
3. Descomprima el código en la carpeta seleccionada como Workspace.
4. Ejecute Eclipse (en Windows sólo haga doble clic sobre el archivo eclipse.exe).
5. Cuando le pida un Workspace seleccione el que creó en el punto 1.
6. Cuando abra eclipse cierre la pantalla de bienvenida y en la sección Project Explorer presione el clic derecho y seleccione la opción import —> import.
7. En la ventana Import seleccione General —> Existing Projects into Workspace.
8. Seleccione Select root directory e ingrese la dirección del Workspace creado. En la sección Projects seleccione ProyectoEjemplo.
9. Para subir el proyecto al repositorio creado anteriormente de clic derecho sobre el nombre del proyecto y seleccione las opciones Team —> Share Project
10. Seleccione SVN y presione Next.
11. En Location ingrese la URL del repositorio creado, por ejemplo: https://localhost/svn/repoejemplo/ y presione Next.
12. Seleccione la opción Use specified folder name e ingrese la ruta trunk/ProyectoEjemplo.
13. Dado que usamos el protocolo HTTPS Eclipse mostrará un mensaje indicando que el emisor del certificado es desconocido. Seleccione Accept Permanently.
14. Cuando Eclipse le solicite el usuario y la contraseña ingrese los datos del usuario que creó para el repositorio, seleccione la opción Save Password y presione el botón OK para continuar.
15. Pase a la vista de sincronización para terminar de subir el proyecto.
16. Sobre el nombre del proyecto presione el clic derecho y seleccione la opción Team —> Commit….
17. Ingrese un comentario, presione OK y espere que finalice el commit.
18. Vuelva a la vista Java.
19. Verifique que el proyecto haya subido correctamente ingresando al trunk de su repositorio (por ejemplo https://localhost/svn/repoejemplo/trunk/). Debe ver el nuevo proyecto creado.
20. Si el proyecto está creado correctamente contínue con los siguientes pasos, sino, verifique de nuevo la información anterior hasta que lo corrija.
21. Vuelva a Eclipse y seleccione las opciones Window —> Show View —> Other.
22. Seleccione la opción Ant —> Ant y presione OK.
23. Deberá aparecer en la parte inferior del IDE la pestaña Ant. Arrastre hasta ella archivo build.xml.
24. Expanda el archivo y observe las tareas incluidas en el archivo: clean, cleanall, compile, init, jar. Estas son las tareas automatizadas actualmente y una construcción se puede hacer ejecutando secuencialmente cleanall y jar.
25. Ejecute la tarea cleanall con un doble clic. Esta tarea elimina los directorios innecesarios tras una compilación.
26. Vuelva a la pestaña Ant y ejecute la tarea jar. Esta tarea compila el código fuente y crea un nuevo archivo jar con el contenido binario. Si observa el directorio dist después de la ejecución verá el nuevo archivo creado.
27. La ejecución de tareas ant desde Eclipse es muy sencilla y hacerlo con comandos tampoco es difícil, además nos viene bien aprender a hacerlo para que las cosas con Hudson sean más fáciles. Abra una consola de comandos y vaya al directorio de su proyecto, por ejemplo C:\WorkspaceEjemplo\ProyectoEjemplo.
28. Ejecute la tarea cleanall con el comando ant cleanall ant busca por defecto el archivo build.xml.
29. Ejecute ahora la tarea jar con el comando ant jar.
30. Con un sólo comando se pueden ejecutar varias tareas secuencialmente. Pruebe ahora con ant cleanall jar
31. Si hasta ahora todo resultó como indica la guía, el software y proyecto están correctamente configurados y puede continuar con el taller.