- Agile 2
- Alta disponibilidad 1
- Alternativas cloud 1
- Aop 1
- Arquitectura 3
- Arquitectura distribuida 2
- Automatizacion 3
- Azure devops 1
- Base de datos 1
- Buenas practicas 19
- Cloud 1
- Colas 7
- Competing consumers 1
- Convenciones 11
- Copilot 1
- Diseno 6
- Docker 2
- Docker compose 1
- Documentacion 1
- Eda 11
- Equipos 1
- Escalabilidad 1
- Flujo de negocio 1
- Flujo de trabajo 3
- Flyway 1
- Git 4
- Gradle 3
- Herramientas digitales 1
- Ia 1
- Iam 1
- Infraestructura 2
- Java 14
- Jerarquia tecnica 1
- Jpa 1
- Jsonb 1
- Kafka 7
- Kubernetes 1
- Liderazgo en software 1
- Lineamientos 1
- Log 1
- Logging 3
- Microservicios 3
- Mongodb 1
- Monitoreo 1
- Nosql 3
- Observabilidad 4
- Open source 1
- Plugins 3
- Postgresql 1
- Privacidad 1
- Programacion funcional 1
- Programacion reactiva 4
- Rabbitmq 6
- Rotacion de talento 1
- Saga 2
- Scrum 2
- Security 1
- Seguridad 1
- Self hosting 1
- Sistemas legados 1
- Spring boot 3
- Spring mvc 2
- Sql 3
- Streams 1
- Threadlocal 1
- Trazabilidad 2
- Versionado 2
- Web 1
- Webflux 2
- Websockets 1
- Zero trust 1
Gradle
3 artículos
Del Dicho al Hecho: Generando Proyectos Java con Plantillas y FreeMarker
- Mauricio ECR
- DevOps
- 25 Jun, 2025
En el artículo anterior, alcanzamos un hito crucial: construimos un plugin binario funcional en Java, completo con su propia configuración y tarea. Nuestro plugin "saludador" demostró que dominamos la
Del Dicho al Hecho: Generando Proyectos Java con Plantillas y FreeMarker
- Mauricio ECR
- DevOps
- 25 Jun, 2025
En el artículo anterior, alcanzamos un hito crucial: construimos un plugin binario funcional en Java, completo con su propia configuración y tarea. Nuestro plugin "saludador" demostró que dominamos la estructura, pero su utilidad era meramente académica. Hoy, transformamos ese esqueleto en una herramienta de productividad real. Vamos a convertir nuestro plugin en un generador de proyectos.
El objetivo de este capítulo es tomar la configuración del usuario (como el nombre del proyecto y el paquete base) y, con una sola tarea de Gradle, materializar un esqueleto de proyecto Java completamente funcional. Para lograr esto, dejaremos atrás la simple impresión en consola y nos adentraremos en dos áreas clave: la manipulación del sistema de archivos y, lo más importante, el uso de un motor de plantillas. Presentamos a nuestro nuevo mejor amigo: Apache FreeMarker.
1. La Herramienta Adecuada: ¿Por qué un Motor de Plantillas?
Podríamos generar archivos concatenando String en Java, pero eso sería increíblemente frágil, difícil de leer y casi imposible de mantener. Un motor de plantillas separa el "qué" (la estructura y el contenido de un archivo) del "cómo" (los datos específicos que lo rellenan).
Elegimos FreeMarker por varias razones:
- Madurez y Potencia: Es una biblioteca robusta y probada en batalla.
- Diseñado para la Generación de Texto: A diferencia de otros motores más enfocados en HTML, FreeMarker es excelente para generar cualquier tipo de archivo de texto:
.java,.xml,.properties, o nuestrobuild.gradle. - Lógica en Plantillas: Permite usar condicionales, bucles y otras lógicas directamente en los archivos de plantilla, algo que será vital cuando generemos código más complejo.
2. Integrando FreeMarker en Nuestro Plugin
El primer paso es hacer que nuestro plugin conozca FreeMarker.
a) Añadir la Dependencia
Abre el archivo build.gradle de nuestro plugin (nuestro-generador/plugin/build.gradle) y añade la dependencia de FreeMarker.
// nuestro-generador/plugin/build.gradle
plugins {
id 'java-gradle-plugin'
}
repositories {
mavenCentral()
}
// AÑADIMOS ESTE BLOQUE
dependencies {
// Añadimos la implementación de FreeMarker
implementation 'org.freemarker:freemarker:2.3.32'
}
gradlePlugin {
plugins {
// Renombraremos el plugin para que refleje su nuevo propósito
projectGeneratorPlugin {
id = 'com.miempresa.project-generator'
implementationClass = 'com.miempresa.ProjectGeneratorPlugin'
}
}
}
b) Creación de las Plantillas
Las plantillas son el corazón de nuestro generador. Por convención, las colocaremos en src/main/resources/templates dentro de nuestro proyecto de plugin. Gradle las empaquetará automáticamente en el .jar final, haciéndolas accesibles desde el classpath.
Crea el directorio nuestro-generador/plugin/src/main/resources/templates/. Ahora, creemos algunas plantillas básicas. Nota el uso de la sintaxis ${...} para las variables.
templates/build.gradle.ftl:
plugins {
id 'java'
id 'application'
}
group = '${basePackage}'
version = '1.0-SNAPSHOT'
repositories {
mavenCentral()
}
dependencies {
testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
}
application {
mainClass = '${basePackage}.Application'
}
templates/Application.java.ftl:
package ${basePackage};
public class Application {
public static void main(String[] args) {
System.out.println("¡Hola desde el proyecto '${projectName}'!");
}
}
3. Expandiendo la Configuración
Nuestra extensión actual es demasiado simple. Necesitamos que el usuario nos proporcione la información necesaria para la generación. Vamos a renombrar y expandir nuestra clase de extensión.
- Renombra
GreeterExtension.javaaGeneratorExtension.java. - Añade las nuevas propiedades.
plugin/src/main/java/com/miempresa/GeneratorExtension.java:
package com.miempresa;
public class GeneratorExtension {
private String projectName = "mi-proyecto-generado";
private String basePackage = "com.ejemplo.proyecto";
public String getProjectName() {
return projectName;
}
public void setProjectName(String projectName) {
this.projectName = projectName;
}
public String getBasePackage() {
return basePackage;
}
public void setBasePackage(String basePackage) {
this.basePackage = basePackage;
}
}
4. La Tarea de Generación: El Corazón de la Lógica
Aquí es donde ocurre la magia. Reemplazaremos nuestra antigua tarea greet por una nueva y potente tarea generateProject.
- Renombra
GreetingPlugin.javaaProjectGeneratorPlugin.java. - Actualiza la lógica para que use FreeMarker y cree los archivos.
plugin/src/main/java/com/miempresa/ProjectGeneratorPlugin.java:
package com.miempresa;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import freemarker.template.TemplateExceptionHandler;
import org.gradle.api.Plugin;
import org.gradle.api.Project;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
public class ProjectGeneratorPlugin implements Plugin<Project> {
@Override
public void apply(Project project) {
final GeneratorExtension extension = project.getExtensions().create("generator", GeneratorExtension.class);
project.getTasks().register("generateProject", task -> {
task.setGroup("Generacion");
task.setDescription("Genera un nuevo esqueleto de proyecto Java.");
task.doLast(t -> {
try {
generate(project, extension);
} catch (IOException | TemplateException e) {
// Lanzamos una excepción para que el build falle si algo va mal
throw new RuntimeException("Fallo al generar el proyecto", e);
}
});
});
}
private void generate(Project project, GeneratorExtension extension) throws IOException, TemplateException {
String projectName = extension.getProjectName();
String basePackage = extension.getBasePackage();
project.getLogger().lifecycle("Iniciando generación del proyecto: {}", projectName);
// 1. Configurar FreeMarker
Configuration cfg = new Configuration(Configuration.VERSION_2_3_32);
cfg.setClassForTemplateLoading(ProjectGeneratorPlugin.class, "/templates");
cfg.setDefaultEncoding("UTF-8");
cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
// 2. Crear el modelo de datos para las plantillas
Map<String, Object> model = new HashMap<>();
model.put("projectName", projectName);
model.put("basePackage", basePackage);
// 3. Crear directorios
File projectDir = new File(project.getProjectDir(), projectName);
File packageDir = new File(projectDir, "src/main/java/" + basePackage.replace('.', '/'));
if (!packageDir.mkdirs()) {
throw new IOException("No se pudieron crear los directorios base.");
}
new File(projectDir, "src/test/java").mkdirs();
// 4. Procesar plantillas y generar archivos
generateFile(cfg, model, "build.gradle.ftl", new File(projectDir, "build.gradle"));
generateFile(cfg, model, "Application.java.ftl", new File(packageDir, "Application.java"));
project.getLogger().lifecycle("Proyecto '{}' generado exitosamente en: {}", projectName, projectDir.getAbsolutePath());
}
private void generateFile(Configuration cfg, Map<String, Object> model, String templateName, File output) throws IOException, TemplateException {
Template template = cfg.getTemplate(templateName);
try (Writer writer = new FileWriter(output)) {
template.process(model, writer);
}
}
}
5. Probándolo Todo Junto
Ya estamos listos para la prueba final.
Actualiza el
build.gradledel proyecto de prueba para usar el nuevo ID del plugin y la nueva extensióngenerator.nuestro-generador/proyecto-de-prueba/build.gradle:plugins { // Usamos el nuevo ID del plugin id 'com.miempresa.project-generator' } // Usamos la nueva extensión 'generator' generator { projectName = 'mi-primera-app' basePackage = 'com.acme.app' }Ejecuta la tarea de generación desde el directorio raíz (
nuestro-generador/)../gradlew :proyecto-de-prueba:generateProject
Si todo fue correcto, verás los mensajes de log en tu consola y, lo más importante, ¡un nuevo directorio llamado mi-primera-app habrá aparecido! Dentro, encontrarás un proyecto Gradle funcional, listo para ser importado en tu IDE y ejecutado.
nuestro-generador/
├── mi-primera-app/
│ ├── build.gradle
│ └── src/main/java/com/acme/app/Application.java
├── plugin/
└── ...
Conclusión y Siguientes Pasos
¡Hemos dado un salto cuántico! Nuestro plugin ha pasado de ser un juguete a una herramienta de productividad. Ahora puede tomar una configuración declarativa y generar un proyecto Java completo y funcional. Hemos aprendido a integrar una biblioteca de terceros, a gestionar y procesar archivos de plantillas desde el classpath y a escribir una lógica de tarea compleja que interactúa con el sistema de archivos.
Nuestro generador es potente, pero su estructura es estática. Siempre genera el mismo tipo de proyecto. ¿Y si pudiéramos llevarlo más allá? ¿Y si pudiéramos describir una entidad de negocio —como "Producto" o "Cliente"— y el plugin generara automáticamente todo el código CRUD (Crear, Leer, Actualizar, Borrar) para ella, siguiendo las mejores prácticas de la industria?
En el próximo artículo, nos adentraremos en el fascinante mundo del Domain-Driven Design (DDD) y la arquitectura hexagonal. Haremos que nuestro plugin lea una definición de modelo y genere dinámicamente todas las capas necesarias, desde la entidad de dominio hasta el controlador REST, llevando nuestra capacidad de automatización a un nivel completamente nuevo.
De Consumidor a Creador: Construyendo tu Primer Plugin Binario de Gradle
- Mauricio ECR
- DevOps
- 16 Jun, 2025
En nuestro artículo anterior, desmitificamos Gradle y sentamos las bases para entender su funcionamiento. Aprendimos a crear proyectos, ejecutar tareas y comprendimos el rol fundamental de los plugins
De Consumidor a Creador: Construyendo tu Primer Plugin Binario de Gradle
- Mauricio ECR
- DevOps
- 16 Jun, 2025
En nuestro artículo anterior, desmitificamos Gradle y sentamos las bases para entender su funcionamiento. Aprendimos a crear proyectos, ejecutar tareas y comprendimos el rol fundamental de los plugins como consumidores. Hoy, damos el salto más emocionante: pasaremos de ser meros usuarios a ser creadores. Vamos a construir nuestro propio plugin binario desde cero, utilizando Java para la lógica y el Groovy DSL para nuestros scripts de build.
¿Por qué un plugin binario? Porque es el estándar profesional. A diferencia de los scripts sueltos, un plugin binario es un artefacto compilado (.jar), versionable, fácilmente distribuible y, sobre todo, mucho más robusto y testeable. Es el vehículo perfecto para encapsular la lógica compleja que nuestro futuro generador de código necesitará.
En este capítulo, construiremos un plugin "saludador" (Greeter). Será sencillo en su función —mostrar un mensaje configurable— pero nos enseñará la anatomía completa de un plugin en un entorno Java: su estructura, su punto de entrada, cómo hacerlo configurable y, finalmente, cómo probarlo. ¡Es hora de arremangarse y empezar a programar nuestro build!
1. La Anatomía de un Plugin: Estructura del Proyecto
Para empezar, necesitamos un entorno de trabajo. La mejor manera de desarrollar y probar un plugin es con un build multi-proyecto. Crearemos una estructura que contenga tanto la lógica del plugin como un proyecto de ejemplo que lo consumirá.
Abre tu terminal y crea la siguiente estructura de directorios:
nuestro-generador/
├── plugin/ # Directorio para el código de nuestro plugin
└── proyecto-de-prueba/ # Un proyecto simple para aplicar y probar el plugin
Ahora, configuremos cada parte.
a) Configurando el Proyecto del Plugin (/plugin)
Este es el corazón de nuestro trabajo. Dentro del directorio plugin, crea un archivo build.gradle y un settings.gradle.
plugin/settings.gradle:
rootProject.name = 'mi-plugin-saludador'
plugin/build.gradle:
Este archivo es crucial. Le dice a Gradle que estamos construyendo un plugin de Gradle con código Java.
plugins {
// Plugin esencial para desarrollar plugins de Gradle en Java
id 'java-gradle-plugin'
}
repositories {
mavenCentral()
}
// Este bloque configura los detalles de nuestro plugin
gradlePlugin {
plugins {
// "greeterPlugin" es el nombre que le damos a nuestra configuración
greeterPlugin {
id = 'com.miempresa.greeter' // El ID único que los usuarios usarán
implementationClass = 'com.miempresa.GreetingPlugin' // La clase Java que implementa la lógica
}
}
}
b) El Código Fuente del Plugin
Gradle necesita saber dónde está el código. Con el plugin java-gradle-plugin, asumirá la estructura estándar de Java.
Crea la clase del Plugin: Dentro de
plugin/, crea la ruta de directoriossrc/main/java/com/miempresa/. Dentro, crea el archivoGreetingPlugin.java.El archivo de propiedades: El plugin
java-gradle-pluginy el bloquegradlePluginse encargan de generar automáticamente el archivo de propiedades necesario (META-INF/gradle-plugins/com.miempresa.greeter.properties). ¡Magia!
2. El Punto de Entrada: La Interfaz Plugin<Project>
Todo plugin binario debe implementar la interfaz Plugin<Project>. Su método apply(Project project) es la puerta de entrada, el equivalente al main de una aplicación. Es aquí donde toda nuestra lógica se conectará al proyecto que use el plugin.
Edita tu archivo plugin/src/main/java/com/miempresa/GreetingPlugin.java:
package com.miempresa;
import org.gradle.api.Plugin;
import org.gradle.api.Project;
public class GreetingPlugin implements Plugin<Project> {
@Override
public void apply(Project project) {
// El objeto "project" es nuestra puerta de acceso al build del consumidor.
// Aquí registraremos tareas, extensiones, etc.
project.getLogger().lifecycle("¡Plugin 'greeter' aplicado con éxito!");
}
}
Ya tenemos un esqueleto funcional. ¡Pero un plugin que no hace nada no es muy útil!
3. Haciendo tu Plugin Configurable con Extensiones
Rara vez querremos que un plugin se comporte siempre igual. Necesitamos una forma de que el usuario lo configure. En lugar de pasar parámetros de forma engorrosa, Gradle nos ofrece un mecanismo elegante: las Extensiones.
Una extensión no es más que un POJO (Plain Old Java Object) cuyas propiedades serán configurables desde el build.gradle del consumidor a través de sus getters y setters.
Crea la clase de la Extensión: Dentro de
com.miempresa, crea un nuevo archivoGreeterExtension.java.package com.miempresa; public class GreeterExtension { // En Java, las propiedades se modelan con campos privados y getters/setters públicos. private String message = "Hola por defecto desde el plugin Java"; public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } }Registra la Extensión: Ahora, volvamos a
GreetingPlugin.javay registremos la extensión en el métodoapply.// ... en GreetingPlugin.java @Override public void apply(Project project) { // Registramos una extensión llamada "greeter" que usa nuestra clase POJO. // El usuario la configurará con un bloque `greeter { ... }` en su build.gradle GreeterExtension extension = project.getExtensions().create("greeter", GreeterExtension.class); // ... más lógica vendrá aquí }
4. Dando Vida al Plugin: Tareas Personalizadas
El objetivo final de un plugin es, generalmente, añadir nuevas tareas. Vamos a crear una tarea greet que use el mensaje de nuestra extensión.
Registra la Tarea: Dentro del método
applydeGreetingPlugin.java, después de registrar la extensión, registraremos la tarea.// ... en GreetingPlugin.java, dentro del método apply() @Override public void apply(Project project) { // La variable debe ser final (o efectivamente final) para ser usada en la lambda final GreeterExtension extension = project.getExtensions().create("greeter", GreeterExtension.class); // Registramos una nueva tarea llamada "greet" project.getTasks().register("greet", task -> { task.setGroup("Saludos"); // Agrupa la tarea en la lista de `./gradlew tasks` task.setDescription("Muestra un saludo configurable"); // La acción que se ejecutará cuando se llame a la tarea task.doLast(t -> { // Usamos la extensión capturada del scope exterior project.getLogger().lifecycle(extension.getMessage()); }); }); }
Hemos conectado todo: El plugin registra una extensión para recibir configuración y una tarea que lee esa configuración para ejecutar una acción.
5. ¡A Probar! Aplicando y Verificando el Plugin Localmente
Es el momento de la verdad. Vamos a usar nuestro proyecto-de-prueba para consumir el plugin que acabamos de crear.
Modifica el
settings.gradleprincipal: Necesitamos decirle a Gradle que nuestro build tiene dos subproyectos y que uno (plugin) es un "build incluido" que provee plugins. Crea un archivosettings.gradleen el directorio raíz (nuestro-generador/).// nuestro-generador/settings.gradle rootProject.name = 'generador-completo' // Incluye el proyecto que usará el plugin include 'proyecto-de-prueba' // Incluye el build que contiene nuestro plugin includeBuild 'plugin'Configura el
proyecto-de-prueba: Ahora, crea un archivobuild.gradledentro deproyecto-de-prueba/.// nuestro-generador/proyecto-de-prueba/build.gradle plugins { // ¡Aplicamos nuestro plugin usando el ID que definimos! id 'com.miempresa.greeter' } // Configuramos la extensión que creamos en el plugin. // El Groovy DSL llama a setMessage() automáticamente. greeter { message = '¡Mi primer plugin en Java funciona! 🎉' }Ejecuta la Tarea: Vuelve a la raíz (
nuestro-generador/) en tu terminal y ejecuta la tarea, especificando la ruta completa del proyecto:gradle :proyecto-de-prueba:greet
Si todo ha ido bien, deberías ver la salida:
Task :proyecto-de-prueba:greet ¡Mi primer plugin en Java funciona! 🎉
Y si ejecutas gradle :proyecto-de-prueba:tasks verás tu tarea listada bajo el grupo "Saludos".
Conclusión y Siguientes Pasos
¡Lo has conseguido! Has trascendido la barrera de simple usuario para convertirte en un desarrollador de plugins de Gradle usando Java. Hoy has aprendido el ciclo de vida completo de la creación de un plugin: desde la estructura del proyecto y el uso del plugin java-gradle-plugin, pasando por la implementación de la interfaz Plugin<Project>, la creación de una extensión POJO para hacerlo configurable, y el registro de una tarea personalizada que materializa su lógica.
Ya tenemos una base robusta y profesional. Nuestro plugin puede ser configurado y puede ejecutar acciones. Ahora que dominamos la estructura, el siguiente paso es hacerlo realmente útil.
En la próxima entrega de esta serie, tomaremos este esqueleto y le añadiremos músculos. Integraremos un motor de plantillas como FreeMarker, y modificaremos nuestra tarea para que, en lugar de imprimir un simple mensaje, genere una estructura completa de directorios y archivos. La aventura de nuestro generador de código está a punto de dar su paso más importante.
Desmitificando Gradle: El Primer Paso para Automatizar tu Mundo Java
- Mauricio ECR
- DevOps
- 14 Jun, 2025
En el vertiginoso universo del desarrollo de software, la eficiencia no es un lujo, es una necesidad. Dedicar tiempo a tareas repetitivas como compilar código, ejecutar pruebas, empaquetar la aplicaci
Desmitificando Gradle: El Primer Paso para Automatizar tu Mundo Java
- Mauricio ECR
- DevOps
- 14 Jun, 2025
En el vertiginoso universo del desarrollo de software, la eficiencia no es un lujo, es una necesidad. Dedicar tiempo a tareas repetitivas como compilar código, ejecutar pruebas, empaquetar la aplicación y gestionar dependencias es un lastre para la productividad. Aquí es donde entran en juego los sistemas de automatización de construcción, y hoy, nos enfocaremos en uno de los más potentes y flexibles del ecosistema Java: Gradle.
Este artículo es el punto de partida de una serie en la que no solo aprenderemos a usar Gradle, sino que construiremos nuestra propia herramienta avanzada: un plugin capaz de generar esqueletos de proyectos Java y módulos CRUD completos bajo la filosofía de Domain-Driven Design (DDD). Pero antes de correr, debemos aprender a caminar. ¡Acompáñanos en este primer paso para sentar unas bases sólidas y duraderas con Gradle!
¿Qué es Gradle y por qué Debería Importarte?
Imagina a Gradle como el director de orquesta de tu proyecto. Es un sistema de automatización de construcción de código abierto que toma tu código fuente, las librerías de las que depende, y una serie de instrucciones, y produce un artefacto final (como un archivo .jar o .war).
Si vienes del mundo de Java, es probable que hayas oído hablar de Maven o incluso del venerable Ant. ¿Qué hace diferente a Gradle?
- Frente a Maven: Mientras que Maven se rige por la "convención sobre configuración" con una estructura rígida definida en archivos
pom.xml, Gradle ofrece una flexibilidad inmensa. Su filosofía se basa en un DSL (Domain Specific Language), un lenguaje específico para el dominio de la construcción de software, que se escribe en Groovy o Kotlin. Esto transforma tus scripts de construcción de simples archivos de configuración a potentes programas. - Frente a Ant: Ant también usa scripts (XML), pero es mucho más imperativo. Le dices qué hacer y cómo hacerlo. Gradle es más declarativo; describes qué quieres lograr, y Gradle, con su modelo de grafos de dependencias, se encarga de la manera más eficiente de lograrlo.
Conceptos Clave para Empezar
Para hablar el idioma de Gradle, necesitas conocer su vocabulario esencial:
- Proyectos (Projects): Un proyecto es cualquier componente que quieres construir. Puede ser una librería (
.jar) o una aplicación web completa. Un repositorio puede contener un único proyecto o múltiples subproyectos. - Tareas (Tasks): Son las unidades de trabajo en Gradle. Una tarea puede ser compilar código (
compileJava), ejecutar pruebas (test), crear un archivo (build) o cualquier acción que definas. - Plugins: Son extensiones que añaden nuevas capacidades y tareas a tu proyecto. Por ejemplo, el plugin de Java añade tareas para compilar y probar código Java. Son el corazón de la reusabilidad en Gradle.
- Dependencias (Dependencies): Son las librerías o módulos externos que tu proyecto necesita para funcionar. Gradle se encarga de descargarlas de repositorios (como Maven Central) y hacerlas disponibles en tu proyecto.
Preparando el Terreno: Tu Entorno de Desarrollo 🛠️
Antes de escribir una sola línea, asegúrate de tener las herramientas adecuadas.
- JDK (Java Development Kit): Gradle se ejecuta sobre la JVM, por lo que necesitas un JDK instalado. La versión 17 o superior es una excelente elección para proyectos modernos.
- Instalación de Gradle: Aunque puedes descargarlo manualmente, la forma más recomendada es usar un gestor de versiones como SDKMAN! (para Linux/macOS) o simplemente usar el Gradle Wrapper, una pequeña utilidad que se incluye en los proyectos Gradle y que descarga la versión correcta automáticamente. ¡No te preocupes, lo veremos en acción ahora mismo!
- IDE (Entorno de Desarrollo Integrado): IntelliJ IDEA ofrece una integración con Gradle que es simplemente espectacular. Visual Studio Code, con la extensión "Gradle for Java", es también una alternativa fantástica y ligera.
¡Manos a la Obra! Tu Primer Proyecto con Gradle
La teoría está muy bien, pero la magia sucede en la práctica. Vamos a crear un proyecto Java desde cero. Abre tu terminal en una carpeta vacía y ejecuta:
gradle init
Gradle te hará algunas preguntas:
- Select type of project to generate: Elige
2: application. - Select implementation language: Elige
3: Java. - Split functionality across multiple subprojects?: Elige
1: no. - Select build script DSL: Elige
1: Groovy(es un excelente punto de partida, aunque también podrías elegir Kotlin). - Generate build using new APIs and behavior?: Elige
nopor ahora para mantenerlo simple. - Select test framework: Elige
4: JUnit Jupiter. - Project name y Source package: Presiona Enter para aceptar los valores por defecto.
¡Y listo! 🎉 Gradle ha creado una estructura de proyecto funcional:
.
├── build.gradle // El script de construcción principal
├── gradle
│ └── wrapper
├── gradlew // El ejecutable del Wrapper para Linux/macOS
├── gradlew.bat // El ejecutable del Wrapper para Windows
├── settings.gradle // Configuración de proyectos/subproyectos
└── src
├── main // Código fuente de la aplicación
│ └── java
└── test // Código fuente de las pruebas
El archivo más importante aquí es build.gradle. Ábrelo y verás algo así:
// build.gradle
plugins {
id 'java'
id 'application'
}
repositories {
mavenCentral()
}
dependencies {
testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
implementation 'com.google.guava:guava:32.1.3-jre' // Guava ya viene incluido
}
application {
mainClass = 'org.example.App'
}
Puedes ver los conceptos en acción: se aplican los plugins java y application, se declara el repositorio mavenCentral() para buscar dependencias y se especifica la dependencia de JUnit para las pruebas.
Ahora, ejecutemos algunas tareas básicas desde la terminal:
./gradlew build: Compila, prueba y empaqueta tu aplicación../gradlew run: Ejecuta la aplicación../gradlew clean: Borra el directoriobuildcon todos los artefactos generados.
El Corazón de Gradle: Un Vistazo a las Tareas
Todo lo que hace Gradle es a través de tareas. Puedes definir las tuyas de forma muy sencilla. Añade esto al final de tu build.gradle:
// Tarea personalizada
task miPrimeraTarea {
doLast {
println '¡Hola desde mi primera tarea en Gradle!'
}
}
Ahora ejecuta ./gradlew miPrimeraTarea y verás tu mensaje. Las tareas tienen un ciclo de vida, siendo doFirst y doLast las acciones que puedes añadir al principio o al final de su ejecución.
Más importante aún es cómo las tareas se relacionan. Puedes hacer que una tarea dependa de otra:
task tareaB {
doLast { println 'Soy la tarea B' }
}
task tareaA(dependsOn: tareaB) {
doLast { println 'Soy la tarea A, y me ejecuto después de la B' }
}
Esta capacidad de crear un grafo de dependencias es lo que permite a Gradle ser tan eficiente. Además, gracias a los inputs y outputs de las tareas, Gradle sabe si el trabajo ya está hecho (UP-TO-DATE) y puede saltarse la ejecución, ahorrando un tiempo valiosísimo.
El Poder de la Reutilización: Introducción a los Plugins
Escribir la misma lógica de construcción en cada proyecto es tedioso. Los plugins son la solución para encapsular y reutilizar esta lógica. Ya los has usado (id 'java'). Existen tres tipos principales:
- Script Plugins: Un script de Gradle (
otro.gradle) que importas en tubuild.gradle. Útil para lógicas simples dentro de un mismo proyecto. - Precompiled Script Plugins: Scripts
.gradle.ktso.gradleque se compilan y empaquetan, permitiendo una mejor organización. - Binary Plugins: El enfoque profesional. Son clases (en Java, Groovy o Kotlin) que implementan la interfaz
Plugin. Se distribuyen como archivos.jary son el objetivo final de nuestra serie de artículos.
Conclusión y Próximos Pasos
¡Felicidades! Has dado un paso gigante. Ahora entiendes que Gradle es un sistema de construcción programable y altamente flexible, has configurado tu entorno, has creado y ejecutado tu primer proyecto Java y has escarbado en la superficie de sus conceptos más importantes: las tareas y los plugins.
Esta base sólida es el cimiento sobre el que construiremos nuestro conocimiento. Hemos sentado las bases teóricas y prácticas para entender no solo qué hace Gradle, sino cómo piensa.
En nuestra próxima entrega, daremos el siguiente paso lógico y emocionante: comenzaremos a construir nuestro propio plugin binario desde cero. Exploraremos la estructura de un proyecto de plugin, aprenderemos a crear configuraciones personalizadas para que los usuarios puedan ajustarlo y definiremos nuestras primeras tareas encapsuladas. ¡La verdadera aventura de la automatización está a punto de comenzar!