2019-5-21-NuGet-符号服务器

title	author	date	CreateTime	categories
NuGet 符号服务器	lindexi	2019-05-21 11:34:40 +0800	2019-05-08 21:29:23 +0800	nuget

在新的 VisualStudio 支持使用 NuGet 符号服务器，可以支持新的 Portable PDB 调试符号的库，本文告诉大家如何打包上传带符号的库和使用符号服务器

在 2018 的 11 月微软支持上传带符号的包到 NuGet.org 符号服务器，在使用 Visual Studio 2017 15.9 和以上版本可以支持打包 .NET Core 的 Portable PDB 符号的库，或者使用 nuget.exe 4.9.0 或 dotnet 命令行打包

创建的带符号的库的后缀是 .snupkg 下面是一些打包方法

使用 dotnet 命令行方法，以打包 Foo 项目为例

dotnet pack Foo.csproj --include-symbols -p:SymbolPackageFormat=snupkg

使用 nuget 命令行的方法，请看下面代码，请将 Foo.nuspec 替换为你自己需要的打包文件

 nuget pack Foo.nuspec -Symbols -SymbolPackageFormat snupkg

使用 msbuild 命令行的方法，请替换为自己项目

msbuild /t:pack Foo.csproj /p:IncludeSymbols=true /p:SymbolPackageFormat=snupkg

此时打包出来的是 .snupkg 文件，可以用来上传到符号服务器

上传的方法是打开nuget.org点击上传，传入文件

在 VisualStudio 使用 NuGet 符号服务器的方法是添加符号服务器 https://symbols.nuget.org/download/symbols 到工具-选项-调试-符号

注意，当前的符号服务器支持的 .snupkg 文件需要使用最新的portable pdb 格式，关于 portable pdb 请看介绍Portable PDB

在 VisualStudio 2019 16.1 Preview 2 默认添加了符号服务器，可以点击勾选就可以使用

介绍Portable PDB

portable pdb

Improved package debugging experience with the NuGet.org symbol server