We put a lot of effort in the next major version since we announced the
beta state. We built all announced features and finally released the new major versions of the generated
clients and underlying
open-source libraries on the 10th of February
🎉.
How Do I Upgrade?
We tried to make the upgrade experience as smooth as possible for you and created a
detailed upgrade guide. This document guides you through the changes most projects will face when updating to version 2.0 of the SAP Cloud SDK for JavaScript. If you cannot upgrade right away, have a look at our
release policy to learn more about our timelines with respect to major and minor versions. Note that we will not maintain version 1.0 of the SAP Cloud SDK anymore.
What's New?
We mentioned many of the planned changes coming with version 2.0 in our
release announcement already.
But we would like to point out some highlights of the things we've created:
- We split the big core package into multiple smaller packages. So if you just need the connectivity functionality, you can install this now individually reducing the dependency size by approximately 50%.
- We realized that moment.js is a huge dependency and not actively maintained anymore. In the long term, we expect that temporal will become the default way to handle time and date in JavaScript. Since temporal is not yet part of ECMAScript standard yet, we introduced custom (de-)serializers.
These make it possible to switch to temporal easily or use other simple custom (de-)serializers, if you want to.
- We introduced a way to register named destinations from code. This functionality comes in handy in microservice scenarios where a detour over the destination service would be a big overhead.
- We introduced a samples repository which will give you tested sample applications or code samples showcasing functionality of the SAP Cloud SDK.
What if I Face Issues During the Upgrade?
First of all it is great that you are interested in the new features and want to upgrade to version 2.0. Of course it can happen that you are facing a problem not covered by our
upgrade guide. If you hit such a blocker please create an
issue in our repository. We will help you resolve the issue and your case will help us improve the documentation and also help other developers with the same problem.
