Migrate to the New Version

Once a new version of DevExtreme is downloaded and installed, projects must be updated. Use the Project Converter tool, available with the DevExtreme installation, to update your projects. This document will guide you through the upgrade process.

If you face any issues while migrating, please contact us via our support center.

Run the Project Converter

Run the Project Converter using one of the following approaches.

  • Open your solution/project in Visual Studio. Right click the solution/project and choose Upgrade DevExtreme Solution to the Latest Version.../Upgrade DevExtreme Project to the Latest Version... in the invoked context menu.

    Invoke Project Converter

  • Run the ProjectConverter.exe from the folder where DevExtreme is installed. By default, it is located at the "...\Program Files (x86)\DevExpress 13.2\DevExtreme\Tools\" folder.

    Project Converter

Specify the path to the project(s) to be upgraded in the Project folder text box.

Look through the advanced options. Ensure that the Process subdirectories option is checked if you want to upgrade the necessary files in subdirectories. Confirm that the Create backup files option is enabled. In this case, the ProjectConverter will create copies of the files that are to be upgraded (the .bak extension will be added to the copies of the files), so that you can restore them if you have any problems.

NOTE: We recommend that you enable the Create backup files option if you have customized layouts or stylesheets in your projects. In this instance, you will be able to merge your customized layouts or stylesheets (accessible in the created copies) with the updated ones.

Click the Upgrade button, at which time your project(s) will be upgraded to the new version.

Common Changes

Follow the instructions provided by the framework to perform cross-platform changes in your applications.

Desktop Applications

To upgrade your desktop application project, do the following.

  • Add the DesktopLayout.js to your project.
    Ensure that the DesktopLayout.html, DesktopLayout.js and DesktopLayout.css files are added to your project. You can find them in the DevExpress 13.2/DevExtreme/Sources/Lib/layouts/Desktop folder.

  • Set the "Desktop" theme explicitly.
    Previously, the "Desktop" theme was applied when an application is running on a desktop or on a device for which there is no appropriate theme. Now, the "Generic" theme comes with the framework. This theme is used in the listed scenarios by default. So, set the "Desktop" theme explicitly, using the following code.


WinJS Applications

To upgrade your WinJS application project, do the following.

  • Previously root view navigation icons were invisible by default. Now they are visible. If you don't want certain views to be available in the global navigation, remove them from the navigation declaration.

  • If you have the layout option set to 'navbar' in your dxView markup component that represents the root view (in the home.html or home.dxview file usually), remove this option from the configuration.