Tip

若要保持与尚不支持的客户端和源的向后兼容性 PackageIcon ，请同时指定 PackageIcon 和 PackageIconUrl 。 Visual Studio 支持来自 PackageIcon 基于文件夹的源的包。

打包图标图像文件时，请使用 PackageIcon 属性来指定图标文件路径，该路径相对于包的根。 此外，请确保该文件已包含在包中。 图像文件大小限制为 1 MB。 支持的文件格式包括 JPEG 和 PNG。 建议使用128x128 的图像分辨率。

<PropertyGroup>
    <PackageIcon>icon.png</PackageIcon>
</PropertyGroup>
<ItemGroup>
    <None Include="images\icon.png" Pack="true" PackagePath="\"/>
</ItemGroup>

包图标示例 。

对于 nuspec 等效项，请查看 nuspec 图标的参考 。

支持 NuGet 5.10.0 preview 2 / .net SDK 5.0.300 及更高版本

打包自述文件时，需要使用 PackageReadmeFile 属性来指定包路径，相对于包的根。 除此之外，还需要确保文件已包含在包中。 支持的文件格式仅包括 Markdown ( md ) 。

<PropertyGroup>
    <PackageReadmeFile>readme.md</PackageReadmeFile>
</PropertyGroup>
<ItemGroup>
    <None Include="docs\readme.md" Pack="true" PackagePath="\"/>
</ItemGroup>

对于 nuspec 等效项，请查看 nuspec 自述文件参考 。

nuget pack 会复制扩展名为 .exe 、 .dll 、 .xml 、 .winmd 、 .json 和 .pri 的输出文件。 复制的输出文件取决于 MSBuild 从目标提供的内容 BuiltOutputProjectGroup 。

你 MSBuild 可以在项目文件或命令行中使用两个属性来控制输出程序集的位置：

请参阅 项目文件中的包引用

默认情况下，项目到项目引用被视为 NuGet 包引用。 例如：

<ProjectReference Include="..\UwpLibrary2\UwpLibrary2.csproj"/>

也可将以下元数据添加到项目引用：

<IncludeAssets>
<ExcludeAssets>
<PrivateAssets>

若要添加内容，请将额外的元数据添加到现有的 <Content> 项。 默认情况下，类型“Content”的所有内容都包括在包中，除非使用以下条目替代：

<Content Include="..\win7-x64\libuv.txt">
 <Pack>false</Pack>
</Content>

默认情况下，所有内容都添加到包中 content 和 contentFiles\any\<target_framework> 文件夹根目录，并保留相对文件夹结构，除非指定包路径：

<Content Include="..\win7-x64\libuv.txt">
  <Pack>true</Pack>
  <PackagePath>content\myfiles\</PackagePath>
</Content>

如果只想将所有内容复制到 (s) 的特定根文件夹 (而不是 content 和 contentFiles 这两) ，则可以使用 MSBuild 属性 ContentTargetFolders ，默认值为 "content; contentFiles"，但可以设置为任何其他文件夹名称。 请注意，基于 buildAction ，仅在 ContentTargetFolders 中指定“contentFiles”会将文件置于 contentFiles\any\<target_framework> 或 contentFiles\<language>\<target_framework> 下。

PackagePath 可以是一组以分号分隔的目标路径。 指定空的包路径会将文件添加到包的根目录。 例如，以下操作会将 libuv.txt 添加到 content\myfiles 、 content\samples 和包的根目录：

<Content Include="..\win7-x64\libuv.txt">
  <Pack>true</Pack>
  <PackagePath>content\myfiles;content\sample;;</PackagePath>
</Content>

还有一个 MSBuild 属性 $(IncludeContentInPack) ，默认值为 true 。 如果在任何项目中将此值设置为 false ，则该项目的内容不会包括在 nuget 包中。

您可以对上述任何项设置的其他包特定元数据包括 <PackageCopyToOutput> 和在 <PackageFlatten> CopyToOutput Flatten 输出中的项上设置和值 contentFiles nuspec 。

<PropertyGroup>
    <PackageLicenseExpression>MIT</PackageLicenseExpression>
</PropertyGroup>

<PropertyGroup>
    <PackageLicenseFile>LICENSE.txt</PackageLicenseFile>
</PropertyGroup>
<ItemGroup>
    <None Include="licenses\LICENSE.txt" Pack="true" PackagePath=""/>
</ItemGroup>

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0</TargetFrameworks>
    <PackageLicenseFile>LICENSE</PackageLicenseFile>
  </PropertyGroup>
  <ItemGroup>
    <None Include="LICENSE" Pack="true" PackagePath=""/>
  </ItemGroup>  

