How to upgrade from the trial version
Requirements
Acquiring a license
When upgrading from a trial license to a commercial, the first step is to purchase the commercial license.
This can be done from our pricing page among other areas of our website.
If you are still looking for which license to choose or if you have any questions, let us know! We are here to help!
Assigning the license to the developer
After the purhcase of the commercial license, it should be assigned to the developer, who will do the development. This can be done immediately after the purchase, or later from the licenses page. When the buyer and the developer is the same person, the license can be self-assigned as well.
Upgrading the library in your project
You have one or two options when upgrading from trial, depending on what kind of license you have:
If you have a Framework or a Complete license, you have both of the options available. On the other hand, if your have access to only specific components, then you can use the second guide to upgrade your project.
Both of the above are done with the Mobiscroll CLI. If you don't have the CLI installed, here's how to do it.
The Mobiscroll CLI is only needed for the configuration. You can install it on your local development machine, and configure your app there. It doesn't have to be installed on your server.
1. Upgrading to Framework or Complete license
This method will include the full mobiscroll package into your project from NPM. In order for this to work, you will need a Full Framework or a Complete license.
To upgrade the trial package in your project, the commercial license needs to be assigned to your account. If you are the developer, but somebody else purchased the license, then the buyer can assign the license to your account. You should instruct the buyer to log in to his account and proceed to the licenses page. From there, he can assign the license to you account.
After the license is assigned to your account, run the following commands in your project root directory to upgrade the package:
Step 1. Log in to your account
If you are using the same account for the commercial license that you were using with the trial, then you can skip this step.
$ mobiscroll loginWhen you are asked, please provide your credentials. If you haven't set a password yet, you can set one from your account page.
Step 2. Configure the project
$ mobiscroll config react If you are using Ionic, you need to pass ionic to the command instead of react:
$ mobiscroll config ionic At this point the trial package should be replaced with the commercial package, and building and running your project should work.
2. Upgrading to a Component license
With this method, you will download a package from our website, then you will use the Mobiscroll CLI to install that package to your project.
If you don't have access to the Full Framework, or if you want to customize your package to only contain specific components, this is the way to go.
Step 1. Download your package
Access the download page, by logging in to your account. The commercial license needs to be assigned to your account. If you are the developer, but somebody else purchased the license, then the buyer can assign the license to your account. You can instruct the buyer to loggin into his account and proceed to the licenses page.
After selecting the components, themes, custom themes and font icon packs that you need, hit the download button and download your package. If you have multiple licenses and have access to multiple frameworks, you might need to select the framework as well.
Step 2. Copy the library to your project
Extract the zip file you just downloaded, then grab the js, src and css folders and copy it into the src/lib/mobiscroll folder of your project. If there is no such folder available, you should create it.
Step 3. Configure the project
Run the config command in your project's root folder with the --no-npm flag to proceed with the upgrade
$ mobiscroll config react --no-npmIf you are using Ionic, you need to pass ionic to the command instead of react:
$ mobiscroll config ionic --no-npmThe Mobiscroll CLI under the hood will create and install a local NPM package from the lib folder. After the installation is complete, your package.json file should have an entry for a dependency like this:
"@mobiscroll/react": "file:./src/lib/mobiscroll-package/mobiscroll-react-4.10.1.tgz",The .tgz file referenced here is the mobiscroll package and it should be added to your repository too.
At this point the trial package should be replaced with the commercial package, and building and running your project should work.