Tareas predefinidas

⏱ Dedicación recomendada: 0 minutos
Esto considera el contenido visible y relevante, e ignora texto colapsado o marcado como opcional.

r8vnhill/

Uno de los beneficios más importantes de usar un build system como Gradle es que muchas tareas comunes ya vienen definidas y listas para usar. Estas tareas predefinidas permiten compilar código, ejecutar pruebas, limpiar artefactos generados o empaquetar el proyecto sin necesidad de escribir configuraciones desde cero.

En el contexto del desarrollo de bibliotecas, estas tareas nos ayudan a establecer un flujo de trabajo claro y reproducible desde las primeras etapas del proyecto. Por ejemplo, podemos ejecutar una tarea para compilar la biblioteca, otra para correr las pruebas y otra para generar los artefactos que luego serán publicados o consumidos por otras aplicaciones.

En esta lección exploraremos las tareas predefinidas más importantes que ofrece Gradle, veremos cómo se usan, qué hacen internamente y cómo se pueden adaptar a las necesidades de tu biblioteca. Esta base será esencial antes de crear tareas personalizadas en futuras lecciones.

📋 Listar tareas

Antes de explorar las tareas predefinidas, es útil saber cómo descubrir todas las tareas disponibles en un proyecto Gradle. Esto te permite entender qué acciones puedes ejecutar sin necesidad de revisar todo el código o la configuración manualmente.

Para obtener una lista organizada de las tareas disponibles, ejecuta el siguiente comando desde la raíz del proyecto:

./gradlew tasks

Gradle mostrará un resumen categorizado de las tareas registradas, incluyendo tanto las tareas predefinidas como las personalizadas que hayan sido agregadas al proyecto.

Tarea `build`

La tarea build es una de las más usadas en Gradle. Se encarga de ejecutar una serie de subtareas que incluyen la compilación del código fuente, la ejecución de pruebas y la generación de artefactos (como un JAR). Al ejecutar:

./gradlew build

Gradle realizará todas las operaciones necesarias para compilar y construir el proyecto.

Tarea `clean`

La tarea clean elimina todos los archivos generados durante la compilación, dejando el proyecto en un estado limpio. Esto es útil cuando deseas hacer una compilación completa desde cero. Al ejecutar:

./gradlew clean

Gradle eliminará los directorios de salida como build/ y otros archivos generados.

Tarea `assemble`

La tarea assemble compila y empaqueta la aplicación, pero no ejecuta las pruebas. Esto es útil cuando solo necesitas generar los artefactos de salida. Se ejecuta con:

./gradlew assemble

Gradle compilará y empaquetará el proyecto sin ejecutar pruebas.

Tarea `check`

La tarea check ejecuta todas las pruebas y verificaciones de calidad del código. Incluye pruebas unitarias, análisis estático de código y otras validaciones que el proyecto tenga definidas. Para ejecutar esta tarea, utiliza:

./gradlew check

Gradle verificará que todo el código cumple con las pruebas y las reglas de calidad.

Configuración de Tareas por Defecto

Gradle permite personalizar tareas predefinidas para ajustarlas a las necesidades del proyecto. Por ejemplo, la tarea test se puede configurar para especificar el framework de pruebas, los eventos a registrar y otros detalles.

convention-plugins/src/main/kotlin/jvm.conventions.gradle.kts
tasks.test {
    useJUnitPlatform()
    testLogging {
        events("passed", "skipped", "failed")
        showStandardStreams = true
    }
}

En este caso, se configura la tarea test para usar JUnit como framework de pruebas y registrar eventos de pruebas pasadas, omitidas y fallidas.

¿Qué aprendimos?

En esta lección, exploramos las tareas predefinidas en Gradle, que son fundamentales para automatizar y simplificar el proceso de construcción de software. A través de varios ejemplos, vimos cómo estas tareas ayudan a gestionar la compilación, empaquetado, pruebas y limpieza del proyecto de manera eficiente y estandarizada.

Puntos clave

Tareas predefinidas: Gradle proporciona tareas como build, clean, assemble, y check, las cuales son útiles para automatizar operaciones comunes en proyectos de software sin necesidad de configuraciones adicionales.
Personalización de tareas: Gradle permite configurar y personalizar tareas predefinidas para ajustarse a las necesidades específicas del proyecto, lo que proporciona flexibilidad y control sobre el proceso de construcción.
Ejecución automatizada: Al utilizar estas tareas, Gradle simplifica la automatización de procesos repetitivos, garantizando que las tareas se ejecuten de forma consistente y eficiente, lo que reduce errores y mejora la productividad.