The PreEmptive Analytics section allows you to specify options that control how Dotfuscator processes instrumentation attributes in the input assemblies. For more information about instrumentation and PreEmptive Analytics, see The Instrumentation Editor.
The PreEmptive Analytics section is optional.
sos element defines a
mergeruntime attribute, which can be
true (default) or
true, Dotfuscator merges the PreEmptive Analytics library into one of the input assemblies. When
false, Dotfuscator writes the runtime library DLL to the destination directory along with the other input assemblies.
There are additional options for PreEmptive Analytics: Enable PreEmptive Analytics, Send Analytics Messages, Don’t Send Tamper Messages, Send Shelf Life Messages, and Send Debug Check Messages.
sendanalytics option tells Dotfuscator to add code to marked assemblies that sends application analytics startup, shutdown, and feature messages to a PreEmptive Analytics Endpoint. Unsetting this option is useful if you want to send tamper messages without analytics.
dontsendtamper option tells Dotfuscator not to send tamper notifications if tampering is detected. This is useful if you want to detect tampering and have your application react locally, but you do not want the application to send messages to a PreEmptive Analytics Endpoint.
sendshelflife option tells Dotfuscator to add code to marked assemblies that adds logic to send shelf life status messages. These include the warning, expiration, and sign of life messages.
senddebug option tells Dotfuscator to add code to marked assemblies that adds logic to send an exception message if an attached debugger is detected.
disable option is used primarily for convenience and troubleshooting purposes. When set, Dotfuscator skips the attribute processing altogether, regardless of what attributes are in the input assemblies and what options are in the rest of the sos section.
|PreEmptive Analytics Processing||
<sos mergeruntime="true"> <!-- Disable PreEmptive Analytics processing --> <option>disable</option> <!-- Send startup, shutdown, and feature messages --> <option>sendanalytics</option> <!-- Do not send tamper messages --> <option>dontsendtamper</option> <!-- Send shelf life messages --> <option>sendshelflife</option> <!-- Send debugging check messages --> <option>senddebug</option> </sos>