Keeping Up to Date
The Kendo UI for Angular packages are released frequently with bug fixes and new features.
Semantic Versioning
The Kendo UI packages for Angular are released independently and their version numbers follow the rules of Semantic Versioning:
- A major version bump (X.y.z) signals a breaking change in the API. You might need to update application code or dependencies.
- A minor version bump (x.Y.z) signals the addition of new features. Existing code will continue to work but new features may require additional setup.
- A patch version bump (x.y.Z) indicates a bug-fix release. Typically, patches do not require changes to application code.
In the early stages of development, package versions start in the 0.y.z version range. Up to the 1.0 milestone, the API is considered unstable and minor versions may include breaking changes.
Updating to Compatible Releases
The package.json
file references a major version range—for example, "@progress/kendo-angular-grid": "^3.0.0"
. To fetch the latest compatible Minor or Patch release, run npm update
.
Commit the updated
package-lock.json
file in the source control.
Updating to Latest Versions
To update to the most recent versions of the Kendo UI for Angular components, use npm-check-updates
.
To upgrade all Progress packages, run:
npx npm-check-updates --upgrade --filter "/@progress.*/"
To upgrade only Kendo UI for Angular packages, run:
npx npm-check-updates --upgrade --filter "/@progress/kendo-angular.*/"
In some cases, you may have to specify the location of the
package.json
file:npx npm-check-updates --upgrade --filter "/@progress.*/" --packageFile ./package.json
A successful run will record the updated versions in package.json
and package-lock.json
.
Upgrading between major versions might require you to change the application code.
For more details, refer to the Release History and to the Change Log for each individual package—for example, the Change Log for the Buttons.
Updating to Unsupported Releases
The latest versions of the packages are compatible with the Active and LTS versions of Angular. To update to the most recent versions of the Kendo UI for Angular components that are compatible with a legacy version of Angular, use the respective distribution tags:
ng2
for Angular 2.xng4
for Angular 4.xng5
for Angular 5.xng6
for Angular 6.xng7
for Angular 7.xng8
for Angular 8.xng9
for Angular 9.xng10
for Angular 10.xng11
for Angular 11.x
For example, to update to the latest version of the Buttons package that is compatible with Angular 10.x, run:
npm install --save @progress/kendo-angular-buttons@ng10
To add a package to an existing Angular 10.x project, use ng add
:
ng add @progress/kendo-angular-buttons@ng10
Updating Angular
To generate checklists for upgrading between framework versions, use the Angular Upgrade Guide.