0Pricing
Swift Academy · 课时

语义化版本控制与发布标记

应用 语义化版本控制 （MAJOR.MINOR.PATCH），创建带注释的 git 标签 ，并清晰地在 SwiftPM 依赖中引用版本。

语义化版本控制与发布标记 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 2 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 3 节课。

什么是 SemVer

SemVer = MAJOR.MINOR.PATCH。

  • MAJOR：不兼容的变更
  • MINOR：新增功能，向后兼容
  • PATCH：错误修复、文档更新和小幅改进

何时提升版本号

选择提升的版本号：

  • 移除或重命名公开 API → MAJOR
  • 新增不造成破坏的 API → MINOR
  • 内部重构或错误修复 → PATCH

Git 标签工作流

创建一个带注释的标签（例如 v1.2.0）并推送。SwiftPM 会根据 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")

SwiftPM 版本要求

在 Package.swift 中选择一种要求写法：from:、exact:、.upToNextMajor 或 .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 习惯

按版本总结变更。清楚地突出BREAKING项目，让用户能够安全升级。

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

预发布版本提示

预发布版本（例如 2.0.0-beta.1）表示版本不稳定。如果不希望用户默认选择这些版本，请避免为其创建标签。保持标签命名一致。

SemVer 版本提升规则

快速检查：什么时候应提升 MAJOR？

回顾

回顾：使用 SemVer（MAJOR.MINOR.PATCH），创建类似 v1.2.0 的带注释的 Git 标签，在 Package.swift 中指定依赖的版本范围，并维护清晰的 CHANGELOG。

常见问题解答

「语义化版本控制与发布标记」课时是免费的吗？

是的 — 「语义化版本控制与发布标记」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 3 节课。

「语义化版本控制与发布标记」这节课中我会学到什么？

应用 语义化版本控制 （MAJOR.MINOR.PATCH），创建带注释的 git 标签 ，并清晰地在 SwiftPM 依赖中引用版本。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 3 节。

「语义化版本控制与发布标记」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 库包与可执行包
  2. 语义化版本控制与发布标记
  3. 使用 swift test 和构建产物的 CI 基础
← 返回 Swift Academy