Especificación de la versión de Java en Maven: diferencias entre las propiedades y el complemento del compilador

178

No tengo mucha experiencia con Maven y, mientras experimentaba con proyectos de varios módulos, comencé a preguntarme cómo puedo especificar la versión de Java para todos mis módulos secundarios en Maven Pom. Hasta hoy estaba usando solo:

<properties>
    <java.version>1.8</java.version>
</properties>

pero al investigar descubrí que también puedes especificar la versión de Java en el complemento del compilador Maven, así:

<plugins>
    <plugin>    
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
        </configuration>
    </plugin>
</plugins>

Y luego envuelva esto en la etiqueta de administración de complementos para permitir el uso de niños poms de esto. Entonces, la primera pregunta es ¿cuáles son las diferencias entre la configuración de la versión de Java en las propiedades y en el complemento del compilador Maven?

No pude encontrar una respuesta clara, pero en el proceso de investigación descubrí que también puedes especificar la versión de Java de esta manera:

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

lo que sugiere que el complemento del compilador está ahí incluso si no lo declaro explícitamente. Ejecutar salidas de paquete mvn con

maven-compiler-plugin:3.1:compile (default-compile) @ testproj ---

y algunos otros complementos que no he declarado. Entonces, ¿son esos complementos predeterminados, parte oculta de maven pom? ¿Hay alguna diferencia entre establecer el origen / destino en las propiedades y en el elemento de configuración del complemento maven?

Algunas otras preguntas son: ¿de qué manera se debe utilizar (y cuándo, si no son iguales)? ¿Cuál es el mejor para un proyecto de varios módulos y qué sucede si la versión de Java especificada en Pom es diferente de la versión apuntada en JAVA_HOME?

Plebejusz
fuente

Respuestas:

288

¿Cómo especificar la versión JDK?

1) <java.version>no se hace referencia en la documentación de Maven.
Es una especificidad de arranque de primavera.
Permite configurar la versión de Java de origen y de destino con la misma versión como esta para especificar Java 1.8 para ambos:

<properties>
     <java.version>1.8</java.version>
</properties>   

Siéntase libre de usarlo si usa Spring Boot.

2) Usar maven-compiler-plugino maven.compiler.source/ maven.compiler.targetpropiedades para especificar que sourcey targetson equivalentes.

<plugins>
    <plugin>    
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
        </configuration>
    </plugin>
</plugins>

y

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

son equivalentes de acuerdo con la documentación de Maven del complemento del compilador ya que <source>los <target>elementos y en la configuración del compilador usan las propiedades maven.compiler.sourcey maven.compiler.targetsi están definidos.

fuente

El -sourceargumento para el compilador de Java.
El valor por defecto es: 1.6.
Propiedad de usuario es: maven.compiler.source.

objetivo

El -targetargumento para el compilador de Java.
El valor por defecto es: 1.6.
Propiedad de usuario es: maven.compiler.target.

Acerca de los valores predeterminados para sourcey target, tenga en cuenta que desde el 3.8.0compilador maven, los valores predeterminados han cambiado de 1.5a1.6 .

3) El maven-compiler-plugin 3.6y las versiones posteriores proporcionan una nueva forma:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.0</version>
    <configuration>
        <release>9</release>
    </configuration>
</plugin>

También podría declarar solo:

<properties>
    <maven.compiler.release>9</maven.compiler.release>
</properties>

Pero en este momento no funcionará, ya que la maven-compiler-pluginversión predeterminada que usa no depende de una versión lo suficientemente reciente.

El releaseargumento de Maven transmite release: una nueva opción estándar JVM que podríamos pasar de Java 9:

Compila contra la API pública, compatible y documentada para una versión de VM específica.

De esta manera proporciona una forma estándar para especificar la misma versión para el source, los targety las bootstrapopciones de JVM.
Tenga en cuenta que la especificación de bootstrapes una buena práctica para las compilaciones cruzadas y no le hará daño si tampoco realiza compilaciones cruzadas.


¿Cuál es la mejor manera de especificar la versión JDK?

La primera forma ( <java.version>) está permitida solo si usa Spring Boot.

