Lucidator is a cross-platform .NET Core command-line utility that translates obfuscated stack traces back to their original type and member names.
Use Lucidator when you need to diagnose errors reported from an application protected with Dotfuscator but do not have access to the Dotfuscator Config Editor.
Lucidator runs on Windows, macOS, and Linux.
Note: Lucidator requires the renaming map file generated during the same Dotfuscator build as the protected application.
Before You Begin
Before decoding a stack trace, ensure you have:
- The obfuscated stack trace.
- The corresponding Dotfuscator renaming map file.
- The Lucidator command-line utility.
The map file must match the version of the protected application that generated the stack trace.
Install Lucidator
Lucidator is distributed privately by PreEmptive as a NuGet package.
To install the package from the command line, run the following:
nuget install PreEmptive.Protection.LucidatorAfter downloading the package:
- Extract the contents of the
.nupkgfile. - Navigate to the
tools/programdirdirectory.
This directory contains:
- The Lucidator executable
- Platform-specific convenience scripts
- A README file with additional usage information
Decode a Stack Trace
- Obtain the renaming map file generated during the protection process.
- Save the obfuscated stack trace.
- Run Lucidator using the appropriate command for your platform.
- Review the translated stack trace to identify the original type and member names.
Best Practices
- Use the map file that matches the exact version of the protected application.
- Store map files securely, as they reveal the original names of obfuscated symbols.
- Keep Lucidator available to development and support teams that troubleshoot production issues.