本主题适用于:✓ .NET Core 1.x SDK ✓ .NET Core 2.x SDK
name
dotnet pack - 将代码打包到 NuGet 包。
摘要
.NET Core 2.x
dotnet pack [<PROJECT>] [-c|--configuration] [--force] [--include-source] [--include-symbols] [--no-build] [--no-dependencies]
[--no-restore] [-o|--output] [--runtime] [-s|--serviceable] [-v|--verbosity] [--version-suffix]
dotnet pack [-h|--help]
.NET Core 1.x
dotnet pack [<PROJECT>] [-c|--configuration] [--include-source] [--include-symbols] [--no-build] [-o|--output]
[-s|--serviceable] [-v|--verbosity] [--version-suffix]
dotnet pack [-h|--help]
说明
dotnet pack 命令生成项目并创建 NuGet 包。 该命令的结果是一个 NuGet 包。 如果 --include-symbols 选项存在,则创建包含调试符号的另一个包。
将被打包项目的 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要打包的项目。 它可能是 csproj 文件或目录的路径。 如果未指定,则默认为当前目录。
选项
.NET Core 2.x
-
-c|--configuration {Debug|Release}定义生成配置。 默认值为
Debug。 -
--force强制解析所有依赖项,即使上次还原已成功,也不例外。 指定此标记等同于删除 project.assets.json 文件。
-
-h|--help打印出有关命令的简短帮助。
-
--include-source将源文件包括在 NuGet 包中。 源文件包括在
nupkg内的src文件夹中。 -
--include-symbols生成符号
nupkg。 -
--no-build打包前不生成项目。 还将隐式设置
--no-restore标记。 -
--no-dependencies忽略项目间引用,仅还原根项目。
-
--no-restore运行此命令时不执行隐式还原。
-
-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]。
.NET Core 1.x
-
-c|--configuration {Debug|Release}定义生成配置。 默认值为
Debug。 -
-h|--help打印出有关命令的简短帮助。
-
--include-source将源文件包括在 NuGet 包中。 源文件包括在
nupkg内的src文件夹中。 -
--include-symbols生成符号
nupkg。 -
--no-build打包前不生成项目。
-
-o|--output <OUTPUT_DIRECTORY>将生成的包放置在指定目录。
-
-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 -
将项目的版本后缀配置为 .csproj 文件中的
<VersionSuffix>$(VersionSuffix)</VersionSuffix>,使用给定的后缀打包当前项目,并更新生成的程序包版本:dotnet pack --version-suffix "ci-1234" -
使用
PackageVersionMSBuild 属性将包版本设置为2.1.0:dotnet pack -p:PackageVersion=2.1.0 -
打包特定目标框架的项目:
dotnet pack -p:TargetFrameworks=net45 -
打包项目,并使用特定运行时 (Windows 10) 进行还原操作(.NET Core SDK 2.0 及更高版本):
dotnet pack --runtime win10-x64 -
使用 .nuspec 文件打包项目:
dotnet pack ~/projects/app1/project.csproj /p:NuspecFile=~/projects/app1/project.nuspec /p:NuspecBasePath=~/projects/app1/nuget
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
