Versionamento semantico e tagging delle release
Applichi il Semantic Versioning (MAJOR.MINOR.PATCH), crei git tags annotati e riferisca chiaramente le versioni nelle dipendenze SwiftPM.
Versionamento semantico e tagging delle release è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 2 di 3. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 3 lezioni in totale.
Che cos'è SemVer?
SemVer = MAJOR.MINOR.PATCH.
- MAJOR: modifiche incompatibili
- MINOR: nuove funzionalità compatibili con le versioni precedenti
- PATCH: correzioni di bug, documentazione, piccoli miglioramenti
Quando incrementare la versione
Scelga l'incremento:
- Rimuove o rinomina un'API pubblica → MAJOR
- Aggiunge una nuova API senza introdurre incompatibilità → MINOR
- Refactoring interno o correzioni di bug → PATCH
Flusso di lavoro per i tag Git
Crei un tag annotato (ad esempio, v1.2.0) e lo esegua il push. SwiftPM risolve i pacchetti tramite i tag 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")Requisiti di versione di SwiftPM
In Package.swift, scelga uno stile per i requisiti: from:, exact:, .upToNextMajor o .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")Buone pratiche per il CHANGELOG
Riepiloghi le modifiche per ogni versione. Evidenzi chiaramente gli elementi BREAKING, così gli utenti possono eseguire l'aggiornamento in sicurezza.
// 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")Suggerimenti per le versioni preliminari
Le versioni preliminari (ad esempio, 2.0.0-beta.1) segnalano un prodotto non stabile. Eviti di creare tag se non desidera che gli utenti le scelgano per impostazione predefinita. Mantenga coerente la denominazione dei tag.
Regola per l'incremento SemVer
Verifica rapida: quando incrementa MAJOR?
Riepilogo
Riepilogo: utilizzi SemVer (MAJOR.MINOR.PATCH), crei tag Git annotati come v1.2.0, specifichi gli intervalli di versione delle dipendenze in Package.swift e mantenga un CHANGELOG chiaro.
Impara Swift con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 122
- Lezioni
- 409
Domande Frequenti
La lezione «Versionamento semantico e tagging delle release» è gratuita?
Sì — il testo completo di «Versionamento semantico e tagging delle release» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 3 lezioni in totale.
Cosa imparerò in «Versionamento semantico e tagging delle release»?
Applichi il Semantic Versioning (MAJOR.MINOR.PATCH), crei git tags annotati e riferisca chiaramente le versioni nelle dipendenze SwiftPM. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Swift Academy?
Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 3.
Quanto tempo richiede la lezione «Versionamento semantico e tagging delle release»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Swift Academy?
Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Pacchetti library e executable
- Versionamento semantico e tagging delle release
- Nozioni di base sulla CI con swift test e gli artefatti