Skip to content

Symbols for Debugging

Wiesław Šoltés edited this page Apr 20, 2017 · 2 revisions

Symbols File Generation

Due to the presence of the -Symbols switch in the nuget pack call embedded in the Create...NuGet.cmd scripts, a second package will be generated called .symbols.nuget. When uploaded to nuget.org, nuget.exe will automatically detect this symbols package file (if it's in the same directory as the dll package) and upload it, to symbolsource.org

The SymbolSource server endpoint can be specified using the -Source switch. The default is symbolsource.org.

Notes

  • This does not appear to happen when uploading your NuGet package via the nuget.org website.
  • While you can only upload a given version of a nuget.org package once, you can upload a symbol package for a version as many times as you like.
  • To upload symbols for a nuget package already in nuget.org, you can specify the symbol package explicitly in a nuget push command.

Examples

New Package Upload

nuget push Microsoft.Xaml.Behaviors.Uwp.Managed.1.0.0.nupkg

Existing Package

nuget push 'Microsoft.Xaml.Behaviors.Uwp.Managed.1.0.0.symbols.nupkg

Debugging

In VS, setting http://srv.symbolsource.org/pdb/Public as a symbol file location will enable lookups to this package. You will have symbols and source in your behavior debugging sessions.

Full details at: