Kotlin Academy · Lekcja

Katalogi wersji

Zarządzaj wersjami zależności

Katalogi wersji to bezpłatna lekcja Kotlin Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Kotlin Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Problem z rozproszonymi wersjami

W projektach wielomodułowych wersje zależności są powielane w wielu plikach kompilacji. Aktualizacja jednej biblioteki oznacza edycję wielu miejsc — jest podatna na błędy i prowadzi do niespójności.

Czym jest katalog wersji?

Katalog wersji centralizuje współrzędne zależności i ich wersje w jednym miejscu. Gradle generuje bezpieczny typowo accessor, do którego można odwołać się z dowolnego modułu.

Plik libs.versions.toml

Domyślny katalog znajduje się w pliku gradle/libs.versions.toml. Zawiera sekcje wersji, bibliotek, wtyczek i pakietów.

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

Deklarowanie bibliotek

Sekcja [libraries] przypisuje alias do współrzędnych biblioteki, odwołując się do wersji po nazwie.

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

Używanie biblioteki w build.gradle.kts

Odwołuj się do wpisów katalogu za pomocą wygenerowanego accessora libs. Myślniki są zamieniane na kropki.

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

Deklarowanie wtyczek

Sekcja [plugins] centralizuje identyfikatory wtyczek i ich wersje.

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

Stosowanie wtyczek z katalogu

Odwołuj się do wtyczek katalogu w bloku plugins { } za pomocą funkcji alias.

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

Pakiety

Pakiet grupuje powiązane biblioteki, dzięki czemu można dodać je za pomocą jednego accessora.

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

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

Bezpieczeństwo typów i autouzupełnianie

Ponieważ libs jest wygenerowanym kodem, IDE automatycznie uzupełnia wpisy, a kompilacja natychmiast kończy się błędem w przypadku odwołania do nieistniejącego aliasu — jest to znacznie bezpieczniejsze niż zwykłe ciągi znaków.

Zasady nazewnictwa

Aliasy używają myślników lub kropek jako separatorów, które są mapowane na zagnieżdżone accessors. coroutines-core staje się libs.coroutines.core. Unikaj znaków podkreślenia.

Udostępnianie między modułami

Pojedynczy plik TOML jest automatycznie widoczny dla każdego modułu. Zaktualizuj wersję raz, a wszystkie moduły ją przejmą — to główna zaleta katalogów.

Szybki test

Jaka jest główna zaleta katalogu wersji w projekcie wielomodułowym?

Podsumowanie

Katalogi wersji porządkują zarządzanie zależnościami:

Deklarowanie wersji, bibliotek, wtyczek i pakietów w pliku gradle/libs.versions.toml
Odwoływanie się do nich za pomocą bezpiecznego typowo accessora libs i funkcji alias(...)
Jedna edycja aktualizuje każdy moduł

To kończy kurs Gradle.

Często zadawane pytania

Czy lekcja „Katalogi wersji” jest bezpłatna?

Tak — pełny tekst „Katalogi wersji” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Kotlin Academy, przejdź na CoddyKit PRO. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Katalogi wersji”?

Zarządzaj wersjami zależności Ćwiczysz Kotlin Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Kotlin Academy?

Nie wymagamy żadnego doświadczenia. Kotlin Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Katalogi wersji”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Kotlin Academy?

Tak. Każda lekcja Kotlin Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Kotlin Academy