DevExtreme Angular - Migrate to the New Version

After installing a new DevExtreme version, update your projects using the instructions in this article.

Depending on how your app receives DevExtreme sources, do the following:

Replace the version in CDN links. Relevant links are listed in the CDN Services article.

Run the following commands:

npm install devextreme@18.2 --save --save-exact

npm install devextreme-angular@18.2 --save --save-exact // If you use DevExtreme with Angular
npm install devextreme-vue@18.2 --save --save-exact // If you use DevExtreme with Vue
npm install devextreme-react@18.2 --save --save-exact // If you use DevExtreme with React

Follow the steps below to upgrade a theme created in the Theme Builder if you saved the theme's metadata:

1. Open the Theme Builder.

2. Click Import and select Import metadata from the drop-down menu.

   

3. Copy and paste the theme's metadata to the invoked window. Click Apply.

   

4. A warning is displayed that notifies you that the metadata's version does not match the Theme Builder's version. Different versions can cause issues if the Less variables used in the metadata were renamed or removed. Click Yes to continue applying the metadata.

   

5. Check that the metadata is applied, perform additional customizations if required, and save the upgraded theme.

See What's New in v18.2 to learn about the new features, or browse the DevExtreme version history for details on which features any major or minor release implemented and the issues they resolved.

We always do our best to minimize the impact an upgrade has on existing projects. However, it is often necessary to change our tools' UI, API, or behavior to improve them. Take the following into account to ensure that your app works after upgrading:

• Breaking Changes
  Refer to the breaking changes introduced in v18.2. Follow the instructions given for each change to mitigate its possible impact.

• Deprecated API
  We recommend replacing depreciated APIs with their relevant counterparts because they can break your app once they are removed. Run the upgraded app and open the browser's console. A notification suggesting replacements is displayed if your code uses a deprecated API. Update your code to use the replacements instead of the deprecated API.

You can submit a ticket to our Support Center if you experience any problems migrating to the new DevExtreme version.