Semantische Versionierung anwenden

Disclaimer

Die semantische Versionierung ist ein weit verbreiteter Standard zur Vergabe von Versionsnummern in der Softwareentwicklung. Sie hilft dabei, Änderungen am Code verständlich und nachvollziehbar zu kennzeichnen und erleichtert so die Verwaltung von Software-Abhängigkeiten sowie 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