Para Java 8 y a continuación:

Acerca de las otras dos formas: valorando las propiedades maven.compiler.source/ o usando , puede usar una u otra. No cambia nada en los hechos, ya que finalmente las dos soluciones se basan en las mismas propiedades y el mismo mecanismo: el complemento compilador maven core. maven.compiler.targetmaven-compiler-plugin

Bueno, si no necesita especificar otras propiedades o comportamientos que las versiones de Java en el complemento del compilador, usar este método tiene más sentido ya que es más conciso:

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Desde Java 9:

El releaseargumento (tercer punto) es una forma de considerar seriamente si desea utilizar la misma versión para el origen y el destino.

¿Qué sucede si la versión difiere entre el JDK en JAVA_HOME y cuál se especifica en el pom.xml?

No es un problema si el JDK al que hace referencia JAVA_HOMEes compatible con la versión especificada en el pom, pero para garantizar una mejor compatibilidad de compilación cruzada, piense en agregar la bootstrapopción JVM con el valor de la ruta rt.jarde la targetversión.

Una cosa importante a tener en cuenta es que el sourcey la targetversión en la configuración de Maven no debe ser superior a la versión JDK referencia el JAVA_HOME.
Una versión anterior del JDK no puede compilarse con una versión más reciente ya que no conoce su especificación.

Para obtener información sobre las versiones compatibles de origen, destino y lanzamiento de acuerdo con el JDK utilizado, consulte la compilación de Java: versiones compatibles de origen, destino y lanzamiento .


¿Cómo manejar el caso de JDK al que hace referencia JAVA_HOME no es compatible con el destino de Java y / o las versiones de origen especificadas en el pom?

Por ejemplo, si su se JAVA_HOMErefiere a un JDK 1.7 y especifica un JDK 1.8 como fuente y destino en la configuración del compilador de su pom.xml, será un problema porque, como se explicó, el JDK 1.7 no sabe cómo compilar con .
Desde su punto de vista, es una versión JDK desconocida desde que se lanzó después.
En este caso, debe configurar el complemento del compilador Maven para especificar el JDK de esta manera:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <compilerVersion>1.8</compilerVersion>      
        <fork>true</fork>
        <executable>D:\jdk1.8\bin\javac</executable>                
    </configuration>
</plugin>

Podría tener más detalles en ejemplos con el complemento compilador maven .


No se pregunta, pero los casos en que eso puede ser más complicado es cuando especifica el origen pero no el destino. Puede usar una versión diferente en el destino de acuerdo con la versión de origen. Las reglas son particulares: puede leer sobre ellas en la parte Opciones de compilación cruzada .


¿Por qué el complemento del compilador se rastrea en la salida en la ejecución del packageobjetivo de Maven incluso si no lo especifica en el pom.xml?

Para compilar su código y, en general, para realizar todas las tareas necesarias para un objetivo de Maven, Maven necesita herramientas. Por lo tanto, se utiliza complementos del núcleo Maven (reconoces un núcleo Maven Plugin por su groupId: org.apache.maven.plugins) para realizar las tareas requeridas: Plugin compilador para la compilación de las clases, plugin de prueba para la ejecución de pruebas, y así por ... Así que, incluso si no lo hace declara estos complementos, están obligados a la ejecución del ciclo de vida de Maven.
En el directorio raíz de su proyecto Maven, puede ejecutar el comando: mvn help:effective-pompara obtener el pom final de manera efectiva. Puede ver, entre otra información, los complementos adjuntos de Maven (especificados o no en su pom.xml), con la versión utilizada, su configuración y los objetivos ejecutados para cada fase del ciclo de vida.

En la salida del mvn help:effective-pomcomando, puede ver la declaración de estos complementos principales en el <build><plugins>elemento, por ejemplo:

