在 NuGet 提供符号 NuGet 库的支持,在默认上传将会同时上传符号库。在 NuGet 上传文件将会默认将 snupkg 符号文件上传

让 NuGet 发布默认不上传符号文件的方法是添加参数 NoSymbols 请看代码

 nuget push .\bin\release\*.nupkg -Source https://api.nuget.org/v3/index.json -SkipDuplicate -NoSymbols 

在 nuget 发布可以给某个文件路径,将这个路径所有文件上传,在上传文件时,将会同步上传符号文件。如果符号文件不存在,建议输出提示

File does not exist (.\bin\release\*.snupkg)

通过在命令行添加参数不上传外,还可以在创建 NuGet 库创建符号文件,这样就不会提示找不到

在 sdk style 格式的项目文件,添加下面代码,添加之后打包就会创建 snupkg 文件

<PropertyGroup>
    <IncludeSymbols>true</IncludeSymbols>	
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>	
</PropertyGroup>

这里的 PropertyGroup 元素可以添加到 Project 元素下

另一个方法是在命令行打包添加参数

dotnet pack -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg

如果使用 msbuild 打包,可以使用下面代码

msbuild /t:pack /p:IncludeSymbols=true /p:SymbolPackageFormat=snupkg

如果使用 nuget 打包,如对应的 xx.nuspec 可以使用下面代码

nuget pack MyPackage.nuspec -Symbols -SymbolPackageFormat snupkg

NuGet 符号服务器

How to publish NuGet symbol packages using the new symbol package format ‘.snupkg’

在 NuGet 包嵌入 符号文件 的方法是添加 AllowedOutputExtensionsInPackageBuildOutputFolder 属性

<Project Sdk="Microsoft.NET.Sdk">
 <PropertyGroup>
    <!-- Include symbol files (*.pdb) in the built .nupkg -->
    <AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
  </PropertyGroup>
</Project>

默认符号文件是放在 snupkg 文件,而不是放在 nupkg 文件,原因是将符号文件放在 nupkg 文件,会让 nupkg 文件太大。如果将符号文件放在 nupkg 文件,那么不需要开发者另外配置符号服务器,就可以拿到符号文件

详细请看 Roslyn 打包自定义的文件到 NuGet 包


本文会经常更新,请阅读原文: https://dotnet-campus.github.io//post/NuGet-%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%B8%8A%E4%BC%A0%E6%89%BE%E4%B8%8D%E5%88%B0-snupkg-%E6%96%87%E4%BB%B6.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 lindexi (包含链接: https://dotnet-campus.github.io/ ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系