Instalación y primeros pasos con Maven

Para instalar maven, seguiremos los siguientes pasos:

Descargar Maven

Nos descargamos la última versión de Maven (en el ejemplo al 3.0.5) y lo descomprimimos en una carpeta, por ejemplo: “c:\maven\apache-maven-3.0.5” en Windows o  “/usr/local/apache-maven-3.0.5" en Linux. Hay que tener instalado una JDK, no es sufuciente con tener JRE. En el siguiente post se puede ver como hacerlo:

Instalar Jdk  en Windows y en Ubuntu Linux

Hay cierta configuración que está en el fichero settings.xml y que necesitaremos más adelante, ese fichero está en la carpeta “apache-maven-3.0.5\conf”

Configuración de las variables de entorno

Vamos a ver a modo de ejemplo como quedan en Windows:

En Ubuntu Linux, quedaría así:

Comprobar la instalación

Abrimos un terminal y escribimos:

Si lo tenemos correctamente instalado, nos mostrará la versión.

Crear el primer arquetipo

Vamos a crear el primer proyecto de prueba, por linea de comandos, para ver cómo funciona. No entraré en detalles, más adelante se explicarán los comandos y veremos cómo utilizar Maven dentro del entorno de desarrollo Eclipse. Abrimos un terminal, nos colocamos en c:\ y escribimos lo siguiente:

Como estábamos en C:\ cuando hemos ejecutado el comando, nos ha creado el proyecto “C:\my-app” con la siguiente estructura:

Proyecto my-app

Proyecto my-app

Se pueden observar algunas características de la estructura de directorios o paquetes que utiliza Maven. La carpeta “src” contiene los fuentes, tanto de prueba (carpeta test), como los de la aplicación (carpeta main).

La estructura estándar de Maven es la siguiente:

Estructura de directorios Maven

Estructura de directorios Maven

El fichero pom.xml

Si volvemos a la carpeta “C:\my-app” observaremos que se nos ha creado un fichero pom.xml, vamos a ver su contenido:

Empaquetar el proyecto

Compilar y empaquetar el proyecto, nos colocamos en el directorio donde se encuentre el pom.xml:

A diferencia del “goal” genrate anterior, lo que hemos ejecutado es una “phase”, que es una fase en el ciclo de vida del proyecto. Cuando se ejecuta una fase, se lanza esa fase y las anteriores. Si se compila, primero se valida. Estas son las fases más comunes:

  • validate: Valida que el proyecto es válido y contiene los elementos necesarios
  • compile: Compila el código
  • test: Si utiliza un “unit testing framework” lo ejecuta. Estos test no necesitan desplegar la aplicación
  • package: Compila y empaqueta el código (como jar, etc.)
  • integration-test: Si es necesario despliega el paquete en un entorno de integración y ejecuta los test
  • verify: Verifica que el paquete es válido y cumple los criterios de calidad
  • install: Instala los paquetes en el repositorio local para resolver las dependencias en otros proyectos locales
  • deploy: Hecho en un ambiente de integración o liberación, copias del paquete al repositorio remoto para compartir con otros desarrolladores y proyectos

Además existen otras dos fases:

  • clean: Limpia los artefactos creados en compilaciones anteriores
  • site: Genera documentación del sitio para este proyecto

Nos ha generado una carpeta target, que contiene las clases compiladas así como un paquete .jar con nuestro código

Detalle de la carpeta target

Detalle del target generado

El esperado “Hello World!”

Para probar el .jar que acabamos de generar

Y ya tenemos nuestro primer “Hello World!”

Primer Hello World! con Maven

Primer Hello World! con Maven

Crear un site

Para terminar, vamos a generar el “Site”, que es una aplicación html que contiene la información de nuestro proyecto. Si se configura bien, podemos incluir en él informes, el javadoc de nuestras clases, métricas, etc. Por el momento vamos a generarlo sin configurar nada:

Chupado, ¿verdad? Ya tenemos nuestro site:

Site generado

Detalle del site generado

Si abrimos index.html, tendremos un site similar a este:

Site generado

Site generado

Aquí finalizamos este post, en el que hemos dado los primeros pasos. En el siguiente post, instalaremos los plugins adecuados para ejecutar Maven en Eclipse y seguiremos aprendiendo sobre esta fantástica herramienta. Siguiente post: Maven en Eclipse

3 comentarios:

  1. Cuando he instalado maven en windows me ha saltado un error al intentar crear el arquetipo diciendo esto:
    https://imagebin.ca/v/2hmc9lYxTvic
    ¿Alguna idea?

  2. Al intentar crear el proyecto me lanza error.
    [ERROR]
    [ERROR] To see the full stack trace of the errors, re-run Maven with the -e swit
    ch.
    [ERROR] Re-run Maven using the -X switch to enable full debug logging.
    [ERROR]
    [ERROR] For more information about the errors and possible solutions, please rea
    d the following articles:
    [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureExc
    eption

    alguna idea de que es y como solucionarlo?
    Saludos.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *