大网数据广告活动
.NET 与 C# 开发

.NET Core 自包含应用部署的运行时前滚。

· 52CE 我爱测

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

.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) 创建的。

修补程序版本前滚概述

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

“已使用 Microsoft.NETCore.App 版本 2.0.0 还原该项目,但是按照当前设置,将改为使用版本 2.0.6。 若要解决此问题,请确保将相同的设置用于 restore 和后续操作,例如 build 或 publish。 如果在 build 或 publish 期间设置了 RuntimeIdentifier 属性,而没有在 restore 过程中设置,通常就会出现此问题。”

Note: restore 和 build 可以作为另一个命令(例如 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 设为特定的修补程序版本,可对运行时框架版本进行显式控制。

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 KathleenDollard)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。