Maven frente a Gradle: qué necesita quien se inicia para compilar el proyecto JVM de otra persona

Qué es

Maven: pom.xml declara coordenadas (groupId, artifactId, version), dependencias con ámbitos (scopes) y plugins. La guía del ciclo de vida indica que existen tres ciclos de vida integrados (default, clean, site); el ciclo de vida default ejecuta sus fases en un orden fijo, e invocar una fase ejecuta todas las anteriores, de modo que mvn verify valida, compila, prueba, empaqueta y ejecuta comprobaciones de integración. Los objetivos de los plugins se vinculan a las fases. Los ámbitos de dependencia (compile por defecto, provided, runtime, test, e import para las BOM) deciden a qué classpaths llega una dependencia. La guía de dependencias indica que las versiones en conflicto se resuelven mediante la «definición más cercana» en el árbol, ganando la primera declaración en caso de igual profundidad, y que dependencyManagement fija las versiones de las dependencias transitivas.

Gradle: la guía de conceptos básicos describe una compilación en términos de proyectos y tareas configuradas por scripts de compilación (build.gradle en Groovy o build.gradle.kts en Kotlin) más un archivo settings.gradle(.kts), con plugins que añaden tareas y convenciones. Las dependencias se declaran en configuraciones como implementation y testImplementation. Cuando dos rutas solicitan versiones distintas de un módulo, el capítulo sobre resolución de conflictos indica que Gradle selecciona por defecto la más alta de las versiones solicitadas. Gradle ofrece un bloqueo de dependencias opcional; Maven no tiene un archivo de bloqueo integrado, por lo que la repetibilidad procede de versiones exactas e importaciones de BOM.

Por qué importa

Quien está acostumbrado a npm, cargo o pip debe averiguar primero qué herramienta y qué versión espera el repositorio. Ambos ecosistemas responden con un wrapper incluido en el repositorio: ./gradlew, al que la documentación de Gradle llama la forma recomendada de ejecutar una compilación, y el ./mvnw opcional de Maven. Ejecutar una herramienta instalada globalmente con otra versión es el primer error más frecuente, seguido de asumir la regla de conflicto de la otra herramienta.

Cómo aplicarlo

• Usar el wrapper: ./gradlew build o ./mvnw verify; recurrir a una instalación global solo cuando no exista wrapper.
• Maven: leer pom.xml de arriba abajo (parent, properties, dependencyManagement, dependencies, build plugins); mvn dependency:tree muestra lo que eligió la resolución de conflictos.
• Gradle: leer settings.gradle(.kts) para la lista de proyectos, y después el script de compilación; ./gradlew tasks y ./gradlew dependencies --configuration runtimeClasspath explican la compilación.
• Omitir las pruebas de forma visible y solo para la iteración local: -DskipTests (Maven), -x test (Gradle).
• Compilaciones multimódulo: el reactor de Maven ordena los módulos según sus dependencias a partir del POM raíz; los subproyectos de Gradle se listan en el archivo de settings.

Trampas

La regla de la definición más cercana de Maven puede seleccionar una versión más antigua de la que necesita una dependencia transitiva; la regla de la versión más alta de Gradle puede introducir una más nueva de la que se probó cualquier módulo. Los scripts de compilación de Gradle son código y pueden hacer cualquier cosa. mvn install escribe en el repositorio local y puede enmascarar la falta de una publicación. Ambos almacenan en caché los artefactos descargados, por lo que las cachés de CI necesitan una clave derivada de los archivos de compilación.