Migrate to the New Version

After downloading and installing a new version of DevExtreme libraries, update your projects. This article will guide you through the upgrade process. If you experience any problems while upgrading your projects, please refer to our Support Center.

General Instructions for Major and Minor Versions

Whether you upgrade your projects from another major version or from a previous minor version to a 14.1.X DevExtreme version, follow the following general instructions.

Upgrade VS DevExtreme Applications

Use the Project Converter tool for the Visual Studio projects that were created using DevExtreme Project Templates.

There are two ways of accessing the Project Converter.

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

    Invoke Project Converter

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

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

Project Converter

Review the advanced options. Check Process Subdirectories if you also want to upgrade files in any subdirectories. Check Create Backup Files to create copies of the original files that are about to be upgraded (Project Converter will add a .bak extension to the file names of the copies), so that you can recreate the original project should you encounter any problems.

NOTE: We recommend that you check Create Backup Files if you have customized layouts or stylesheets in your projects. By doing so, you will be able to extract your customized layouts or stylesheets from those file copies to merge with the new versions.

Finally, click Upgrade and the Project Converter will upgrade your project(s) to the new version.

Upgrade Apps with DevExreme Scripts

Follow the steps below to manually upgrade your applications that use the DevExtreme libraries.

  • Update Scripts
    Copy the new JavaScript files from the [Sources]/Lib/js DevExtreme folder to the equivalent folder in your applications.

  • Update Stylesheets
    Copy the new CSS files from the [Sources]/Lib/css DevExtreme folder to the equivalent folder in your applications.

  • Update Layouts
    Copy the new layout files from the [Sources]/Lib/layouts DevExtreme folder to the equivalent folder in your applications.

  • Updated the Export Folder
    If you are also using the Export feature, copy the new files from the [Sources]/Exporter folder to the same folder in your apps.

Breaking Changes

We always do our best to minimize the impact each new version may have on your projects. Occasionally, however, it is necessary to change control behavior and/or make certain members obsolete. We do this to improve the quality of our products. Take into account the breaking changes in this release and upgrade your apps according to the instructions given for each breaking change.

14_1 Version Specifics

When upgrading from a previous major version to version 14.1.X, take into account the following changes.

Repackaging

With version 14.1, packaging of DevExpress HTML5/JS products was simplified to accommodate broader features and new enhancements.

  • PhoneJS is now known as DevExtreme Mobile
  • ChartJS now forms a part of DevExtreme Web, along with the DevExtreme SPA Framework and web-optimized UI widgets
  • As before, DevExtreme is the complete product but is now known as DevExtreme Complete.

Despite this repackaging, the library names have not been renamed. This means you can easily upgrade your projects to the new version. If you have a license to DevExtreme Complete, you can use the Project Converter tool. If you have DevExtreme Mobile or DevExtreme Web, you will have to update your projects manually.

New Links to DevExtreme Themes

Previously, the links to theme files looked like this.

HTML
    <link rel="stylesheet" type="text/css" href="css/dx.common.css" />
    <link rel="stylesheet" type="text/css" href="css/dx.ios.default.css" />
    <link rel="stylesheet" type="text/css" href="css/dx.android.holo-dark.css" />
    <link rel="stylesheet" type="text/css" href="css/dx.desktop.default.css" />
    <link rel="stylesheet" type="text/css" href="css/dx.win8.black.css" />

In the new version, the links have this format.

HTML
    <link rel="stylesheet" type="text/css" href="css/dx.common.css" />
    <link rel="stylesheet" type="text/css" href="css/dx.spa.css" />
    <link rel="dx-theme" data-theme="ios.default" href="css/dx.ios.default.css" data-active="true" />
    <link rel="dx-theme" data-theme="ios7.default" href="css/dx.ios7.default.css" data-active="true" />
    <link rel="dx-theme" data-theme="android.holo-dark" href="css/dx.android.holo-dark.css" data-active="true" />
    <link rel="dx-theme" data-theme="generic.light" href="css/dx.light.css" data-active="true" />
    <link rel="dx-theme" data-theme="win8.black" href="css/dx.win8.black.css" data-active="true" />
    <link rel="dx-theme" data-theme="win8.white" href="css/dx.win8.white.css" data-active="false" />

For more details on the supplied themes and the ways to use them in DevExtreme applications, please refer to the Predefined Themes article.

NavigationType in SPA Applications is Deprecated

The navigationType option has now been deprecated. Replace each use of navigationType with the equivalent layoutSet option. For more information on the provided predefined layout sets, refer to the Built-in Layouts topic in the documentation.