Semantische Versionierung anwenden

Disclaimer

Die semantische Versionierung ist ein ~~weit verbreiteter~~gängiger Standard ~~zur Vergabe von Versionsnummern~~ in der ~~Softwareentwicklung.~~Softwareentwicklung, um Versionsnummern zu vergeben. Sie ~~hilft dabei,~~macht Änderungen amim Code ~~verständlich~~nachvollziehbar, erleichtert den Umgang mit Abhängigkeiten und ~~nachvollziehbar zu kennzeichnen und erleichtert so die Verwaltung von Software-Abhängigkeiten sowie~~verbessert die Kommunikation über den Entwicklungsstand.

Weitere Informationen: semver.org

Was ist die semantische Versionierung?

Die semantische Versionierung beschreibt ein dreiteiliges Versionsschema:

MAJOR.MINOR.PATCH

MAJOR: Inkompatible Änderungen der öffentlichen API
MINOR: Neue, abwärtskompatible Funktionalitäten
PATCH: Abwärtskompatible Fehlerbehebungen

Beispiele aus der Praxis

1.2.3: Erste stabile Version, zwei kleinere Feature-Erweiterungen, drei Bugfixes
2.0.0: Führt zu inkompatiblen API-Änderungen, z. B. durch Entfernen oder Umbenennen von Funktionen
1.3.0: Fügt neue Funktionalitäten hinzu, ohne vorhandene zu verändern
1.3.1: Behebt einen Fehler aus der Version 1.3.0

Regeln der semantischen Versionierung

Erhöhe die MAJOR-Version bei inkompatiblen API-Änderungen
Erhöhe die MINOR-Version bei neuen, abwärtskompatiblen Funktionen
Erhöhe die PATCH-Version bei abwärtskompatiblen Bugfixes

Vorabversionen und Build-Metadaten

Zusätzlich können Vorabversionen und Build-Metadaten angegeben werden:

1.0.0-alpha
1.0.0-beta+exp.sha.5114f85

Vorabversionen: -alpha, -beta, -rc usw. – für nicht stabile Entwicklungsstände
Build-Metadaten: +build – zusätzliche Informationen wie Git-Hashes oder Build-Zeitpunkte

Zusammenfassung

Die semantische Versionierung gibt eine klare Struktur für Versionen vor
Sie erleichtert das Management von Abhängigkeiten in Projekten
Sie wird häufig in Kombination mit Conventional Commits verwendet