To make sure your Dashboard Plugins are up-to-date with the latest bug fixes and features, it is a recommended practice to occasionally upgrade them. In this article we the basic steps to achieve this are outlined.
You can upgrade the plugins by:
- Bootstrapping a new plugin, or
- Manually performing the necessary steps.
Bootstrap a new plugin
The safest way to perform the upgrade is to bootstrap a whole new plugin using the following command:
npx @gooddata/plugin-toolkit@latest dashboard-plugin init
- Specify the same name as your original plugin.
- Carry over the code you have in your plugin to ensure that all the dependencies, configuration, etc. are up-to-date.
- Test your plugin.
- Rebuild the plugin.
- Redeploy the plugin to the hosting of your choice.
Manually upgrade the plugin
If bootstrapping a new plugin is not suitable for you, you can follow these steps to perform the upgrade manually.
Step 1. Upgrade the @gooddata dependencies
Upgrade all the
@gooddata dependencies to the latest stable version.
To find the version used in your plugin, check your
package.json file for the version next to the
To find the latest stable version available, run the following in your terminal:
npm view @gooddata/sdk-ui-dashboard dist-tags.latest
If the latest version is the same as the one you already have, your dependencies are already up to date and you can move to the next step.
If the versions are different, replace your version with the latest version available for all the
@gooddata packages that have it in the
Make sure to keep the carets (
^) in. Then, run the install command of your package manager:
# for npm npm install # for yarn yarn install
Step 2. Check for updates in the config and harness files
There may also be some changes needed in some of the configuration files and files in the harness folder. To get the appropriate version of the files, use the following URL where the
vX.Y.Z is the version you are upgrading to:
Check the files there to see if there are any significant changes to your plugin directory.
Note: For webpack.config.js, ignore the potential changes in the
proxyobject keys (e.g. if you have
"/gdc", that is fine and you do not need to update that).
Step 3. Test your plugin locally
Run your plugin locally using the
npm start command and make sure it still behaves the way you want.
Step 4. Build and deploy your plugin
Once your plugin works well, build it and deploy it to the hosting you are using for the plugin.