Kotlin Multiplatform Academy · Aula

Versionamento e estabilidade da API

Gerencie alterações incompatíveis e um contrato de API pública.

Versionamento e estabilidade da API é uma aula grátis de Kotlin Multiplatform Academy no CoddyKit. Esta é a aula 3 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 Multiplatform Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

A Version Is a Promise

When teams depend on your library, your version number tells them what to expect from an upgrade. Treat it as a contract, not a guess. 🤝

Semantic Versioning

SemVer uses three numbers: major, minor, and patch. Each part signals a different kind of change to anyone depending on your code.

version = "2.4.1"

Patch for Fixes

Bump the patch number for backward-compatible bug fixes. Consumers can upgrade freely with no code changes on their side.

Minor for Features

Raise the minor number when you add new functionality without breaking anything. Old call sites keep working as before.

Major for Breaks

Increase the major number for any breaking change. This warns both teams that upgrading may require edits to their code.

Your Public API Is the Line

Stability is judged by your public surface. Renaming a public function breaks callers, but changing a private helper does not.

Hide What May Change

Mark unstable code internal so it stays out of the contract. You can refactor it freely without bumping the major version.

internal fun buildCache() { }

Deprecate Before Removing

Give callers a soft landing with @Deprecated. They keep building, see a warning, and get told what to use instead.

@Deprecated("Use greet(name)")
fun greeting() = greet("there")

Suggest a Replacement

Pair the deprecation with a ReplaceWith hint so the IDE can auto-fix old call sites. Migration becomes a single click.

@Deprecated("Renamed", ReplaceWith("greet(name)"))

Watch for Accidental Breaks

Even reordering parameters can break Swift callers. Track your API with a dump tool so surprise changes get caught in review.

Keep a Changelog

A clear changelog lists what changed per version. Both Android and iOS teams plan upgrades with confidence instead of fear.

Quick Check

Let's check your versioning instincts.

Recap

Follow SemVer, guard your public API, hide unstable code as internal, deprecate kindly, and keep a changelog both teams trust. 🎉

Perguntas Frequentes

A aula “Versionamento e estabilidade da API” é grátis?

Sim — o texto completo de “Versionamento e estabilidade da API” é 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 Multiplatform Academy, atualize para CoddyKit PRO. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.

O que vou aprender em “Versionamento e estabilidade da API”?

Gerencie alterações incompatíveis e um contrato de API pública. Você pratica Kotlin Multiplatform 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 Multiplatform Academy?

Nenhuma experiência prévia é necessária. Kotlin Multiplatform 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 3 de 4.

Quanto tempo leva a aula “Versionamento e estabilidade da API”?

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 Multiplatform Academy?

Sim. Cada aula de Kotlin Multiplatform 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 Multiplatform Academy