Para crear un nuevo proyecto Maven desde la línea de comandos debemos situarnos en la carpeta donde queramos crearlo y hacer uso del plugin Archetype invocando su goal archetype:generate del siguiente modo:

mvn archetype:generate -DgroupId=org.memorobits \
-DartifactId=prueba \
-Dpackage=org.memorobits.prueba \
-Dversion=1.0-SNAPSHOT

El plugin admite una serie de parámetros que sirven para introducir los datos básicos que son necesarios para crear un proyecto. Si no indicamos estos parámetros se nos pedirá más adelante de forma interactiva que introduzcamos manualmente los valores correspondientes a cada uno de ellos.

Al ejecutar el comando se nos pedirá que seleccionemos de una lista un arquetipo (archetype) en el que se basará la creación del proyecto. Podemos decir que los arquetipos son plantillas que establecen una estructura de carpetas y archivos concreta junto a uno configuración predeterminada. De esta forma, al crear un nuevo proyecto no partimos de cero y tenemos una base adecuada en función del tipo de proyecto que vamos a emprender.

La lista de arquetipos disponibles se recuperará de los repositorios remotos que tengamos configurados, que con la configuración por defecto es un largo listado de 3142 elementos en el momento de escribir esto. Para seleccionar uno en concreto solo debemos introducir su número. Por defecto, si no indicamos ninguno y le damos a Enter se seleccionará el arquetipo maven-archetype-quickstart.

Tenemos la posibilidad de filtrar la lista de arquetipos disponibles para no tener que tratar un listado tan largo. Para ello, se utiliza un filtro de la forma [groupId:]artifactId, donde el valor groupId es opcional. Por ejemplo:

mvn archetype:generate -Dfilter=org.apache:struts

mostrará una lista de todos los arquetipos cuyo groupId contenga la cadena org.apache y cuyo artifactId contenga struts. El parámetro -Dfilter puede usarse junto a los parámetros vistos anteriormente.

Otra forma de filtrar es indicar el filtro [groupId:]artifactId en el prompt cuando se nos pide el número de arquetipo que queremos utilizar.

Seleccionar arquetipo

Si ya sabemos el arquetipo que vamos a utilizar es posible ejecutar el plugin evitando el modo interactivo. Para ello se debe indicar el flag -B, los datos identificativos del arquetipo a usar y los datos de configuración de nuestro proyecto:

mvn archetype:generate -B \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DarchetypeArtifactId=maven-archetype-quickstart \
-DarchetypeVersion=1.4 \
-DgroupId=org.memorobits \
-DartifactId=prueba \
-Dpackage=org.memorobits.prueba \
-Dversion=1.0-SNAPSHOT

El comando anterior creará un nuevo proyecto utilizando el arquetipo maven-archetype-quickstart y lo configurará con los datos indicados según las propiedades ya vistas, que son los datos mínimos requeridos. Otros arquetipos pueden necesitar que se indiquen otras propiedades adicionales.


El plugin Archetype es utilizado por varios IDEs (Eclipse, NetBeans, IDEA) para crear proyectos Maven. Estos entornos añaden la posibilidad de configurar los parámetros necesarios de creación mediante un entorno gráfico. Por otro lado, una vez creado un proyecto desde la línea de comandos en fácil importarlo en el IDE que deseemos.


Más información: Maven Archetype Plugin