Kotlin Academy · Lección

Catálogos de versiones

Gestione las versiones de las dependencias

Catálogos de versiones es una lección gratuita de Kotlin Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Academy incluye 4 lecciones en total.

El problema de las versiones dispersas

En los proyectos con varios módulos, las versiones de las dependencias se duplican en muchos archivos de compilación. Actualizar una biblioteca implica editar muchos lugares, lo que puede provocar errores e inconsistencias.

¿Qué es un catálogo de versiones?

Un catálogo de versiones centraliza las coordenadas y versiones de las dependencias en un solo lugar. Gradle genera un accesorio con seguridad de tipos al que puede hacer referencia desde cualquier módulo.

El archivo libs.versions.toml

El catálogo predeterminado se encuentra en gradle/libs.versions.toml. Contiene secciones para versiones, bibliotecas, plugins y grupos.

[versions]
kotlin = "2.0.0"
coroutines = "1.8.1"

Declarar bibliotecas

La sección [libraries] asigna un alias a unas coordenadas y hace referencia a una versión por su nombre.

[libraries]
coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
guava = { module = "com.google.guava:guava", version = "33.2.1-jre" }

Usar una biblioteca en build.gradle.kts

Haga referencia a las entradas del catálogo mediante el accesorio libs generado. Los guiones se convierten en puntos.

dependencies {
    implementation(libs.coroutines.core)
    implementation(libs.guava)
}

Declarar plugins

La sección [plugins] centraliza los ids y las versiones de los plugins.

[plugins]
kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }

Aplicar plugins del catálogo

Haga referencia a los plugins del catálogo en el bloque plugins { } con la función alias.

plugins {
    alias(libs.plugins.kotlin.jvm)
    alias(libs.plugins.serialization)
}

Grupos

Un grupo reúne bibliotecas relacionadas para añadirlas mediante un solo accesorio.

[bundles]
testing = ["junit", "mockk"]

// build.gradle.kts:
// testImplementation(libs.bundles.testing)

Seguridad de tipos y autocompletado

Como libs es código generado, el IDE completa automáticamente las entradas y la compilación falla de inmediato si hace referencia a un alias inexistente, lo que es mucho más seguro que usar cadenas sin procesar.

Reglas de nomenclatura

Los alias usan guiones o puntos como separadores, que se asignan a accesorios anidados. coroutines-core se convierte en libs.coroutines.core. Evite los guiones bajos.

Compartir entre módulos

Todos los módulos pueden ver automáticamente el único archivo TOML. Actualice una versión una sola vez y todos los módulos la incorporarán: ese es el principal beneficio de los catálogos.

Comprobación rápida

¿Cuál es la principal ventaja de un catálogo de versiones en un proyecto con varios módulos?

Resumen

Los catálogos de versiones simplifican la gestión de dependencias:

Declare versiones, bibliotecas, plugins y grupos en gradle/libs.versions.toml
Haga referencia a ellos mediante el accesorio libs con seguridad de tipos y alias(...)
Una sola edición actualiza todos los módulos

Con esto finaliza el curso de Gradle.

Preguntas frecuentes

¿La lección «Catálogos de versiones» es gratis?

Sí — el texto completo de «Catálogos de versiones» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Academy, actualiza a CoddyKit PRO. El curso de Kotlin Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Catálogos de versiones»?

Gestione las versiones de las dependencias Practicas Kotlin Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Kotlin Academy?

No se requiere experiencia previa. Kotlin Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Catálogos de versiones»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Kotlin Academy?

Sí. Cada lección de Kotlin Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Kotlin Academy