dotnet 包

本文适用于： ✔️ .NET Core 2.x SDK 及更高版本

名称

dotnet pack - 将代码打包到 NuGet 包。

摘要

dotnet pack [<PROJECT>|<SOLUTION>] [-c|--configuration] [--force] [--include-source] [--include-symbols] [--interactive]
    [--no-build] [--no-dependencies] [--no-restore] [--nologo] [-o|--output] [--runtime] [-s|--serviceable]
    [-v|--verbosity] [--version-suffix]
dotnet pack [-h|--help]

说明

dotnet pack 命令生成项目并创建 NuGet 包。该命令的结果是一个 NuGet 包，也就是一个 .nupkg 文件。

如果要生成包含调试符号的包，可以使用以下两个选项：

--include-symbols：该选项用于创建符号包。
--include-source：该选项用于创建带有 src 文件夹的符号包，该文件夹包含源文件。

将被打包项目的 NuGet 依赖项添加到 .nuspec 文件，以便在安装包时可以进行正确解析。项目到项目的引用不会打包到项目内。目前，如果具有项目到项目的依赖项，则每个项目均必须包含一个包。

默认情况下，dotnet pack 先构建项目。如果希望避免此行为，则传递 --no-build 选项。此选项在持续集成 (CI) 生成方案中通常非常有用，你可以知道代码是之前生成的。

可向 dotnet pack 命令提供 MSBuild 属性，用于打包进程。有关详细信息，请参阅 NuGet 元数据属性和 MSBuild 命令行引用。示例部分介绍了如何在不同的情况下使用 MSBuild -p 开关。

默认情况下，Web 项目不可打包。若要覆盖默认行为，请将以下属性添加到 .csproj 文件中：

<PropertyGroup>
   <IsPackable>true</IsPackable>
</PropertyGroup>

Note

从 .NET Core 2.0 开始，无需运行 dotnet restore，因为它由所有需要还原的命令隐式运行，如 dotnet build 和 dotnet run。在执行显式还原有意义的某些情况下，例如 Azure DevOps Services 中的持续集成生成中，或在需要显式控制还原发生时间的生成系统中，它仍然是有效的命令。

以长格式传递命令时，该命令也支持 dotnet restore 选项（例如，--source）。不支持缩写选项，例如 -s。

参数

PROJECT | SOLUTION

要打包的项目或解决方案。它可能是 csproj 文件、解决方案文件或目录的路径。如果未指定，此命令会搜索当前目录，以获取项目文件或解决方案文件。

选项

-c|--configuration <CONFIGURATION>

定义生成配置。大多数项目的默认配置为 Debug，但你可以覆盖项目中的生成配置设置。
--force

强制解析所有依赖项，即使上次还原已成功，也不例外。指定此标记等同于删除 project.assets.json 文件。
-h|--help

打印出有关命令的简短帮助。
--include-source

除输出目录中的常规 NuGet 包外，还包括调试符号 NuGet 包。源文件包括在符号包内的 src 文件夹中。
--include-symbols

除输出目录中的常规 NuGet 包外，还包括调试符号 NuGet 包。
--interactive

允许命令停止并等待用户输入或操作（例如，完成身份验证）。自 .NET Core 3.0 SDK 起可用。
--no-build

打包前不生成项目。还将隐式设置 --no-restore 标记。
--no-dependencies

忽略项目间引用，仅还原根项目。
--no-restore

运行此命令时不执行隐式还原。
--nologo

不显示启动版权标志或版权消息。自 .NET Core 3.0 SDK 起可用。
-o|--output <OUTPUT_DIRECTORY>

将生成的包放置在指定目录。
--runtime <RUNTIME_IDENTIFIER>

指定要为其还原包的目标运行时。有关运行时标识符 (RID) 的列表，请参阅 RID 目录。
-s|--serviceable

设置包中可用的标志。有关详细信息，请参阅 .NET 博客：.NET 4.5.1 支持 .NET NuGet 库的 Microsoft 安全更新。
--version-suffix <VERSION_SUFFIX>

定义项目中 $(VersionSuffix) MSBuild 属性的值。
-v|--verbosity <LEVEL>

设置命令的详细级别。允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

示例

打包当前目录中的项目：
```
dotnet pack
```

打包 app1 项目：

dotnet pack ~/projects/app1/project.csproj

打包当前目录中的项目并将生成的包放置到 nupkgs 文件夹：
```
dotnet pack --output nupkgs
```
将当前目录中的项目打包到 nupkgs 文件夹并跳过生成步骤：
```
dotnet pack --no-build --output nupkgs
```
将项目的版本后缀配置为 <VersionSuffix>$(VersionSuffix)</VersionSuffix>.csproj文件中的，使用给定的后缀打包当前项目，并更新生成的程序包版本：
```
dotnet pack --version-suffix "ci-1234"
```
使用 2.1.0 MSBuild 属性将包版本设置为 PackageVersion：
```
dotnet pack -p:PackageVersion=2.1.0
```
打包特定目标框架的项目：
```
dotnet pack -p:TargetFrameworks=net45
```
打包项目，并使用特定运行时 (Windows 10) 进行还原操作：
```
dotnet pack --runtime win10-x64
```

使用 .nuspec 文件打包项目：

dotnet pack ~/projects/app1/project.csproj -p:NuspecFile=~/projects/app1/project.nuspec -p:NuspecBasePath=~/projects/app1/nuget