Updating to the latest Mobiscroll version

In this guide you will learn how to update an already installed package in your project to the latest version. If you are looking for how to install Mobiscroll for the first time, you can check the getting started guide, if you want to upgrade from trial to a licensed version you can check out our upgrade guide.

In order to have access to the latest version, you will need an active maintenance.

There are multiple options on how to update to the latest version, depending on how you installed Mobiscroll in your project in the first place and what kind of license you have:

1. Updating from our NPM repository (only for Framework & Complete license)
2. Updating with the Mobiscroll CLI (only for Framework & Complete license)
3. Updating with the Mobiscroll CLI using a downloaded package
4. Updating the package manually

1. Updating from our NPM repository

Prerequisites

• Mobiscroll was set up with the Mobiscroll CLI before
• You own a Framework or Complete License

Update Steps

Running the following command in your project root folder will update your package to the latest:

$ npm update @mobiscroll/javascript

2. Updating with the Mobiscroll CLI

Prerequisites

• Mobiscroll was set up with the Mobiscroll CLI before
• You own a Framework or Complete License

Update Steps

Running the following command in your project root folder will update your package to the latest:

$ mobiscroll config javascript 

3. Updating with the Mobiscroll CLI using a downloaded package

Prerequisites

• Mobiscroll was set up with the Mobiscroll CLI before
• You don't have a Framework or Complete license OR You customized the Mobiscroll package in your project via Download Builder

This option can be used if you don't have access to the full framework (you don't have a Framework or Complete license), or if you customized the package in your project to only contain a number of components that you need.

Step 1. Download a new package

The first step is to download a new package from the download page. There is a version dropdown at the top right corner of the screen. You can check there that you selected the latest version. After selecting the components, themes, languages and icon packs you need, hit the download button.

Note: Make sure you select all the components and themes you used in your project, otherwise they will not work after the update.

Hint: You can save / bookmark the download page URL to keep track the download configuration you used.

Step 2. Copy the resources to your project

After unzipping the downloaded package, copy the lib folder to your project's src folder.

Step 3. Run the config command

Running the following command will update the package in your project:

$ mobiscroll config javascript --no-npm

3. Updating your package manually

Prerequisites

This option is suitable if you have a project with no dedicated build process, or where the source files are referenced on the web pages directly via <script> and <link /> elements.

Step 1. Download a new package

The first step is to download a new package from the download page. There is a version dropdown at the top right corner of the screen. You can check there that you selected the latest version. After selecting the components, themes, languages and icon packs you need, hit the download button.

Note: Make sure you select all the components and themes you used in your project, otherwise they will not work after the update.

Hint: You can save / bookmark the download page URL to keep track the download configuration you used.

Step 2. Copy the resources to your project

After unzipping the donwloaded file, grab the js and css folders and replace with them the ones in you had in your project.

Additionally you can check whether the paths are stil pointing to the right files in your pages <script src="..."> and <link href="..." /> element attributes.