Primeros pasos con Maven - Historial de revisiones

Resinas en 07:58 27 nov 2017

2017-11-27T07:58:41Z

Resinas en 07:10 24 nov 2017

2017-11-24T07:10:23Z

Resinas en 06:53 24 nov 2017

2017-11-24T06:53:42Z

Resinas en 06:42 24 nov 2017

2017-11-24T06:42:14Z

Resinas en 16:32 23 nov 2017

2017-11-23T16:32:03Z

Ajramirez en 14:30 24 nov 2015

2015-11-24T14:30:47Z

Josandluq: /* Cambiar la configuración de usuario del repositorio local para no contener espacios */

2015-11-24T08:29:25Z

‎Cambiar la configuración de usuario del repositorio local para no contener espacios

Ajramirez: Página creada con «= Descarga e instala Maven= Descargue Maven y siguen las instrucciones de instalación. Tras instalar, ejecute mvn --version Si todo est...»

2015-11-24T00:39:21Z

Página creada con «= Descarga e instala Maven= Descargue Maven y siguen las instrucciones de instalación. Tras instalar, ejecute <source lang="bash"> mvn --version </source> Si todo est...»

Página nueva

= Descarga e instala Maven=
Descargue Maven y siguen las instrucciones de instalación.
Tras instalar, ejecute

<source lang="bash">
mvn --version
</source>

Si todo está correcto, debería observar algo como lo que sigue:

<source lang="bash">
Apache Maven 3.3.3
Maven home: C:\...\apache-maven-3.3.3\bin\..
Java version: 1.8.0_25, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_25\jre
Default locale: es_ES, platform encoding: Cp1252
OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos"
</source>

= Cambiar la configuración de ''usuario'' del repositorio local para no contener espacios =
Hay tres niveles de configuración: instalación (mavenInst/conf/settings.xml), usuario (userHome/.m2/settings.xml), proyecto (projectHome/pom.xml)

Por defecto, el repositorio local está en ${user.home}.m2/repository. Si se desea cambiar (para no contener espacios), en la carpeta ${user.home}.m2 crear un archivo settings.xml con el siguiente contenido.
<source lang="xml">
<settings xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
<localRepository> nuevaRuta <localRepository>
</settings>

</source>

=Generar el primer proyecto. El archetype utilizado por defecto es el maven-archetype-quickstart=
<source lang="bash">
mvn -B archetype:generate -DgroupId=es.egc.app -DartifactId=proy1
</source>
ó
<source lang="bash">
mvn -B archetype:generate -DgroupId=es.egc.app -DartifactId=proy1 -DarchetypeArtifactId=maven-archetype-quickstart
</source>

Hacer un <code>tree</code> de la carpeta generada debido al arquetipo seleccionado. Verá:
* src/main contiene el código fuente
* src/test contiene el código para testeo
* Dentro del pom.xml
** El packing por defecto es <code>jar</code>.
** Se incluye la dependencia a JUnit

=Ciclo de vida, fases y objetivos=

<source lang="bash">
mvn fase1..faseN plugin1:objetivo1 pluginN:objetivoN
</source>
*Las fases se ejecutan en el orden en que son invocados. Todas las fases previas definidas en el lifecycle, son ejecutadas también.
*Hay tres lifecycle: clean, default, site.
*Dependiendo del tipo de packing del proyecto, cada fase es mapeada a diferentes objetivos de plugins (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference Lifecycles]). Estas son las posibles fases:

'''validate''', initialize, generate-sources, process-sources, generate-resources, process-resources, '''compile''', process-classes, generate-test-sources, process-test-sources, generate-test-resources, process-test-resources, test-compile, process-test-classes, '''test''', prepare-package, '''package''', pre-integration-test, integration-test, post-integration-test, verify, '''install''', '''deploy''', pre-clean, '''clean''', post-clean, pre-site, '''site''', post-site, site-deploy

Maven utiliza la convención de ficheros para encontrar los diferentes elementos del proyecto (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html Ficheros])

=Compilar el proyecto=

<source lang=bash>
mvn compile
</source>
Buscará los fuentes en src/main

=Modificar el proyecto=
*Introdir método en la clase App.java
<source lang=bash>
static int getVal(){
return 1;
}
</source>

*Modificar test de la clase AppTest.java

<source lang=bash>
…
assertTrue(App.getVal()==1);
…

</source>

=Testear el proyecto=

<source lang=bash>
mvn test
</source>
Buscará los fuentes en src/test

=Introducir error en el test y tratar de generar el .jar en la carpeta target=
<source lang=bash>
mvn package
</source>

@@ Línea 39: / Línea 39: @@
 </source>
