Versionierung und API-Stabilität
Verwalten Sie Breaking Changes und einen Vertrag für die öffentliche API.
Versionierung und API-Stabilität ist eine kostenlose Kotlin Multiplatform Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Kotlin Multiplatform Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Kotlin Multiplatform Academy-Kurs umfasst insgesamt 4 Lektionen.
Eine Version ist ein Versprechen
Wenn Teams von Ihrer Bibliothek abhängen, teilt ihnen Ihre Versionsnummer mit, was sie von einem Upgrade erwarten können. Betrachten Sie sie als Vertrag, nicht als Schätzung. 🤝
Semantische Versionierung
SemVer verwendet drei Zahlen: Major, Minor und Patch. Jeder Teil signalisiert allen, die von Ihrem Code abhängen, eine andere Art von Änderung.
version = "2.4.1"Patch für Fehlerbehebungen
Erhöhen Sie die Patch-Nummer für abwärtskompatible Fehlerbehebungen. Konsumenten können ohne Änderungen an ihrem Code bedenkenlos aktualisieren.
Minor für Features
Erhöhen Sie die Minor-Nummer, wenn Sie neue Funktionen hinzufügen, ohne etwas inkompatibel zu machen. Alte Aufrufstellen funktionieren weiterhin wie zuvor.
Major für inkompatible Änderungen
Erhöhen Sie die Major-Nummer bei jeder inkompatiblen Änderung. Das warnt beide Teams, dass ein Upgrade Anpassungen an ihrem Code erfordern kann.
Ihre öffentliche API ist die Grenze
Stabilität wird anhand Ihrer öffentlichen Oberfläche beurteilt. Wenn Sie eine öffentliche Funktion umbenennen, gehen Aufrufer kaputt; eine Änderung an einer privaten Hilfsfunktion hingegen nicht.
Verbergen Sie, was sich ändern könnte
Markieren Sie instabilen Code als internal, damit er nicht Teil des Vertrags wird. Sie können ihn frei umstrukturieren, ohne die Major-Version erhöhen zu müssen.
internal fun buildCache() { }Vor dem Entfernen veralten lassen
Geben Sie Aufrufern mit @Deprecated einen sanften Übergang. Der Build funktioniert weiterhin, eine Warnung wird angezeigt und es wird mitgeteilt, was stattdessen verwendet werden soll.
@Deprecated("Use greet(name)")
fun greeting() = greet("there")Einen Ersatz vorschlagen
Kombinieren Sie die Veraltung mit einem ReplaceWith-Hinweis, damit die IDE alte Aufrufstellen automatisch korrigieren kann. Die Migration wird so zu einem einzigen Klick.
@Deprecated("Renamed", ReplaceWith("greet(name)"))Auf versehentliche inkompatible Änderungen achten
Selbst eine neue Reihenfolge der Parameter kann Aufrufer in Swift beeinträchtigen. Überwachen Sie Ihre API mit einem Dump-Tool, damit unerwartete Änderungen im Review auffallen.
Changelog pflegen
Ein übersichtlicher Changelog listet die Änderungen pro Version auf. So planen die Android- und iOS-Teams Upgrades mit Zuversicht statt mit Sorge.
Kurzer Check
Prüfen wir Ihr Gespür für Versionierung.
Zusammenfassung
Halten Sie sich an SemVer, schützen Sie Ihre öffentliche API, verbergen Sie instabilen Code als internal, kennzeichnen Sie veraltete Elemente sorgfältig und pflegen Sie einen Changelog, dem beide Teams vertrauen. 🎉
Lerne Kotlin mit einem KI-Tutor — kostenlos
Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.
- Kurse
- 30
- Lektionen
- 120
Häufig gestellte Fragen
Ist die Lektion „Versionierung und API-Stabilität“ kostenlos?
Ja — der vollständige Text von „Versionierung und API-Stabilität“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Kotlin Multiplatform Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Kotlin Multiplatform Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Versionierung und API-Stabilität“?
Verwalten Sie Breaking Changes und einen Vertrag für die öffentliche API. Du übst Kotlin Multiplatform Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Kotlin Multiplatform Academy zu starten?
Keine Vorkenntnisse erforderlich. Kotlin Multiplatform Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „Versionierung und API-Stabilität“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Kotlin Multiplatform Academy-Lektion Code schreiben und ausführen?
Ja. Jede Kotlin Multiplatform Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- maven-publish für KMP konfigurieren
- Ein XCFramework für iOS ausliefern
- Versionierung und API-Stabilität
- Auf Maven Central und SPM veröffentlichen