Share via


Upgrade Dotfuscator Community

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Dotfuscator Community offers many application protection and hardening features immediately to all developers using Microsoft Visual Studio. However, there are more features available to users who upgrade their version of Dotfuscator.

This User Guide covers PreEmptive Protection - Dotfuscator Community 6. Depending on your installation history and version of Visual Studio, you may be currently running Dotfuscator Community 5, the prior major version. If so, you should upgrade, because it is important to ensure your code is being given the latest protection measures. Upgrades are available at no charge.

This page explains how to determine what version you currently have, how to upgrade to version 6 if necessary, and what features have been replaced or removed between the two versions.

Determining Dotfuscator's Version

If you are unsure what version of Dotfuscator you are running, you can determine the version by doing one of the following:

  • Launch the Dotfuscator Community graphical user interface (GUI) by going to Visual Studio's Tools menu and selecting PreEmptive Protection - Dotfuscator Community. From the Dotfuscator GUI, open the Help menu, and select About... to display the About screen. This screen will list Dotfuscator's version.

  • If you have Dotfuscator integrated into your build with the command line interface (such as with Xamarin apps), you can also check your build logs for a line like the following:

    Dotfuscator Community Version 5.42.0.9514-e0e25f754
    

    You may need to increase your build's verbosity in order to see this text. For Visual Studio, see Verbosity Settings.

The first integer of the version, before the first dot ., indicates Dotfuscator's major version. If this is 5, then you should perform the upgrade steps on this page, so that you can take advantage of the latest Dotfuscator 6 features and protection updates.

Upgrade Instructions

This section includes sets of instructions for upgrading typical usages of Dotfuscator Community from version 5 to version 6.

Installing Dotfuscator 6

Dotfuscator Community is distributed as an extension for Visual Studio. The instructions to install Dotfuscator 6 vary by which version of Visual Studio you have:

  • Visual Studio 2019. Dotfuscator Community 6 is included in later versions of Visual Studio 2019 (version 16.10.0 and later). Update Visual Studio 2019 to the latest version. This will automatically upgrade any Dotfuscator Community 5 installation to Dotfuscator Community 6.

    • If you do not have Dotfuscator installed already, update Visual Studio first and then see Installation.

    • In addition to the releases with Visual Studio, you can always get the latest versions of Dotfuscator Community from the Dotfuscator Downloads page.

  • Visual Studio 2017. This version of Visual Studio only shipped with Dotfuscator Community 5. However, you can install or upgrade to Dotfuscator Community 6 by going to the Dotfuscator Downloads page and selecting the appropriate download link.

    Run the downloaded .vsix file and follow the prompts to install Dotfuscator Community 6 into Visual Studio. This will upgrade existing Dotfuscator Community 5 installations.

  • Earlier versions of Visual Studio. Dotfuscator Community 6 is not supported in these versions of Visual Studio. We recommend upgrading to a newer version of Visual Studio, or upgrading from Dotfuscator Community to Dotfuscator Professional.

If you had previously registered Dotfuscator Community 5, that registration will be automatically converted the first time you run Dotfuscator Community 6.

Updating Paths to the Command Line Interface

For the CLI update instructions, see the Updating from Community 5 page of the full Dotfuscator Community User Guide.

Upgrading Dotfuscator Config Files

For the config files upgrade instructions, see the Updating from Community 5 page of the full Dotfuscator Community User Guide.

Updating Xamarin Integration

For the Xamarin Integration update instructions, see the Updating from Community 5 page of the full Dotfuscator Community User Guide

Updating References to Attribute Libraries

For the References to Attribute Libraries update instructions, see the Updating from Community 5 page of the full Dotfuscator Community User Guide.

Removed Features

Dotfuscator Community 6 introduces breaking changes from Dotfuscator Community 5. If you have been using Dotfuscator Community 5, this section describes how to deal with the changes that might require build modifications or affect Dotfuscator's output. A full list of the changes is available in the changelog.

Registering Dotfuscator Community

Registered users of Dotfuscator Community get access to additional features, such as command-line support, which makes it easy to integrate Dotfuscator Community into your automated build process. Registering also grants access to a built-in tool used for decoding obfuscated stack traces.

Registration is quick, simple, and free of charge. To register Dotfuscator Community, see the instructions in the full Dotfuscator Community User Guide.

Upgrading to Dotfuscator Professional

While Dotfuscator Community provides a basic level of protection, upgrading to PreEmptive Protection - Dotfuscator Professional will give you access to enhanced obfuscation transforms and protection capabilities. These include:

Dotfuscator Professional is the industry standard .NET Obfuscator and is suitable for enterprise developers requiring ongoing support, maintenance, and product updates. Additionally, Dotfuscator Professional offers tighter integration with Visual Studio and is licensed for commercial use.

For more information on the advanced application protection features of Dotfuscator Professional, please visit our Dotfuscator Overview page and compare Dotfuscator Professional to Dotfuscator Community.

Fully-supported trials of Dotfuscator Professional are available on request at preemptive.com..

See also

Upgrade Dotfuscator Community

Dotfuscator Community User Guide