.NET Core 的版本控制方式概述Overview of how .NET Core is versioned

本文内容

.NET Core 是指 .NET Core 运行时和 .NET Core SDK，它包含开发应用程序所需的工具。.NET Core SDK 可与任何以前版本的 .NET Core 运行时一起使用。本文介绍运行时和 SDK 版本策略。有关 .NET Standard 版本号的说明，请参阅介绍 .NET Standar 的文章。

.NET Core 运行时和 .NET Core SDK 以不同的速率添加新功能，通常情况下，.NET Core SDK 提供更新工具的速度比 .NET Core 运行时更改生产中所用运行时的速度快。

版本控制详细信息Versioning details

“.NET Core 2.1”是指 .NET Core 运行时版本号。.NET Core 运行时用于版本控制的主要/次要/补丁方法需遵循语义版本控制。

.NET Core SDK 不遵循语义版本控制。.NET Core SDK 发布速度更快，其版本必须传达相应的运行时和 SDK 自己的次要版本和修补程序版本。.NET Core SDK 版本的前两个位置被锁定到与之一起发布的 .NET Core 运行时。每个版本的 SDK 都可以为此版本或任何更低版本的运行时创建应用程序。

SDK 版本号的第三个位置同时传达次要编号和修补程序编号。次要版本乘以 100。次要版本 1，修补程序版本 2 将表示为 102。最后两位数代表修补程序号。例如，.NET Core 2.2 可能会创建如下表所示的版本：

(*) 此图表以未来的 2.2 .NET Core 运行时示例，因为历史项目 .NET Core 2.1 的第一个 SDK 是 2.1.300。有关详细信息，请参阅 .NET Core 版本选择页。

注意：

• 如果在运行时功能更新之前，SDK 有 10 个功能更新，则版本号将滚动到 1000 系列，2.2.1000 等编号为 2.2.900 之后的功能版本。应该不会出现这种情况。
• 不会出现为发布功能的 99 修补程序版本。如果某版本接近此数字，则会强制发布功能。可在 dotnet/设计 存储库中查看初始建议的更多详细信息。

语义化版本控制Semantic versioning

.NET Core 运行时大致遵循语义版本控制 (SemVer)，采用 MAJOR.MINOR.PATCH 版本控制，通过版本号的各部分来描述更改程度和类型 。

MAJOR.MINOR.PATCH[-PRERELEASE-BUILDNUMBER]

可选的 PRERELEASE 和 BUILDNUMBER 部分永远不会成为受支持版本的一部分，并且将仅存在于夜间版本、来自源目标的本地版本，以及不受支持的预览版本中。

了解运行时版本号更改Understand runtime version number changes

MAJOR 在下列情况时递增：

• 产品或新产品方向发生重大更改。
• 发生了中断性变更。接受中断性变更存在较大障碍。
• 旧版本不再受支持。

• 采用了现有依赖项的较新 MAJOR 版本。MINOR 在下列情况时递增：

• 添加了公共 API 外围应用。

• 添加了新行为。
• 采用了现有依赖项的较新 MINOR 版本。

• 引入了新依赖项。PATCH 在下列情况时递增：

• 进行了 Bug 修复。

• 添加了对较新平台的支持。
• 采用了现有依赖项的较新 PATCH 版本。
• 任何其他不符合上述情况的更改。存在多处更改时，单个更改影响的最高级别元素会递增，并将随后的元素重置为零。例如，当 MAJOR 递增时，MINOR 和 PATCH 将重置为零。当 MINOR 递增时，PATCH 将重置为零，而 MAJOR 保持不变。

文件名中的版本号Version numbers in file names

为 .NET Core 下载的文件带有版本，例如 dotnet-sdk-2.1.300-win10-x64.exe。

预览版Preview versions

预览版向版本中追加了 -preview[number]-([build]|"final")。例如 2.0.0-preview1-final。

服务版本Servicing versions

在版本发布后，版本分支通常停止生成日常版本，而开始生成服务版本。服务版本向版本追加了 -servicing-[number]。例如 2.0.1-servicing-006924。

与 .NET Standard 版本的关系Relationship to .NET Standard versions

.NET Standard 由 .NET 引用程序集组成。每个平台都有多个特定的实现。引用程序集包含 .NET API 的定义，后者是给定 .NET Standard 版本的一部分。每个实现均满足特定平台上的 .NET Standard 协定。可参阅 .NET 指南中有关 .NET Standard 的文章，深入了解 .NET Standard。

.NET Standard 引用程序集使用 MAJOR.MINOR 版本控制方案。PATCH 级别对 .NET Standard 并无用处，因为它只公开 API 规范（没有实现），并且根据定义，对 API 的任何更改都将作为功能集的更改，从进而产生新的 MINOR 版本。

每个平台上的实现通常可作为平台版本的一部分更新，因此对于在该平台上使用 .NET Standard 的程序员来说并不明显。

每个版本的 .NET Core 都实现了某一版本的 .NET Standard。实现某一版本的 .NET Standard 意味着支持以前版本的 .NET Standard。.NET Standard 和 .NET Core 版本独立。.NET Core 2.0 实现 .NET Standard 2.0 是巧合。.NET Core 2.1 也可实现 .NET Standard 2.0。.NET Standard 的未来版本出现后，.NET Core 将支持这些版本。

请参阅See also

• 目标框架
• .NET Core 分发打包
• .NET Core 支持生命周期简报
• .NET Core 2 和版本绑定
• .NET Core 的 Docker 映像