How to Deploy A Wijmo License

How to Deploy A Wijmo License

Posted on 4/17/2018 4:16:55 PM

As of Wijmo Release 2018, v1, all Wijmo apps will require distribution licenses. Here's how to deploy your apps with the new licensing.

While developing Wijmo applications using localhost, Wijmo licensing is never an issue. We want development to be frictionless and fast. The only thing that shows up in an unlicensed app during development is the evaluation watermark.

When deployed to a server environment (non-localhost), Wijmo licensing will pop up a dialog with information. This popup will describe any licensing issues you may have and inform you if a Distribution Key is needed.

To get rid of the licensing popup, we need to create a Distribution Key on the My Account section of the GrapeCity website.

Register your serial key in the box at the top of the page. Your serial key was sent when the purchase was completed; if you didn't purchase Wijmo personally, check with your procurement officer.

On the My Licenses page, scroll down to find the product for which you want to create a license. In this example, we're using Wijmo Enterprise.

Click “Create Distribution Key” next to the desired product.

Now let's add domains to be included in this Distribution Key.

Make sure to add all of the domains you might need at this time. Consider testing domains, staging domains, production domains and anything else you might need. You only want to generate a key once to handle all domains that your application will run on.

If you need a wildcard license key because you don't know all your domains, you'll need to contact sales directly. Wildcards are not available through this portal.

Once you're sure you have added all of the domains you need, click “Generate Distribution Key." Then confirm the domains and click “Submit” if correct.

Now you'll see a page with your Distribution Key in a textbox. Copy the Distribution Key to your clipboard.

Open your Wijmo application in the editor of your choice. Find a place in code before you have initialized any Wijmo controls.

Call the following method and paste your Distribution Key as a string inside it.

Refresh your application and you should see the licensing popup and evaluation watermark disappear.

Note: if you're importing Wijmo using a module loader, you need to call setLicenseKey on your module reference to Wijmo instead of using the global wijmo variable.

And that’s it! Now you have licensed your application and can deploy it to any domain that you added to the licenseKey.