dotnet pack <path to .csproj file> -p:NuspecFile=<path to nuspec file> -p:NuspecProperties=<> -p:NuspecBasePath=<Base path> 
如果使用 MSBuild 打包项目，请使用类似于下面的命令：
msbuild -t:pack <path to .csproj file> -p:NuspecFile=<path to nuspec file> -p:NuspecProperties=<> -p:NuspecBasePath=<Base path> 
请注意， nuspec 默认情况下，使用 dotnet.exe 或 msbuild 打包会导致生成项目。 可以通过将属性传递给 dotnet.exe 来避免这种情况，这与项目文件中的 --no-build 设置 <NoBuild>true</NoBuild>  以及项目文件中的设置等效 <IncludeBuildOutput>false</IncludeBuildOutput>  。
用于打包文件的 .csproj 文件的示例 nuspec 如下：
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <NoBuild>true</NoBuild>
    <IncludeBuildOutput>false</IncludeBuildOutput>
    <NuspecFile>PATH_TO_NUSPEC_FILE</NuspecFile>
    <NuspecProperties>add nuspec properties here</NuspecProperties>
    <NuspecBasePath>optional to provide</NuspecBasePath>
  </PropertyGroup>
</Project>
用于创建自定义包的高级扩展点

pack目标提供两个扩展点，这些点在内部特定于目标框架的生成中运行。 扩展点支持包括特定于目标框架的内容和程序集到包中：
TargetsForTfmSpecificBuildOutput 目标：用于文件夹内的文件 lib 或使用指定的文件夹 BuildOutputTargetFolder 。
TargetsForTfmSpecificContentInPackage 目标：用于之外的文件 BuildOutputTargetFolder 。
TargetsForTfmSpecificBuildOutput

编写自定义目标并将其指定为属性的值 $(TargetsForTfmSpecificBuildOutput) 。 对于任何需要在 BuildOutputTargetFolder 默认情况下进入 (lib 的文件) ，目标应将这些文件写入 ItemGroup， BuildOutputInPackage 并设置以下两个元数据值：
FinalOutputPath：文件的绝对路径;如果未提供，则标识用于计算源路径。
TargetPath：当文件需要进入中的子文件夹时， (可选) 设置 lib\<TargetFramework> ，如位于其各自区域性文件夹下的附属程序集。 默认为文件的名称。
<PropertyGroup>
  <TargetsForTfmSpecificBuildOutput>$(TargetsForTfmSpecificBuildOutput);GetMyPackageFiles</TargetsForTfmSpecificBuildOutput>
</PropertyGroup>
<Target Name="GetMyPackageFiles">
  <ItemGroup>
    <BuildOutputInPackage Include="$(OutputPath)cs\$(AssemblyName).resources.dll">
        <TargetPath>cs</TargetPath>
    </BuildOutputInPackage>
  </ItemGroup>
</Target>
TargetsForTfmSpecificContentInPackage

编写自定义目标并将其指定为属性的值 $(TargetsForTfmSpecificContentInPackage) 。 对于要包含在包中的任何文件，目标应将这些文件写入 ItemGroup TfmSpecificPackageFile ，并设置以下可选的元数据：
PackagePath：应在包中输出文件的路径。 NuGet 如果将多个文件添加到同一个包路径，则会发出警告。
BuildAction：要分配给文件的生成操作，只有当包路径在文件夹中时才是必需的 contentFiles 。 默认值为 "None"。
<PropertyGroup>
  <TargetsForTfmSpecificContentInPackage>$(TargetsForTfmSpecificContentInPackage);CustomContentTarget</TargetsForTfmSpecificContentInPackage>
</PropertyGroup>
<Target Name="CustomContentTarget">
  <ItemGroup>
    <TfmSpecificPackageFile Include="abc.txt">
      <PackagePath>mycontent/$(TargetFramework)</PackagePath>
    </TfmSpecificPackageFile>
    <TfmSpecificPackageFile Include="Extensions/ext.txt" Condition="'$(TargetFramework)' == 'net46'">
      <PackagePath>net46content</PackagePath>
    </TfmSpecificPackageFile>  
  </ItemGroup>
</Target>  
MSBuild -t:restore（nuget restore 和 dotnet restore 与 .NET Core 项目一起使用）会还原项目文件中引用的包，如下所示：
读取所有项目到项目的引用
读取项目属性以查找中间文件夹和目标框架
MSBuild将数据传递到 NuGet.Build.Tasks.dll
编写资产文件、目标和属性
restore目标适用于使用 PackageReference 格式的项目。
MSBuild 16.5+ 还具有对格式的 选择支持 packages.config 。
Note
restore目标不应与目标组合运行 build 。
其他还原设置可能来自 MSBuild 项目文件中的属性。 还可以从命令行使用 -p: 开关设置值（请参阅以下示例）。