0Pricing
Swift Academy · Lekcja

Wersjonowanie semantyczne i oznaczanie wydań

Stosuj Semantic Versioning (MAJOR.MINOR.PATCH), twórz adnotowane znaczniki git i jasno określaj wersje zależności w SwiftPM.

Wersjonowanie semantyczne i oznaczanie wydań to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 2 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 3 lekcji w sumie.

Czym jest SemVer?

SemVer = MAJOR.MINOR.PATCH.

  • MAJOR: zmiany niekompatybilne wstecz
  • MINOR: nowe funkcje, kompatybilne wstecz
  • PATCH: poprawki błędów, dokumentacja, drobne ulepszenia

Kiedy zwiększyć wersję

Wybierz rodzaj zmiany wersji:

  • Usunięcie lub zmiana nazwy publicznego API → MAJOR
  • Dodanie nowego API bez wprowadzania niezgodności → MINOR
  • Wewnętrzna refaktoryzacja lub poprawki błędów → PATCH

Proces tagowania w Git

Utwórz tag z adnotacją (np. v1.2.0) i wypchnij go do repozytorium. SwiftPM rozwiązuje zależności pakietów na podstawie tagów Git.

// 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")

Wymagania dotyczące wersji w SwiftPM

W pliku Package.swift wybierz sposób określania wymaganej wersji: from:, exact:, .upToNextMajor lub .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")

Dobre praktyki dotyczące CHANGELOG

Podsumowuj zmiany dla każdej wersji. Wyraźnie wyróżniaj elementy BREAKING, aby użytkownicy mogli bezpiecznie przeprowadzić aktualizację.

// 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")

Wskazówki dotyczące wersji wstępnych

Wersje wstępne (np. 2.0.0-beta.1) sygnalizują niestabilność. Unikaj ich tagowania, jeśli nie chcesz, aby użytkownicy wybierali je domyślnie. Zachowuj spójne nazewnictwo tagów.

Zasada zwiększania wersji SemVer

Szybkie sprawdzenie: Kiedy zwiększa się MAJOR?

Podsumowanie

Podsumowanie: Stosuj SemVer (MAJOR.MINOR.PATCH), twórz tagi Git z adnotacją, takie jak v1.2.0, określaj zakresy wersji zależności w pliku Package.swift i prowadź przejrzysty plik CHANGELOG.

Często zadawane pytania

Czy lekcja „Wersjonowanie semantyczne i oznaczanie wydań” jest bezpłatna?

Tak — pełny tekst „Wersjonowanie semantyczne i oznaczanie wydań” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 3 lekcji w sumie.

Co nauczysz się w „Wersjonowanie semantyczne i oznaczanie wydań”?

Stosuj Semantic Versioning (MAJOR.MINOR.PATCH), twórz adnotowane znaczniki git i jasno określaj wersje zależności w SwiftPM. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 3.

Ile czasu zajmuje lekcja „Wersjonowanie semantyczne i oznaczanie wydań”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Pakiety bibliotek a pakiety wykonywalne
  2. Wersjonowanie semantyczne i oznaczanie wydań
  3. Podstawy CI z użyciem swift test i artefaktów
← Powrót do Swift Academy