Agregar dependencias Version Catalogs: libs.versions.toml

Que es Version Catalog

El Version Catalog es una funcionalidad de Gradle que permite centralizar y gestionar las versiones de las dependencias y los plugins de un proyecto en un único archivo, generalmente llamado libs.versions.toml. Este enfoque hace que la configuración de dependencias sea más eficiente y fácil de mantener, ya que todas las versiones se definen en un solo lugar.

Características principales:

1. Centralización: Las versiones de las dependencias y plugins se declaran en un solo archivo, lo que permite tener un control más claro de las versiones usadas en todo el proyecto.
2. Reutilización: Permite reutilizar las mismas dependencias en diferentes módulos sin tener que declararlas varias veces.
3. Actualizaciones simplificadas: Al tener las versiones centralizadas, actualizar las dependencias es más sencillo y evita inconsistencias en diferentes partes del proyecto.
4. Auto-completado: Gradle proporciona auto-completado en los entornos de desarrollo como Android Studio, facilitando la escritura de dependencias sin errores.

Cómo es su implementación de Version Catalog en un proyecto Android

El archivo libs.versions.toml sigue el formato TOML y contiene bloques donde se definen las versiones y bibliotecas. Un ejemplo de cómo podría verse este archivo es el siguiente:

toml

[versions]
kotlin = "1.5.21"
coroutines = "1.5.0"

[libraries]
kotlin-stdlib = { group = "org.jetbrains.kotlin", name = "kotlin-stdlib", version.ref = "kotlin" }
coroutines-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-core", version.ref = "coroutines" }

Gradle utiliza estas definiciones para aplicar las dependencias a los módulos del proyecto.

Esta funcionalidad se volvió estable en Gradle 7.4, aunque fue introducida en Gradle 7.0​

Ejemplos de Dependencias

El archivo libs.versions.toml es parte del sistema de gestión de dependencias en Gradle conocido como Version Catalogs, que permite gestionar versiones de dependencias de manera centralizada y reutilizable. Para agregar nuevas dependencias a este archivo en Android Studio, debes seguir estos pasos:

1. Abrir el archivo libs.versions.toml:
   Este archivo se suele encontrar en la ruta gradle/libs.versions.toml. Si no lo tienes, puedes crearlo manualmente o habilitar los Version Catalogs en tu proyecto.

2. Agregar las versiones de las dependencias: Dentro de este archivo, defines las versiones de las dependencias que usarás en tu proyecto. La sintaxis básica es:

   toml

   [versions]
   kotlin = "1.8.0"
   retrofit = "2.9.0"
   glide = "4.16.0"

   Aquí defines las versiones que usarás más adelante.

3. Agregar las dependencias: Luego, defines las dependencias usando las versiones que has declarado anteriormente.

   toml

   [libraries]
   kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }
   retrofit = { module = "com.squareup.retrofit2:retrofit", version.ref = "retrofit" }
   glide = { module = "com.github.bumptech.glide:glide", version.ref = "glide" }
   

   • module: Especifica el identificador del módulo de la dependencia.
   • version.ref: Se refiere a la versión definida en la sección [versions].

4. Incluir las dependencias en tu build.gradle: Luego, en los archivos build.gradle puedes referenciar las dependencias de la siguiente manera:

   groovy

   dependencies {
       implementation(libs.kotlin.stdlib)
       implementation(libs.retrofit)
       implementation(libs.glide)
   }
   

   Aquí, libs se refiere a las dependencias definidas en libs.versions.toml.

Este enfoque te permite tener un control más claro y centralizado de las versiones de dependencias, simplificando el mantenimiento del proyecto.

Desde que version de android esta disponible el versions catalogs

El Version Catalog de Gradle, que permite la gestión centralizada de dependencias usando el archivo libs.versions.toml, se introdujo en Gradle 7.0. Sin embargo, se estabilizó y se volvió más práctico a partir de Gradle 7.4.

Para proyectos Android, esta funcionalidad está disponible a partir del Android Gradle Plugin (AGP) 7.0, lo que corresponde a Android Studio Arctic Fox (2020.3.1) y versiones posteriores, que son compatibles con Gradle 7.x. Por lo tanto, puedes utilizar Version Catalog en tu proyecto Android siempre que uses una versión compatible de Android Studio y AGP.

Si tienes una versión más antigua de Gradle o Android Studio, necesitarás actualizar tu entorno para aprovechar esta funcionalidad.

Leido 193 veces