How to package and deploy a NuGet package with sym

Question

I have created a very simple NuGet package from a .net framework visual studio Class Library project, where the class library source is in C#.

I used this command to create the nuget package:

nuget pack MyProject.csproj -symbols -Properties "Configuration=Debug" -suffix debug

Which creates, as I expect, two nuget package file, namely:

• MyProject.1.0.0-debug.symbols.nupkg
• MyProject.1.0.0-debug.nupkg

These packages are basically identical other than that the one with "symbols" includes the pdb files in the lib hierarchy and source files in the src folder.

Given the duplication, I rename the file MyProject.1.0.0-debug.symbols.nupkg as MyProject.1.0.0-debug.nupkg, which overwrites one of the files, no big deal there. I now have a conventionally named package with PDB and source files in it.

I deploy this to an internal file share feed with:

nuget add MyProject.1.0.0-debug.nupkg \\InternalShare\FeedFolder

In an entirely different project, and a different solution, I now consume that NuGet package in Visual Studio with the NuGet Package Manager. All works great. And the code works fine too, in my case I made a simple console app that uses a couple of classes in the package and I have demonstrated that it uses them correctly and without incident.

So far so good.

Now I set a breakpoint in the consuming code, and attempt to step into the source to debug the package. It seems to work OK, but actually, it isn't going into the source that was distributed with the package. It actually steps into the ORIGINAL source from the creation of the package, in a completely different and unrelated folder hierarchy on my machine.

OK. So now I recreate my simple console app on a separate computer that does not have the ORIGINAL source. And on that separate computer, which is on the internal network and hence has access to the file share, I consume the NuGet package and again, everything compiles and works fine.

When I try to step into the package source code in the visual studio debugger, however, it simply doesn't work. The debugger can't find the source code even though it is right there in the package folder. (The debugger offers to disassemble the code -- not so helpful).

This seems like it should be a common use case and desire for including symbols and source code in a nuget package, so I must be doing something silly such that the debugger can't find the source.

Various versions of things:

• Visual Studio: Professional 2017 15.9.11
• NuGet Package Manager installed in VS: 4.6.0
• CLI NuGet version: 4.8.1.5435
• Targetted .NET Framework for my sample code: 4.6.1

What is my mistake?

Many thanks in advance.

================== ADDED INFO 4/17/2019, 3:30pm Pacific =======================

This isn't quite as bad as I thought. When I try to go into the code and says it can't find it, I am given the opportunity to browse to the code, so I can browse to the package (assuming I know where it is!) and set the debugger loose and everything works fine. The nice thing is that Visual Studio seems to remember where I browsed to and knows to look there next time. Not sure of that mechanism.

AND.... If I go to my original computer (with the actual package source on it) if I change that initial source, like I am getting ready for the next package, the debugger (of course) realizes that the source has changed, and likewise prompts me to look for the proper source elsewhere.

Still, it would be great not to have to jump through hoops like that, so I would still appreciate any further insights.

Answer 1

Some fundamentals:

• the debugger needs PDBs to enable debugging
• a symbol package should contain PDBs (it is not merely a package with a different extension)
• this symbol package should be published to a symbol repository that Visual Studio debugger can request symbols from

Next:

1. See this doc for creating and publishing symbols package to nuget.org (.snupkg)
2. Then, see this doc for configuring visual studio to for using NuGet.org as a symbol source (use this value when adding a symbol server https://symbols.nuget.org/download/symbols)