...
<plugin>
   <artifactId>maven-clean-plugin</artifactId>
   <version>2.5</version>
   <executions>
     <execution>
       <id>default-clean</id>
       <phase>clean</phase>
       <goals>
         <goal>clean</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
 <plugin>
   <artifactId>maven-resources-plugin</artifactId>
   <version>2.6</version>
   <executions>
     <execution>
       <id>default-testResources</id>
       <phase>process-test-resources</phase>
       <goals>
         <goal>testResources</goal>
       </goals>
     </execution>
     <execution>
       <id>default-resources</id>
       <phase>process-resources</phase>
       <goals>
         <goal>resources</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
 <plugin>
   <artifactId>maven-compiler-plugin</artifactId>
   <version>3.1</version>
   <executions>
     <execution>
       <id>default-compile</id>
       <phase>compile</phase>
       <goals>
         <goal>compile</goal>
       </goals>
     </execution>
     <execution>
       <id>default-testCompile</id>
       <phase>test-compile</phase>
       <goals>
         <goal>testCompile</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
  ...

Puede obtener más información al respecto en la introducción del ciclo de vida de Maven en la documentación de Maven .

Sin embargo, puede declarar estos complementos cuando desee configurarlos con otros valores como valores predeterminados (por ejemplo, lo hizo cuando declaró el complemento compilador maven en su pom.xml para ajustar la versión JDK a usar) o cuando desea agregar algunas ejecuciones de complementos que no se usan por defecto en el ciclo de vida de Maven.

davidxxx
fuente
Gracias por una amplia explicación, ahora es mucho más claro para mí. También sobre <java.version>: he visto esto en algún fragmento de código, tal vez esa era una propiedad personalizada y supuse erróneamente que es la forma de declarar la versión de Java, se adherirá a la <maven.compiler.x>propiedad de ahora en adelante.
Plebejusz
De nada, con mucho gusto :) Inicialmente, no era mi intención desarrollar tanto, pero cuando comencé, no pude parar :) Para `<java.version>` es muy probable. Nos vemos y buen maven!
davidxxx
1
" no es un problema si el JDK de su JAVA_HOME es compatible con las versiones especificadas en el pom " esto no es (necesariamente) cierto, consulte este hilo de desbordamiento de pila para referencia
A_Di-Matteo
2
@ Robin A. Meade gracias por los comentarios. Yo uso la bota de primavera pero no lo sabía. Personalmente, no me pareció lo suficientemente estándar como para ser usado o referenciado como algo para usar. Spring boot ofrece algunas cosas muy interesantes, pero en algunos casos sus características son muy discretas. Reemplazar el nombre de una propiedad estándar de Maven para no llenar tanto el origen como el jdk de destino parece realmente una mala idea, ya que se realiza una sola vez para una aplicación. Pierde el estándar para ahorrar una línea xml simple en su aplicación. Woah! Qué idea ...
davidxxx
1
@ MasterJoe2 Lo encuentra en la documentación oficial de javac de la versión 10: docs.oracle.com/javase/10/tools/javac.htm#JSWOR627 . Había dividido esa respuesta en dos partes ya que eso se vuelve demasiado grande, también puedes ver eso: stackoverflow.com/questions/51692748/…
davidxxx
3

Ninguna de las soluciones anteriores me funcionó de inmediato. Entonces hice lo siguiente:

  1. Adicional

    <properties> <maven.compiler.target>1.8</maven.compiler.target> <maven.compiler.source>1.8</maven.compiler.source> </properties>

    en pom.xml

  2. Fui a Project Properties > Java Build Path, luego quité la biblioteca del sistema JRE que apuntaba JRE1.5.

  3. Force actualizó el proyecto.

Sen
fuente
¿Qué versión especificas para Java 10 y superior? ¿Es 10 o 1.10?
MasterJoe2
@ MasterJoe2 de java 9 y versiones superiores, debe escribir el número de versión tal como está (<version> 10 </version>), y para las versiones siguientes, debe agregar 1. delante de la versión (<version> 1.5 </version>)
ikbel benab
0

Considere la alternativa:

<properties>
    <javac.src.version>1.8</javac.src.version>
    <javac.target.version>1.8</javac.target.version>
</properties>

Debería ser lo mismo, maven.compiler.source/maven.compiler.targetpero la solución anterior funciona para mí, de lo contrario, la segunda obtiene la especificación principal (tengo una matrioska de .pom)

Stefano
fuente