Kotlin Academy · Lezione

Cataloghi delle versioni

Gestisca le versioni delle dipendenze

Cataloghi delle versioni è una lezione Kotlin Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Academy include 4 lezioni in totale.

Il problema delle versioni distribuite

Nei progetti multi-modulo, le versioni delle dipendenze vengono duplicate in numerosi file di build. Aggiornare una libreria significa modificare molti punti: una procedura soggetta a errori e incoerenze.

Che cos'è un catalogo delle versioni?

Un catalogo delle versioni centralizza le coordinate e le versioni delle dipendenze in un unico punto. Gradle genera un accessor type-safe che può essere utilizzato da qualsiasi modulo.

Il file libs.versions.toml

Il catalogo predefinito si trova in gradle/libs.versions.toml. Contiene sezioni per versioni, librerie, plugin e bundle.

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

Dichiarazione delle librerie

La sezione [libraries] associa un alias alle coordinate, facendo riferimento a una versione tramite il relativo nome.

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

Utilizzo di una libreria in build.gradle.kts

Faccia riferimento alle voci del catalogo tramite l'accessor libs generato. I trattini diventano punti.

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

Dichiarazione dei plugin

La sezione [plugins] centralizza gli id e le versioni dei plugin.

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

Applicazione dei plugin del catalogo

Faccia riferimento ai plugin del catalogo nel blocco plugins { } tramite la funzione alias.

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

Bundle

Un bundle raggruppa librerie correlate, così può aggiungerle tramite un singolo accessor.

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

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

Type safety e completamento automatico

Poiché libs è codice generato, l'IDE completa automaticamente le voci e la build segnala subito un errore se si fa riferimento a un alias inesistente: è molto più sicuro delle stringhe non tipizzate.

Regole di denominazione

Gli alias utilizzano trattini o punti come separatori, che vengono convertiti in accessor annidati. coroutines-core diventa libs.coroutines.core. Eviti gli underscore.

Condivisione tra i moduli

Il singolo file TOML è automaticamente visibile a ogni modulo. Aggiorni una versione una sola volta e tutti i moduli la utilizzeranno: questo è il principale vantaggio dei cataloghi.

Verifica rapida

Qual è il principale vantaggio di un catalogo delle versioni in un progetto multi-modulo?

Riepilogo

I cataloghi delle versioni semplificano la gestione delle dipendenze:

Dichiarano versioni, librerie, plugin e bundle in gradle/libs.versions.toml
Consentono di fare riferimento alle voci tramite l'accessor type-safe libs e alias(...)
Una sola modifica aggiorna ogni modulo

Il corso su Gradle è completo.

Domande Frequenti

La lezione «Cataloghi delle versioni» è gratuita?

Sì — il testo completo di «Cataloghi delle versioni» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Academy, passa a CoddyKit PRO. Il corso Kotlin Academy include 4 lezioni in totale.

Cosa imparerò in «Cataloghi delle versioni»?

Gestisca le versioni delle dipendenze Eserciti Kotlin Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Kotlin Academy?

Non è richiesta alcuna esperienza precedente. Kotlin Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Cataloghi delle versioni»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Kotlin Academy?

Sì. Ogni lezione Kotlin Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Kotlin Academy