在创建NuGet包时，不要包含Packages.config文件中的依赖项

Question

我正在使用Nuget创建包。我想创建一个包，该包不包含任何其他NuGet包的依赖项（在.nuspec文件中）。我的项目确实在其packages.config文件中定义了NuGet包依赖项。

首先创建.nuspec文件...

C:\code\MySolution>.nuget\nuget.exe spec MyProject\MyProject.csproj

我将生成的.nuspec文件编辑为最小，没有依赖项。

<?xml version="1.0"?>
<package >
  <metadata>
    <id>MyProject</id>
    <version>1.2.3</version>
    <title>MyProject</title>
    <authors>Example</authors>
    <owners>Example</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Example</description>
    <copyright>Copyright 2013 Example</copyright>
    <tags>example</tags>
    <dependencies />
  </metadata>
</package>

然后我构建了解决方案并创建了一个NuGet包...

C:\code\MySolution>.nuget\nuget.exe pack MyProject\MyProject.csproj -Verbosity detailed

下面是该命令的输出...

Attempting to build package from 'MyProject.csproj'.
Packing files from 'C:\code\MySolution\MyProject\bin\Debug'.
Using 'MyProject.nuspec' for metadata.
Found packages.config. Using packages listed as dependencies

Id: MyProject
Version: 1.2.3
Authors: Example
Description: Example
Tags: example
Dependencies: Google.ProtocolBuffers (= 2.4.1.473)

Added file 'lib\net40\MyProject.dll'.

Successfully created package 'C:\code\MySolution\MyProject.1.2.3.nupkg'.

创建的.nupkg包包含一个.nuspec文件，但它包含一个依赖项节，而我在原始.nuspec文件中没有这个节...

<dependencies>
  <dependency id="Google.ProtocolBuffers" version="2.4.1.473" />
</dependencies>

我相信这是因为...（来自上面的输出）

Found packages.config. Using packages listed as dependencies

如何使NuGet不自动解析依赖项并将其插入.nuspec文件（该文件是由pack命令生成的）？

我目前正在使用NuGet2.2。而且，我不认为这种行为发生在老版本的Nuget；这是一个新的“特征”吗？我找不到任何描述这个“特性”的文档，也找不到它何时实现的文档。

Answer 1

从NuGet 2.7开始，有一个新的developmentDependency属性可以添加到项目的packages.config文件中的packages节点。因此，如果您的项目包含了一个您不希望您的NuGet包作为依赖项包含的NuGet包，您可以像这样使用这个属性：

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="CreateNewNuGetPackageFromProjectAfterEachBuild" version="1.8.1-Prerelease1" targetFramework="net45" developmentDependency="true" />
</packages>

这里需要添加的重要部分是developmentdependency=“true”。

如果您正在创建一个开发NuGet包供其他人使用，并且您知道他们不希望在其包中作为依赖项使用，那么您可以通过在.nuspec文件的元数据部分使用NuGet 2.8developmentdependency属性，避免用户手动将该属性添加到其packages.config文件中。这将在其他人安装您的软件包时自动向Packages.config文件添加developmentDependency属性。这里的问题在于，它要求用户至少安装了NuGet2.8。幸运的是，我们可以利用NuGet 2.5minClientVersion属性来确保用户至少安装了V2.8；否则，他们将收到通知，他们需要在安装软件包之前更新NuGet客户端。

我有一个开发NuGet包，这是完美的。下面是我的.nuspec文件的样子，展示了如何使用minClientVersion和developmentDependency属性（分别是第3行和第20行）：

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="2.8">
    <id>CreateNewNuGetPackageFromProjectAfterEachBuild</id>
    <version>1.8.1-Prerelease1</version>
    <title>Create New NuGet Package From Project After Each Build</title>
    <authors>Daniel Schroeder,iQmetrix</authors>
    <owners>Daniel Schroeder,iQmetrix</owners>
    <licenseUrl>https://newnugetpackage.codeplex.com/license</licenseUrl>
    <projectUrl>https://newnugetpackage.codeplex.com/wikipage?title=NuGet%20Package%20To%20Create%20A%20NuGet%20Package%20From%20Your%20Project%20After%20Every%20Build</projectUrl>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Automatically creates a NuGet package from your project each time it builds. The NuGet package is placed in the project's output directory.
    If you want to use a .nuspec file, place it in the same directory as the project's project file (e.g. .csproj, .vbproj, .fsproj).
    This adds a PostBuildScripts folder to your project to house the PowerShell script that is called from the project's Post-Build event to create the NuGet package.
    If it does not seem to be working, check the Output window for any errors that may have occurred.</description>
    <summary>Automatically creates a NuGet package from your project each time it builds.</summary>
    <releaseNotes>- Changed to use new NuGet built-in method of marking this package as a developmentDependency (now requires NuGet client 2.8 or higher to download this package).</releaseNotes>
    <copyright>Daniel Schroeder 2013</copyright>
    <tags>Auto Automatic Automatically Build Pack Create New NuGet Package From Project After Each Build On PowerShell Power Shell .nupkg new nuget package NewNuGetPackage New-NuGetPackage</tags>
    <developmentDependency>true</developmentDependency>
  </metadata>
  <files>
    <file src="..\New-NuGetPackage.ps1" target="content\PostBuildScripts\New-NuGetPackage.ps1" />
    <file src="Content\NuGet.exe" target="content\PostBuildScripts\NuGet.exe" />
    <file src="Content\BuildNewPackage-RanAutomatically.ps1" target="content\PostBuildScripts\BuildNewPackage-RanAutomatically.ps1" />
    <file src="Content\UploadPackage-RunManually.ps1" target="content\PostBuildScripts\UploadPackage-RunManually.ps1" />
    <file src="Content\UploadPackage-RunManually.bat" target="content\PostBuildScripts\UploadPackage-RunManually.bat" />
    <file src="tools\Install.ps1" target="tools\Install.ps1" />
    <file src="tools\Uninstall.ps1" target="tools\Uninstall.ps1" />
  </files>
</package>

如果您不想强迫您的用户在使用您的软件包之前至少安装了NuGetV2.8，那么您可以在NuGet2.8 developmentDependency属性存在之前使用我提出并在博客中介绍的解决方案。

Answer 2

在版本2.7中，有一个名为developmentDependency的选项可以设置到package.config中，以避免包含依赖项。

<?xml version="1.0" encoding="utf-8"?>
<packages>
    <package id="jQuery" version="1.5.2" />
    <package id="netfx-Guard" version="1.3.3.2" developmentDependency="true" />
    <package id="microsoft-web-helpers" version="1.15" />
</packages>