Renaming makes stack traces from a protected application hard to read. For example, a stack trace from a customer might look like this:
Exception in thread "main" a: cannot calculate
at c.a(Unknown Source)
at b.a(Unknown Source)
at d.a(Unknown Source)
at com.preemptive.Example.main(Unknown Source)
PreEmptive Protection™ DashO™ includes tools that use your Renaming Map File to recover the original names automatically. You could look up each name in the renaming report by hand, but that's slow and tedious.
Prerequisites
- The Renaming Map File from the build that produced the stack trace. For more information, see Configure Map Files.
- The obfuscated stack trace.
Warning: Use the map file from the same build as the binary that produced the stack trace. Map files differ between builds unless you use Incremental Obfuscation, and the wrong file produces incorrect results.
Decode a Stack Trace in DashO
- In DashO, go to Window > Decode Stack Trace … to open the Decode Stack Trace tool.
- Specify the Map File.
- Paste the stack trace into the Decode Lines tab.
- Select Decode.
- Review the decoded stack trace on the Translation Report tab.
Look Up a Specific Class or Method
- Select the Decode Specific Element tab.
- Enter the obfuscated names of the items to translate.
- Select Decode.
- Review the decoded element on the Translation Report tab.
Decode Stack Traces with Lucidator
Lucidator is a stand-alone DashO tool for decoding stack traces. It provides the same interface as the integrated tool, and also runs from the command line, so you can integrate decoding into your existing support systems.
To see the command line options, run:
java -jar Lucidator.jar --helpLimitations and Troubleshooting
| Issue | Resolution |
| The decoded names are wrong. | Use the Renaming Map File from the same build as the binary. |
| The report lists several possible methods for one line. | Overload Induction gave several methods the same name. The report lists every possible match. |
The stack trace shows Unknown Source instead of line numbers. |
Keep Line Number Table and Source File in future builds. |