Since the last release, I have made two major changes to the API.
First, I have reworked the SymbolLocator class. I had to rush out the last version so that we could ship sources, and that class was in an incomplete state. It has been subsequently reworked into a new design.
Second, as part of the effort to (finally) release 1.0 of the library and get it out of beta (which hasn't happened yet), I have marked some commonly used APIs with the [Obsolete] attribute. Virtually no functionality has been removed, only that APIs have been renamed or moved within the runtime. The one exception is that ClrMD is moving away from doing symbol resolution (File and Line number). This means GetSourceLocationForOffset and related functions no longer work. Instead, I have implemented a sample you can find here: https://github.com/Microsoft/clrmd/blob/master/src/FileAndLineNumbers/Program.cs
Note that all methods marked [Obsolete] will be removed in the next NuGet release (but I do not plan to do another release for a little while). I appologize in advance for any incovenience this causes. After years of active development, some API dead-ends have inevitably crept into the library, and need to be removed before 1.0 is released.
Aside from various bugfixes, here are some noteworthy changes in this release:
- I've added Async APIs for symbol resolution/download, and the SymbolLocator class is now thread safe. You can now download symbols asynchronosly and in parallel.
- Added basic support for converting CLR internal structures (MethodDescs, MethodTables, EEClass, etc) to and from ClrMD types and methods.
- Add a way to get information about the Shared and System domains.
- Completely remove the dependency on msdia120.dll and DiaLib.dll. Added a managed PDB reader to do this work instead. ClrMD currently has no dependencies on any other library (that doesn't come with windows anyway).
You can find a signed build of this release on NuGet: https://www.nuget.org/packages/Microsoft.Diagnostics.Runtime/0.8.31-beta