Configuración del Proyecto Ejemplo

El proyecto que usaremos como ejemplo en este taller es Java ID3 Tag Library, una utilidad que me gusta mucho para modificar la información de un archivo MP3. Sin embargo no la usaremos sólo por esto, la tomé como ejemplo 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.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

7. En la ventana Import seleccione General —> Existing Projects into Workspace.

Configuración del Proyecto Ejemplo

8. Seleccione Select root directory e ingrese la dirección del Workspace creado. En la sección Projects seleccione ProyectoEjemplo.

Configuración del Proyecto Ejemplo

9. Para subir el proyecto al repositorio creado anteriormente de clic derecho sobre el nombre del proyecto y seleccione las opciones Team —> Share Project

Configuración del Proyecto Ejemplo

10. Seleccione SVN y presione Next.

Configuración del Proyecto Ejemplo

11. En Location ingrese la URL del repositorio creado, por ejemplo: https://localhost/svn/repoejemplo/ y presione Next.

Configuración del Proyecto Ejemplo

12. Seleccione la opción Use specified folder name e ingrese la ruta trunk/ProyectoEjemplo.

Configuración del Proyecto Ejemplo

13. Dado que usamos el protocolo HTTPS Eclipse mostrará un mensaje indicando que el emisor del certificado es desconocido. Seleccione Accept Permanently.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

15. Pase a la vista de sincronización para terminar de subir el proyecto.

Configuración del Proyecto Ejemplo

16. Sobre el nombre del proyecto presione el clic derecho y seleccione la opción Team —> Commit….

Configuración del Proyecto Ejemplo

17. Ingrese un comentario, presione OK y espere que finalice el commit.

Configuración del Proyecto Ejemplo
Configuración del Proyecto Ejemplo

18. Vuelva a la vista Java.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

22. Seleccione la opción Ant —> Ant y presione OK.

Configuración del Proyecto Ejemplo

23. Deberá aparecer en la parte inferior del IDE la pestaña Ant. Arrastre hasta ella archivo build.xml.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

25. Ejecute la tarea cleanall con un doble clic. Esta tarea elimina los directorios innecesarios tras una compilación.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

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.

Configuración del Proyecto Ejemplo

28. Ejecute la tarea cleanall con el comando ant cleanall ant busca por defecto el archivo build.xml.

Configuración del Proyecto Ejemplo

29. Ejecute ahora la tarea jar con el comando ant jar.

Configuración del Proyecto Ejemplo

30. Con un sólo comando se pueden ejecutar varias tareas secuencialmente. Pruebe ahora con ant cleanall jar

Configuración del Proyecto Ejemplo

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.

Si no se indica lo contrario, el contenido de esta página se ofrece bajo Creative Commons Attribution-ShareAlike 3.0 License