miércoles, 11 de junio de 2008

MAVEN

En eclipse, ruta: window/preferences/java/Installed JREs añadimos el JRE home directory "C:\Archivos de programa\Java\jdk1.6.0_06" y lo activamos por defecto. Aceptamos

Nos descargamos el archivo apache-maven-2.0.9-bin.zip y extraemos su contenido en archivos de programa/java (se puede poner donde queramos). Creamos una nueva variable de entorno llamado JAVA_HOME cuya ruta es C:\Archivos de programa\Java\jdk1.6.0_06. Y en la variable Path insertamos otra ruta: C:\Archivos de programa\Java\apache-maven-2.0.9\bin. Aceptamos.

En la ruta "C:\Documents and Settings\Administrador\.m2" añadimos el repositorio descargado del foro de eticom. ESTE ES NUESTRO REPOSITORIO LOCAL.

En consola escribimos "mvn --version"para ver que todo ha ido bien y ver nuestra versión.

Para crear un proyecto nos vamos a la consola, nos colocamos en C:\workspace> y escribimos:

mvn archetype:create -DgroupId=eticom -DartifactId=rafa

...y nos crea un proyecto llamado rafa en el workspace, con toda su estructura (src y test), con sus paquetes y clases de prueba. En palabras de Juan.. "una estructura de directorios estandar (incluyendo tests) y un archivo maven de proyecto llamado pom.xml donde se configuran las dependencias y posibles targets para este proyecto
".
archetype:create es el comando de maven que crea el proyecto, -DgroupId=eticom son los paquetes de nuestro proyecto, y -DartifactId es el nombre del proyecto.

Para realizar operaciones con el proyecto, nos metemos en su directorio y ejecutamos los comandos, tales como:

COMPILAR: mediante el comando "mvn compile", que crea un directorio target justo donde está el archivo pom.xml, y un subdirectorio llamado classes, donde se incluirán todos los archivos .class generados por nuestro proyecto.

GENERAR .JAR: ejecutando "mvn package", si es necesario compilará y después pasará las clases de test de JUnit, y si no tiene errores, incluirá en el directorio target, nuestro archivo .jar.

INSTALAR EL .JAR DE NUESTRO PROYECTO EN EL REPOSITORIO: mediante la línea de comando "mvn install"

REPOSITORIOS de ficheros .jar (los oficiales de maven): maven, a medida que los necesita, se los va descargando en el directorio local "C:\Documents and Settings\Administrador\.m2\", y si los vuelve a necesitar, ya tira de aquí.

DEPENDENCIAS: si queremos bajarnos unos .jar por nosotros mismos, hay que editar el archivo "pom.xml"; en la etiqueta 'dependency' por defecto viene groupId="junit", artifactId="junit", version=3.8.1 y scope=test. Si lo que buscamos es descargarnos el 'log4j' iríamos a los.jar oficiales de Maven, y navegamos hasta llegar al archivo .pom del paquete 'log4j' (aquí el de la versión 1.2.9); finalmente añadimos la dependencia, del mismo modo que el 'junit'.
En Eclipse, menú contextual sobre pom.xml/Maven/Add dependecy. En Query escribimos la dependencia que queramos. Si escribimos TestNG aparecerán todas ellas, en sus distintas versiones; nosotros escogeremos la que utilicemos en nuestro proyecto.

JAVADOC: el javadoc o documentación se crea ejecutando la siguiente línea de comando "mvn javadoc:javadoc"

INTEGRACIÓN con Eclipse: para integrar nuestro proyecto con eclipse, ejecutamos el comando "mvn eclipse:eclipse", con lo que la estructura del mismo se amolda a uno de eclipse. Ahora hay que crear una variable interna para acceder a las librerías de Maven:
mvn -Declipse.workspace=<path_al_workspace_de_eclipse> eclipse:add-maven-repo (el path a mi workspace es C:\workspace).

Ahora vamos a abrir el proyecto creado (llamado "rafa") en el eclipse, lo cual se ahce por la ruta File/new Java proyect/from existing source, entonces seleccionamos la ruta donde se encuentre y le damos el mismo nombre (rafa).

Ahora toca instalar el plugin (instrucciones)... En el menú de Eclipse: Windows/Software Updates/Find and Install/Search for new features to install/siguiente/New remote site, y le añadimos Maven como name y la dirección siguiente:
http://m2eclipse.sonatype.org/update/. Le damos a OK y lo instala. Antes de acabar, seleccionamos el Maven, pichamos en el + para que abra el árbol y seleccionamos todos menos el que está en medio, ya que da conflicto. Ahora, para ver la ventana de Maven en Eclipse pinchamos Window/Show view/Other/Maven Indexes. ENHORABUENA! YA TIENES INSTALADO EL PLUGIN DE MAVEN!

links:
primeros pasos

1 comentario:

Juan Antonio Ruz dijo...

he estado mirando las entradas y sigue todo muy bien estructurado y organizado lo cual es significativo que lo estás entendiendo aunque al ponerlo en producción siempre salgan problemas (esto es inevitable hasta que adquirimos la experiencia con la herramienta en cuestión).
saludos!