Gestion des versions et stabilité de l’API
Gérez les changements incompatibles et le contrat de l’API publique.
Gestion des versions et stabilité de l’API est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Kotlin Multiplatform Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
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. 🎉
Questions Fréquemment Posées
La leçon « Gestion des versions et stabilité de l’API » est-elle gratuite ?
Oui — le texte complet de « Gestion des versions et stabilité de l’API » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Kotlin Multiplatform Academy, passe à CoddyKit PRO. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Gestion des versions et stabilité de l’API » ?
Gérez les changements incompatibles et le contrat de l’API publique. Tu pratiques Kotlin Multiplatform Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Kotlin Multiplatform Academy ?
Aucune expérience préalable n'est requise. Kotlin Multiplatform Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.
Combien de temps prend la leçon « Gestion des versions et stabilité de l’API » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Kotlin Multiplatform Academy ?
Oui. Chaque leçon Kotlin Multiplatform Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Configurer maven-publish pour KMP
- Livrer un XCFramework pour iOS
- Gestion des versions et stabilité de l’API
- Publier sur Maven Central et SPM