Kotlin Multiplatform Academy · Lección

Versionado y estabilidad de la API

Gestione cambios incompatibles y un contrato de API pública.

Versionado y estabilidad de la API es una lección gratuita de Kotlin Multiplatform Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Multiplatform Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Multiplatform Academy incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en 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. 🎉

Preguntas frecuentes

¿La lección «Versionado y estabilidad de la API» es gratis?

Sí — el texto completo de «Versionado y estabilidad de la API» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Multiplatform Academy, actualiza a CoddyKit PRO. El curso de Kotlin Multiplatform Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Versionado y estabilidad de la API»?

Gestione cambios incompatibles y un contrato de API pública. Practicas Kotlin Multiplatform Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Kotlin Multiplatform Academy?

No se requiere experiencia previa. Kotlin Multiplatform Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Versionado y estabilidad de la API»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Kotlin Multiplatform Academy?

Sí. Cada lección de Kotlin Multiplatform Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Kotlin Multiplatform Academy