0Pricing
Swift Academy · Lektion

Semantische Versionierung und Release-Tags

Wenden Sie Semantic Versioning (MAJOR.MINOR.PATCH) an, erstellen Sie annotierte git tags und referenzieren Sie Versionen in SwiftPM-Abhängigkeiten eindeutig.

Semantische Versionierung und Release-Tags ist eine kostenlose Swift Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 3. 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 Swift Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Swift Academy-Kurs umfasst insgesamt 3 Lektionen.

Was ist SemVer?

SemVer = MAJOR.MINOR.PATCH.

  • MAJOR: inkompatible Änderungen
  • MINOR: neue Funktionen, abwärtskompatibel
  • PATCH: Fehlerbehebungen, Dokumentation, kleinere Verbesserungen

Wann muss die Version erhöht werden?

Wählen Sie die richtige Erhöhung:

  • Öffentliche API entfernen oder umbenennen → MAJOR
  • Neue API ohne inkompatible Änderungen hinzufügen → MINOR
  • Interne Überarbeitungen oder Fehlerbehebungen → PATCH

Git-Tagging-Workflow

Erstellen Sie ein annotiertes Tag (z. B. v1.2.0) und übertragen Sie es. SwiftPM löst Pakete anhand von Git-Tags auf.

// Create an annotated tag and push it so SwiftPM can resolve it.
// Prereqs: tests pass; CHANGELOG updated.
//
//   git add -A
//   git commit -m "Release 1.2.0: new JSON helpers"
//   git tag -a v1.2.0 -m "v1.2.0"
//   git push --follow-tags
//
// Note: use the "v" prefix consistently (e.g., v1.2.0).
print("Tagged v1.2.0 and pushed with --follow-tags")

Versionsanforderungen in SwiftPM

Wählen Sie in Package.swift einen Stil für die Anforderung: from:, exact:, .upToNextMajor oder .upToNextMinor.

// Package.swift (illustrative dependency specs)
// dependencies: [
//   // Compatible with 1.x (>=1.2.0, <2.0.0)
//   .package(url: "https://example.com/Lib.git", from: "1.2.0"),
//
//   // Exact pin:
//   // .package(url: "https://example.com/Lib.git", exact: "1.2.3"),
//
//   // Up to next major (same as "from:"):
//   // .package(url: "https://example.com/Lib.git", .upToNextMajor(from: "1.2.0")),
//
//   // Up to next minor (>=1.2.0, <1.3.0):
//   // .package(url: "https://example.com/Lib.git", .upToNextMinor(from: "1.2.0"))
// ]
print("Declare dependency ranges clearly: from/exact/upToNextMajor/upToNextMinor")

CHANGELOG-Gewohnheiten

Fassen Sie die Änderungen für jede Version zusammen. Heben Sie BREAKING-Änderungen deutlich hervor, damit Benutzer sicher aktualisieren können.

// Keep a concise CHANGELOG with headings per version.
//
// # Changelog
// ## [1.2.0] - 2025-09-19
// - Add JSON.encodePretty(_:) (non-breaking)
// - Fix crash in Parser.parse() on empty input
//
// ## [2.0.0] - 2026-01-10
// - BREAKING: Renamed Parser.parse(_:) -> Parser.run(_:)
print("Write a short, helpful CHANGELOG for each release")

Tipps zu Vorabversionen

Vorabversionen (z. B. 2.0.0-beta.1) signalisieren Instabilität. Vermeiden Sie das Tagging, wenn Benutzer diese Versionen nicht standardmäßig auswählen sollen. Verwenden Sie eine konsistente Benennung für Tags.

Regel zur Erhöhung bei SemVer

Kurze Überprüfung: Wann erhöhen Sie MAJOR?

Zusammenfassung

Zusammenfassung: Verwenden Sie SemVer (MAJOR.MINOR.PATCH), erstellen Sie annotierte Git-Tags wie v1.2.0, geben Sie Versionsbereiche für Abhängigkeiten in Package.swift an und führen Sie einen übersichtlichen CHANGELOG.

Häufig gestellte Fragen

Ist die Lektion „Semantische Versionierung und Release-Tags“ kostenlos?

Ja — der vollständige Text von „Semantische Versionierung und Release-Tags“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Swift Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Swift Academy-Kurs umfasst insgesamt 3 Lektionen.

Was lerne ich in „Semantische Versionierung und Release-Tags“?

Wenden Sie Semantic Versioning (MAJOR.MINOR.PATCH) an, erstellen Sie annotierte git tags und referenzieren Sie Versionen in SwiftPM-Abhängigkeiten eindeutig. Du übst Swift 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 Swift Academy zu starten?

Keine Vorkenntnisse erforderlich. Swift 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 2 von 3.

Wie lange dauert die Lektion „Semantische Versionierung und Release-Tags“?

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 Swift Academy-Lektion Code schreiben und ausführen?

Ja. Jede Swift 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

  1. Bibliotheks- und ausführbare Pakete
  2. Semantische Versionierung und Release-Tags
  3. CI-Grundlagen mit swift test und Artefakten
← Zurück zu Swift Academy