-La carpeta generada debido al arquetipo seleccionado tendrá el siguiente contenido:
+Maven utiliza la convención de ficheros para encontrar los diferentes elementos del proyecto (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html Ficheros]). De este modo, todos los proyectos que usan maven deben seguir la misma estructura. Esto es conveniente pues asegura que cualquier desarrollador puede entender la estructura de directorios de un proyecto con mayor facilidad.
 * src/main contiene el código fuente
 * src/test contiene el código para testeo
-* Dentro del pom.xml
+* un fichero pom.xml con la configuración del proyecto en Maven. El contenido de este fichero será el siguiente:
-** El packing por defecto es <code>jar</code>.
-** Se incluye la dependencia a JUnit
+<source lang="xml">
-Maven utiliza la convención de ficheros para encontrar los diferentes elementos del proyecto (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html Ficheros]). De este modo, todos los proyectos que usan maven deben seguir la misma estructura. Esto es conveniente pues asegura que cualquier desarrollador puede entender la estructura de directorios de un proyecto con mayor facilidad.
+Lo que define este pom.xml es lo siguiente:
 Maven ofrece dos funcionalidades básicas:
 * Gestión de la construcción de un proyecto

@@ Línea 56: / Línea 56: @@
 =Plugins y objetivos=
-Un concepto clave de Maven son los plugins. Toda la funcionalidad de Maven se realiza a través de plugins. Hay plugins encargados de gestionar las dependencias, plugins encargados de compilar código Java, plugins encargados de ejecutar pruebas de JUnit, plugins encargados de empaquetar el código en un fichero JAR, etc. Los plugins ofrecen su funcionalidad a través de lo que se conoce como objetivos. Por ejemplo, el plugin encargado de la compilación de código ([https://maven.apache.org/plugins/maven-compiler-plugin/ compiler]) tiene dos goals:
+Un concepto clave de Maven son los plugins. Toda la funcionalidad de Maven se realiza a través de plugins. Hay plugins encargados de gestionar las dependencias, plugins encargados de compilar código Java, plugins encargados de ejecutar pruebas de JUnit, plugins encargados de empaquetar el código en un fichero JAR, etc. Los plugins ofrecen su funcionalidad a través de lo que se conoce como objetivos (goals). Por ejemplo, el plugin encargado de la compilación de código ([https://maven.apache.org/plugins/maven-compiler-plugin/ compiler]) tiene dos objetivos:
 * compiler:compile que compila el código fuente del proyecto, que está en la carpeta main/src/java
 * compiler:testCompile que compila el código de las pruebas del proyecto, que está en la carpeta main/src/test
-Otro ejemplo puede ser el plugin encargado de crear un paquete JAR ([https://maven.apache.org/plugins/maven-jar-plugin/ jar]), que tiene también dos goals:
+Otro ejemplo puede ser el plugin encargado de crear un paquete JAR ([https://maven.apache.org/plugins/maven-jar-plugin/ jar]), que tiene también dos objetivos:
 * jar:jar que crea un fichero jar con el código del proyecto y el contenido de la carpeta src/main/resources
 * jar:test-jar que crea un fichero jar con el código de las pruebas del proyecto y el contenido de la carpeta src/test/resources
-Los plugins se pueden configurar en el fichero pom.xml del proyecto y los goals de un plugin se pueden invocar por línea de comandos de la siguiente forma:
+Los plugins se pueden configurar en el fichero pom.xml del proyecto y los objetivos de un plugin se pueden invocar por línea de comandos de la siguiente forma:
 <source lang="bash">
@@ Línea 70: / Línea 70: @@
 </source>
-Los goals se ejecutan siguiendo el orden en que son invocados. Por tanto se podría hacer:
+Los objetivos se ejecutan siguiendo el orden en que son invocados. Por tanto se podría hacer:
 <source lang="bash">
@@ Línea 99: / Línea 99: @@
 En [https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference Lifecycles] se recogen todas las fases definidas en cada ciclo de vida y una breve descripción de cada una de ellas.
-Aunque cada fase es responsable de un paso específico en el ciclo de vida al que corresponda, la manera en la que se realizan esas responsabilidades puede variar en función del tipo de proyecto (ej. si es un proyecto web, una aplicación de consola, una librería, una aplicación de móviles...), del tipo de empaquetado utilizado (ej. si es WAR, JAR, EAR...), etc. Para configurar qué se hace en cada fase, se enlazan goals de plugins con las fases del ciclo de vida. De este modo, ejecutar una fase del ciclo de vida equivale a ejecutar los goals de plugins vinculados a esa fase. Dependiendo del tipo de packaging del proyecto, cada fase está vinculada a diferentes goals de plugins. Además, esa vinculación se puede configurar a través del fichero pom.xml.
+Aunque cada fase es responsable de un paso específico en el ciclo de vida al que corresponda, la manera en la que se realizan esas responsabilidades puede variar en función del tipo de proyecto (ej. si es un proyecto web, una aplicación de consola, una librería, una aplicación de móviles...), del tipo de empaquetado utilizado (ej. si es WAR, JAR, EAR...), etc. Para configurar qué se hace en cada fase, cada fase se enlaza con uno o más objetivos de plugins. De este modo, ejecutar una fase del ciclo de vida equivale a ejecutar los objetivos de plugins vinculados a esa fase. Algunas fases tienen ya vinculadas objetivos de plugins por defecto. Esta vinculación varía dependiendo del tipo de packaging del proyecto. Por ejemplo, para un packaging jar, las fases con objetivos de plugin vinculados son las siguientes (puedes ver la lista completa en [https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Built-in_Lifecycle_Bindings Built-in Lifecycle Bindings]):
 <source lang="bash">
-mvn fase1..faseN plugin1:objetivo1..pluginN:objetivoN
+mvn clean dependency:copy-dependencies package
 </source>
-=Compilar el proyecto=
+==Compilar el proyecto==
 <source lang=bash>
@@ Línea 116: / Línea 168: @@
 Buscará los fuentes en src/main
-=Modificar el proyecto=
+==Modificar el proyecto==
-*Introdir método en la clase App.java
+*Introducir método en la clase App.java
 <source lang=bash>
 static int getVal(){
@@ Línea 133: / Línea 185: @@
 </source>
-=Testear el proyecto=
+==Testear el proyecto==
 <source lang=bash>
@@ Línea 140: / Línea 192: @@
 Buscará los fuentes en src/test
-=Introducir error en el test y tratar de generar el .jar en la carpeta target=
+==Introducir error en el test y tratar de generar el .jar en la carpeta target==
 <source lang=bash>
 mvn package
 </source>

@@ Línea 1: / Línea 1: @@
 = Descarga e instala Maven=
-Descargue Maven y siguen las instrucciones de instalación.
+Descargue Maven y siguen las instrucciones de instalación (para Windows puedes usar [https://www.mkyong.com/maven/how-to-install-maven-in-windows/ estas]).
 Tras instalar, ejecute

@@ Línea 18: / Línea 18: @@
 </source>
-= Cambiar la configuración de ''usuario'' del repositorio local para no contener espacios =
+= Cambiar la configuración de ''usuario'' del repositorio local para no contener espacios (opcional) =
 Hay tres niveles de configuración: instalación (mavenInst/conf/settings.xml), usuario (userHome/.m2/settings.xml), proyecto (projectHome/pom.xml)
-Por defecto, el repositorio local está en ${user.home}.m2/repository. Si se desea cambiar (para no contener espacios), en la carpeta ${user.home}.m2 crear un archivo settings.xml con el siguiente contenido.
+Por defecto, el repositorio local está en ${user.home}/.m2/repository. Si se desea cambiar (para no contener espacios), en la carpeta ${user.home}/.m2 crear un archivo settings.xml con el siguiente contenido.
 <source lang="xml">
 <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ Línea 39: / Línea 39: @@
 </source>
-Hacer un <code>tree</code> de la carpeta generada debido al arquetipo seleccionado. Verá:
+La carpeta generada debido al arquetipo seleccionado tendrá el siguiente contenido:
 * src/main contiene el código fuente
 * src/test contiene el código para testeo
@@ Línea 46: / Línea 46: @@
 ** Se incluye la dependencia a JUnit
-=Ciclo de vida, fases y objetivos=
+Maven utiliza la convención de ficheros para encontrar los diferentes elementos del proyecto (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html Ficheros]). De este modo, todos los proyectos que usan maven deben seguir la misma estructura. Esto es conveniente pues asegura que cualquier desarrollador puede entender la estructura de directorios de un proyecto con mayor facilidad.
 <source lang="bash">
@@ Línea 52: / Línea 105: @@
 </source>
 *Las fases se ejecutan en el orden en que son invocados. Todas las fases previas definidas en el lifecycle, son ejecutadas también.
-*Hay tres lifecycle: clean, default, site.
+* (cf. [https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference Lifecycles]). Estas son las posibles fases:
 =Compilar el proyecto=

@@ Línea 25: / Línea 25: @@
 <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
-   <localRepository> nuevaRuta <localRepository>
+   <localRepository> nuevaRuta </localRepository>
 </settings>