Replace older DevExtreme files with the latest version. You can find the new files in the DevExtreme zip archive or DevExtreme folder (C:\Program Files (x86)\DevExpress 21.1\DevExtreme\Sources\Lib by default).
If you customized the old CSS files, you should make the same changes to the new CSS files and only then use them as a replacement.
Replace the version in CDN links. Relevant links are listed in the CDN Services article.
Run the following commands:
npm install email@example.com --save --save-exact npm install firstname.lastname@example.org --save --save-exact // If you use DevExtreme with Angular npm install email@example.com --save --save-exact // If you use DevExtreme with Vue npm install firstname.lastname@example.org --save --save-exact // If you use DevExtreme with React // If the application is created using the DevExtreme CLI npm install email@example.com --save --save-exact npm run build-themes
Follow the instructions from the Upgrade to a New Version article.
Follow the steps below to upgrade a theme created in the ThemeBuilder if you saved the theme's metadata:
Open the ThemeBuilder at the Import a Theme from DevExtreme Metadata view.
On the view, click Upload File and select the
.jsonfile that you exported previously. If you copied the metadata rather than exported it as a
.jsonfile, paste it in the text area and click Upload Metadata:
Check that the metadata is applied, perform additional customizations if required, and export the upgraded theme.
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:
Refer to the breaking changes introduced in v21.1. Follow the instructions given for each change to mitigate its possible impact.
We recommend replacing deprecated properties and methods 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.