Kotlin Academy · Leçon

Catalogues de versions

Gérer les versions des dépendances

Catalogues de versions est une leçon Kotlin Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Kotlin Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Academy comprend 4 leçons au total.

Le problème des versions dispersées

Dans les projets multi-modules, les versions des dépendances sont dupliquées dans de nombreux fichiers de compilation. Mettre à jour une bibliothèque implique de modifier de nombreux emplacements : c’est source d’erreurs et d’incohérences.

Qu’est-ce qu’un catalogue de versions ?

Un catalogue de versions centralise les coordonnées et les versions des dépendances en un seul endroit. Gradle génère un accesseur avec vérification de type, que vous pouvez utiliser depuis n’importe quel module.

Le fichier libs.versions.toml

Le catalogue par défaut se trouve à l’emplacement gradle/libs.versions.toml. Il comporte des sections pour les versions, les bibliothèques, les plugins et les ensembles.

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

Déclaration des bibliothèques

La section [libraries] associe un alias à des coordonnées, en faisant référence à une version par son nom.

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

Utilisation d’une bibliothèque dans build.gradle.kts

Référencez les entrées du catalogue via l’accesseur libs généré. Les tirets deviennent des points.

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

Déclaration des plugins

La section [plugins] centralise les identifiants et les versions des plugins.

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

Application des plugins du catalogue

Référencez les plugins du catalogue dans le bloc plugins { } avec la fonction alias.

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

Ensembles

Un ensemble regroupe des bibliothèques liées afin que vous puissiez les ajouter avec un seul accesseur.

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

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

Sécurité des types et autocomplétion

Comme libs est du code généré, l’IDE complète automatiquement les entrées et la compilation échoue immédiatement si vous référencez un alias inexistant : c’est bien plus sûr que des chaînes brutes.

Règles de nommage

Les alias utilisent des tirets ou des points comme séparateurs, ce qui correspond à des accesseurs imbriqués. coroutines-core devient libs.coroutines.core. Évitez les traits de soulignement.

Partage entre les modules

L’unique fichier TOML est automatiquement visible par tous les modules. Mettez une version à jour une seule fois et tous les modules la récupèrent : c’est le principal avantage des catalogues.

Vérification rapide

Quel est le principal avantage d’un catalogue de versions dans un projet multi-module ?

Récapitulatif

Les catalogues de versions simplifient la gestion des dépendances :

Déclarer les versions, les bibliothèques, les plugins et les ensembles dans gradle/libs.versions.toml
Référencer ces éléments via l’accesseur libs avec vérification de type et alias(...)
Une seule modification met à jour chaque module

Le cours Gradle est maintenant terminé.

Questions Fréquemment Posées

La leçon « Catalogues de versions » est-elle gratuite ?

Oui — le texte complet de « Catalogues de versions » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Kotlin Academy, passe à CoddyKit PRO. Le cours Kotlin Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Catalogues de versions » ?

Gérer les versions des dépendances Tu pratiques Kotlin Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Kotlin Academy ?

Aucune expérience préalable n'est requise. Kotlin Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Catalogues de versions » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Kotlin Academy ?

Oui. Chaque leçon Kotlin Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Kotlin Academy