如何使用 .NET Core 命令行接口 (CLI) 工具创建 NuGet 包How to create a NuGet package with .NET Core command-line interface (CLI) tools

本文内容

备注

下例是关于使用 Unix 的命令行。此处显示的 dotnet pack 命令工作方式与在 Windows 上相同。

对于 .NET Standard 和 .NET Core，所有库都应以 NuGet 包方式发布。实际上，这是所有 .NET 标准库的发布和使用方式。可以使用 dotnet pack 命令轻松实现此操作。

假设你刚编写了一个很棒的新库，并想通过 NuGet 发布。你就可以使用跨平台工具创建一个 NuGet 包，完全照做就行！下例假定使用一个名为 SuperAwesomeLibrary 的库，该库以 netstandard1.0 为目标。

如果存在可传递的依赖项，也就是说，如果一个项目依赖于另一个包，在创建 NuGet 包前，则需要确保使用 dotnet restore 还原整个解决方案的包。否则将导致 dotnet pack 命令不能正常运行。

备注

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

确认包已还原后，可以导航到库所在的目录：

cd src/SuperAwesomeLibrary

然后，只需在命令行中输入一个命令：

dotnet pack

/bin/Debug 文件夹现在如下所示：

$ ls bin/Debug
netstandard1.0/
SuperAwesomeLibrary.1.0.0.nupkg
SuperAwesomeLibrary.1.0.0.symbols.nupkg

请注意，这将生成能够进行调试的包。如果想要生成二进制文件版本的 NuGet 包，只需添加 —configuration（或-c）开关并使用 release 作为参数。

dotnet pack --configuration release

/bin 文件夹现在将包含一个 release 文件夹，后者包含的 NuGet 包为二进制文件版本：

$ ls bin/release
netstandard1.0/
SuperAwesomeLibrary.1.0.0.nupkg
SuperAwesomeLibrary.1.0.0.symbols.nupkg

因此，现在可以使用此必需的文件发布 NuGet 包了！

不要混淆 dotnet pack 和 dotnet publishDon't confuse dotnet pack with dotnet publish

务必注意，不是任何时候都涉及 dotnet publish 命令。dotnet publish 命令用于在同一个包中部署具有所有依赖项的应用程序 - 而不是用于生成通过 NuGet 发布和使用的 NuGet 包。

请参阅See also

• 快速入门：创建和发布包