Versionnement sémantique et étiquetage des versions
Appliquez le versionnement sémantique (MAJOR.MINOR.PATCH), créez des étiquettes git annotées et référencez clairement les versions dans les dépendances SwiftPM.
Versionnement sémantique et étiquetage des versions est une leçon Swift Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 3. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Swift Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Swift Academy comprend 3 leçons au total.
Qu’est-ce que SemVer ?
SemVer = MAJOR.MINOR.PATCH.
- MAJOR : changements incompatibles
- MINOR : nouvelles fonctionnalités compatibles avec les versions précédentes
- PATCH : corrections de bogues, documentation et petites améliorations
Quand incrémenter la version
Choisissez l’incrément :
- Supprimer ou renommer une API publique → MAJOR
- Ajouter une API sans introduire de rupture → MINOR
- Refactorisations internes ou corrections de bogues → PATCH
Flux de travail avec les balises Git
Créez une balise annotée (par exemple v1.2.0), puis envoyez-la. SwiftPM résout les paquets à partir des balises 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")Exigences de version SwiftPM
Dans Package.swift, choisissez un style d’exigence : from:, exact:, .upToNextMajor ou .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")Bonnes pratiques pour CHANGELOG
Résumez les changements pour chaque version. Mettez clairement en évidence les éléments BREAKING afin que les utilisateurs puissent mettre à niveau leur version en toute sécurité.
// 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")Conseils pour les versions préliminaires
Les versions préliminaires (par exemple 2.0.0-beta.1) signalent une certaine instabilité. Évitez de créer une balise si vous ne souhaitez pas que les utilisateurs les sélectionnent par défaut. Gardez un nommage cohérent pour les balises.
Règle d’incrément de SemVer
Vérification rapide : quand devez-vous incrémenter MAJOR ?
Récapitulatif
Récapitulatif : utilisez SemVer (MAJOR.MINOR.PATCH), créez des balises Git annotées comme v1.2.0, indiquez les plages de versions des dépendances dans Package.swift et tenez à jour un CHANGELOG clair.
Questions Fréquemment Posées
La leçon « Versionnement sémantique et étiquetage des versions » est-elle gratuite ?
Oui — le texte complet de « Versionnement sémantique et étiquetage des versions » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Swift Academy, passe à CoddyKit PRO. Le cours Swift Academy comprend 3 leçons au total.
Qu'est-ce que j'apprendrai dans « Versionnement sémantique et étiquetage des versions » ?
Appliquez le versionnement sémantique (MAJOR.MINOR.PATCH), créez des étiquettes git annotées et référencez clairement les versions dans les dépendances SwiftPM. Tu pratiques Swift Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Swift Academy ?
Aucune expérience préalable n'est requise. Swift Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 3.
Combien de temps prend la leçon « Versionnement sémantique et étiquetage des versions » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Swift Academy ?
Oui. Chaque leçon Swift Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Packages de bibliothèque ou exécutables
- Versionnement sémantique et étiquetage des versions
- Bases de l’intégration continue avec swift test et les artefacts