自包含部署运行时前滚

.NET Core 自包含应用程序部署包括 .NET Core 库和 .NET Core 运行时。 从 .NET Core 2.1 SDK(版本 2.1.300)开始,自包含应用程序部署在计算机上发布最高版本的修补程序运行时。 默认情况下,自包含部署的 dotnet publish 选择作为发布计算机上 SDK 一部分而安装的最新版本。 这让部署的应用程序在 publish 期间能与安全修补程序(以及其他修补程序)配合运行。 若要获取新的修补程序,需要重新发布应用程序。 自包含应用程序是通过在 dotnet publish 命令上指定 -r <RID> 创建的,或是通过在项目文件 (csproj / vbproj) 或命令行中指定运行时标识符 (RID) 创建的。

修补程序版本前滚概述

restorebuildpublish 是可以单独运行的 dotnet 命令。 运行时选择属于 restore 操作,而不是 publishbuild 操作。 如果调用 publish,则会选择最新的修补程序版本。 如果调用带有 --no-restore 参数的 publish,则可能不会获取所需的修补程序版本,因为没有先使用新的自包含应用程序发布策略执行 restore。 在这种情况下,会出现生成错误,并显示以下类似文本:

“已使用 Microsoft.NETCore.App 版本 2.0.0 还原该项目,但是按照当前设置,将改为使用版本 2.0.6。 若要解决此问题,请确保使用相同的设置执行还原和后续操作,例如生成或发布。 通常,如果在生成或发布过程中设置了 RuntimeIdentifier 属性,但在还原过程中未设置此属性,则会出现此问题。”

注意

restorebuild 可以作为另一个命令(例如 publish)的组成部分隐式运行。 当作为另一个命令的组成部分隐式运行时,它们会带有附加的上下文,以便生成正确的项目。 如果使用某个运行时(例如 dotnet publish -r linux-x64)执行 publish,隐式的 restore 会还原 linux-x64 运行时的包。 如果显示调用 restore,则默认情况下它不会还原运行时包,因为没有上下文。

如何避免在 publish 过程中 restore

你可能在进行 publish 操作时不需要运行 restore。 在创建自包含应用程序时,若要避免在 publish 过程中进行 restore,请执行以下操作:

  • RuntimeIdentifiers 属性设为一个分号分隔的列表,其中包含所有要发布的 RID
  • TargetLatestRuntimePatch 属性设置为 true

使用 dotnet publish 选项的 no-restore 参数

如果要使用同样的项目文件创建自包含应用程序和依赖框架的应用程序,并且想通过 dotnet publish 使用 --no-restore 参数,请选择以下各项之一:

  1. 首选依赖框架的行为。 如果是依赖框架的应用程序,则此选项为默认行为。 如果是自包含应用程序,并且能使用未带修补程序的 2.1.0 本地运行时,请在项目文件中将 TargetLatestRuntimePatch 设为 false

  2. 首选自包含行为。 如果是自包含应用程序,则此选项为默认行为。 如果是依赖框架的应用程序,且需要安装最新版本的修补程序,请在项目文件中将 TargetLatestRuntimePatch 设为 true

  3. 通过在项目文件中将 RuntimeFrameworkVersion 设为特定的修补程序版本,可对运行时框架版本进行显式控制。