Kotlin Academy · Aula

Catálogos de Versões

Gerencie as versões das dependências

Catálogos de Versões é uma aula grátis de Kotlin Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Kotlin Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Kotlin Academy inclui 4 aulas no total.

O Problema das Versões Espalhadas

Em projetos com vários módulos, as versões das dependências são duplicadas em muitos arquivos de compilação. Atualizar uma biblioteca significa editar vários locais — o que é propenso a erros e gera inconsistências.

O que é um Catálogo de Versões?

Um catálogo de versões centraliza as coordenadas e as versões das dependências em um único local. O Gradle gera um acessador com segurança de tipos, que você referencia em qualquer módulo.

O Arquivo libs.versions.toml

O catálogo padrão fica em gradle/libs.versions.toml. Ele tem seções para versões, bibliotecas, plug-ins e pacotes.

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

Declarando Bibliotecas

A seção [libraries] mapeia um alias para coordenadas, referenciando uma versão pelo 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" }

Usando uma Biblioteca em build.gradle.kts

Referencie as entradas do catálogo por meio do acessador libs gerado. Os hífens se transformam em pontos.

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

Declarando Plug-ins

A seção [plugins] centraliza os identificadores e as versões dos plug-ins.

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

Aplicando Plug-ins do Catálogo

Referencie os plug-ins do catálogo no bloco plugins { } com a função alias.

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

Pacotes

Um pacote agrupa bibliotecas relacionadas para que você possa adicioná-las com um único acessador.

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

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

Segurança de Tipos e Preenchimento Automático

Como libs é código gerado, o ambiente de desenvolvimento oferece preenchimento automático para as entradas, e a compilação falha rapidamente se você referenciar um alias inexistente — é muito mais seguro do que usar cadeias de caracteres brutas.

Regras de Nomenclatura

Os aliases usam hífens ou pontos como separadores, que são mapeados para acessadores aninhados. coroutines-core se torna libs.coroutines.core. Evite sublinhados.

Compartilhando entre Módulos

O único arquivo TOML fica automaticamente visível para todos os módulos. Atualize uma versão uma vez e todos os módulos a utilizarão — esse é o principal benefício dos catálogos.

Verificação Rápida

Qual é a principal vantagem de um catálogo de versões em um projeto com vários módulos?

Recapitulação

Os catálogos de versões simplificam o gerenciamento de dependências:

Declare versões, bibliotecas, plug-ins e pacotes em gradle/libs.versions.toml
Faça referências por meio do acessador libs com segurança de tipos e de alias(...)
Uma única edição atualiza todos os módulos

Isso conclui o curso de Gradle.

Perguntas Frequentes

A aula “Catálogos de Versões” é grátis?

Sim — o texto completo de “Catálogos de Versões” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Kotlin Academy, atualize para CoddyKit PRO. O curso de Kotlin Academy inclui 4 aulas no total.

O que vou aprender em “Catálogos de Versões”?

Gerencie as versões das dependências Você pratica Kotlin Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Kotlin Academy?

Nenhuma experiência prévia é necessária. Kotlin Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Catálogos de Versões”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Kotlin Academy?

Sim. Cada aula de Kotlin Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Kotlin Academy