Tutorial Java: Gradle

Qué es Gradle

Gradle es una herramienta de automatización para la construcción de proyectos que ha ganado gran popularidad en el ecosistema Java. A diferencia de herramientas más antiguas, Gradle combina lo mejor de otros sistemas de construcción con un enfoque moderno y flexible.

En el desarrollo de aplicaciones Java, necesitamos una forma de gestionar dependencias, compilar código, ejecutar pruebas y empaquetar nuestras aplicaciones de manera consistente. Gradle resuelve estos problemas ofreciendo un sistema que automatiza estas tareas repetitivas.

Gradle se caracteriza por utilizar un lenguaje específico de dominio (DSL) basado en Groovy o Kotlin para definir las configuraciones de construcción. Esto permite escribir scripts más concisos y expresivos que los utilizados en herramientas como Maven (basado en XML).

Una de las ventajas más destacadas de Gradle es su modelo de rendimiento. Implementa varias optimizaciones como:

• Construcciones incrementales: solo reconstruye lo que ha cambiado
• Construcción en paralelo: aprovecha los múltiples núcleos del procesador
• Caché de construcción: reutiliza resultados de construcciones anteriores

Para los desarrolladores Java, Gradle ofrece soporte nativo para las convenciones de proyectos Java, lo que significa que puede trabajar con la estructura de directorios estándar de Java sin configuración adicional:

src/main/java/       # Código fuente principal
src/main/resources/  # Recursos principales
src/test/java/       # Código de pruebas
src/test/resources/  # Recursos para pruebas

Gradle también destaca por su extensibilidad mediante un rico ecosistema de plugins. Estos plugins añaden funcionalidades específicas a nuestros proyectos. Algunos ejemplos comunes incluyen:

• java: para proyectos Java estándar
• application: para aplicaciones ejecutables
• spring-boot: para proyectos Spring Boot

La gestión de dependencias es otra área donde Gradle brilla. Permite declarar las bibliotecas que nuestro proyecto necesita, y Gradle se encarga de descargarlas (junto con sus dependencias transitivas) de repositorios como Maven Central:

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.12.0'
    testImplementation 'junit:junit:4.13.2'
}

Gradle es utilizado por grandes empresas y proyectos, incluyendo Android Studio (el IDE oficial para desarrollo Android), lo que demuestra su robustez y capacidad para manejar proyectos complejos.

Para empezar a usar Gradle, solo necesitas instalarlo en tu sistema y crear un archivo de configuración básico llamado build.gradle en la raíz de tu proyecto. Este archivo define cómo se construirá tu proyecto, qué dependencias necesita y qué tareas se pueden ejecutar.

A diferencia de sistemas más rígidos, Gradle adopta el principio de "convención sobre configuración", lo que significa que proporciona valores predeterminados sensatos pero permite personalizarlos cuando sea necesario. Esto hace que sea accesible para principiantes pero potente para usuarios avanzados.

En resumen, Gradle representa una evolución moderna en las herramientas de construcción para Java, ofreciendo flexibilidad, rendimiento y una experiencia de desarrollo mejorada en comparación con alternativas más antiguas.

El archivo build.gradle

El archivo build.gradle es el corazón de cualquier proyecto Gradle. Este archivo de configuración define cómo se construirá tu proyecto Java, qué dependencias necesita y qué tareas se pueden ejecutar. Cuando creas un nuevo proyecto que utiliza Gradle, este archivo estará ubicado en la raíz del proyecto.

La estructura del archivo build.gradle es bastante sencilla, aunque puede volverse más compleja según las necesidades del proyecto. Veamos los elementos básicos que suelen aparecer en este archivo:

Plugins

Los plugins extienden la funcionalidad de Gradle añadiendo tareas predefinidas, configuraciones y convenciones. Para un proyecto Java básico, normalmente incluirás el plugin de Java:

plugins {
    id 'java'
}

Este plugin añade automáticamente tareas como compileJava, test y jar, además de establecer la estructura de directorios estándar para proyectos Java.

Información del proyecto

Puedes definir metadatos sobre tu proyecto, como su nombre, versión y grupo:

group = 'com.miempresa'
version = '1.0-SNAPSHOT'

Repositorios

Los repositorios indican a Gradle dónde buscar las dependencias que tu proyecto necesita. Maven Central es el repositorio más común:

repositories {
    mavenCentral()
}

También puedes añadir otros repositorios como JCenter o repositorios personalizados:

repositories {
    mavenCentral()
    maven { url "https://repo.spring.io/release" }
}

Dependencias

La sección de dependencias es donde declaras las bibliotecas externas que tu proyecto necesita:

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.12.0'
    testImplementation 'junit:junit:4.13.2'
}

Gradle utiliza diferentes configuraciones de dependencias para distintos propósitos:

• implementation: dependencias necesarias para compilar y ejecutar tu código
• testImplementation: dependencias solo necesarias para compilar y ejecutar pruebas
• compileOnly: dependencias solo necesarias durante la compilación
• runtimeOnly: dependencias solo necesarias durante la ejecución

Configuración de Java

Puedes especificar la versión de Java que tu proyecto utilizará:

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

Tareas personalizadas

Una de las características más potentes de Gradle es la capacidad de definir tareas personalizadas:

task hola {
    doLast {
        println 'Hola, Gradle!'
    }
}

Esta tarea se puede ejecutar desde la línea de comandos con gradle hola.

Ejemplo completo

Un archivo build.gradle básico para un proyecto Java podría verse así:

plugins {
    id 'java'
    id 'application'
}

group = 'com.miempresa.app'
version = '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.guava:guava:31.1-jre'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.8.2'
}

application {
    mainClass = 'com.miempresa.app.Main'
}

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

test {
    useJUnitPlatform()
}

Ejecución de tareas

Para ejecutar tareas definidas en el archivo build.gradle, utilizas el comando gradle seguido del nombre de la tarea. Por ejemplo:

• gradle build: compila el proyecto y crea el archivo JAR
• gradle test: ejecuta las pruebas
• gradle run: ejecuta la aplicación (si se usa el plugin 'application')
• gradle clean: elimina los archivos generados por compilaciones anteriores

Archivos de configuración adicionales

Además del archivo build.gradle, un proyecto Gradle puede incluir otros archivos de configuración:

• settings.gradle: define qué proyectos forman parte de la construcción (importante en proyectos multi-módulo)
• gradle.properties: contiene propiedades que se pueden usar en el archivo build.gradle

El archivo build.gradle puede parecer simple al principio, pero su flexibilidad permite adaptarse a proyectos de cualquier tamaño y complejidad. A medida que te familiarices con Gradle, descubrirás cómo personalizar este archivo para satisfacer las necesidades específicas de tus proyectos Java.