“dotnet pack”使用发布配置

项目
05/10/2023

dotnet pack 命令将代码打包到 NuGet 包中，现在默认使用 Release 配置而不是 Debug 配置。

旧行为

以前，dotnet pack 使用 Debug 配置，除非显式指定配置或 PackRelease 设置为 true。

.NET 7 中已添加 PackRelease 属性作为此中断性变更的路径。以前，可以将 DOTNET_CLI_ENABLE_PACK_RELEASE_FOR_SOLUTIONS 环境变量设置为在属于 Visual Studio 解决方案的项目中使用 PackRelease。

新行为

如果使用 .NET 8 SDK 或更高版本进行开发，那么 dotnet pack 默认对所有项目使用 Release 配置。如果有 CI/CD 脚本、测试或代码，并且已将 Debug 硬编码到输出路径中，则此更改可能会中断工作流。此外，除非显式指定了 Debug 配置（例如，使用 dotnet pack --configuration Debug），否则将无法调试打包的应用。

dotnet pack 可以同时打包多个目标框架名字对象 (TFM)。如果项目面向多个版本，并且针对不同的目标具有不同的 PackRelease 值，则可能存在冲突，即一些 TFM 打包 Release 配置，而另一些 TFM 打包 Debug 配置。

对于解决方案中的项目：

如果给定解决方案文件，dotnet pack 可以打包 Visual Studio 解决方案中的所有项目。对于解决方案中的每个项目，如果未定义 PackRelease 的值，则将其隐式设置为 true。为了使 dotnet pack 确定要使用的正确配置，解决方案中的所有项目都必须就其 PackRelease 值达成一致。
此更改可能会导致 dotnet pack 的性能下降，尤其是对于包含多个项目的解决方案。为了解决此问题，引入了一个新的环境变量 DOTNET_CLI_LAZY_PUBLISH_AND_PACK_RELEASE_FOR_SOLUTIONS。
不再识别 DOTNET_CLI_ENABLE_PACK_RELEASE_FOR_SOLUTIONS 环境变量。

引入的版本

.NET 8 预览版 1

中断性变更的类型

此更改会影响源兼容性，也是行为变更。

更改原因

大多数情况下，在创建包时，你希望优化代码，并且可以通过排除调试信息来使包更小。

已删除 DOTNET_CLI_ENABLE_PACK_RELEASE_FOR_SOLUTIONS 环境变量，因为它启用的行为现在是默认行为，不再需要精细控制。

建议的操作

若要完全禁用新行为，可以将 DOTNET_CLI_DISABLE_PUBLISH_AND_PACK_RELEASE 环境变量设置为 true（或任何其他值）。此变量同时影响 dotnet publish 和 dotnet pack。
若要显式指定 Debug 配置用于打包，请将 -c 或 --configuration 选项与 dotnet pack 一起使用。
如果 CI/CD 管道由于硬编码的输出路径而中断，请将路径更新为 Release 而不是 Debug，使用 DOTNET_CLI_DISABLE_PUBLISH_AND_PACK_RELEASE 环境变量禁用新行为，或指定应使用 Debug 配置。
如果要打包解决方案，但解决方案由于一个或多个项目显式设置 PackRelease 的值而损坏，则应在每个项目中将 PackRelease 显式设置为 false：
```
<PropertyGroup>
  <PackRelease>false</PackRelease>
</PropertyGroup>
```
如果要打包解决方案且性能已下降，可以将 DOTNET_CLI_LAZY_PUBLISH_AND_PACK_RELEASE_FOR_SOLUTIONS 环境变量设置为 true（或任何其他值）以删除回归。如果使用此变量并且有任何项目定义了 PackRelease，则所有项目都必须定义它，或者可以使用 Directory.Build.Props 文件。此变量同时影响 dotnet publish 和 dotnet pack。

另请参阅

“dotnet publish”使用发布配置

通过