Contents

SDK license requirements

The table shows which SDKs are free to use and those which need a license.  

In practice, to download an SDK you will select an SDK Edition which contains a combination of SDKs as follows:

Types of license and how to get one

From a commercial point of view there are different types of license available and you will need to select one to suit your needs.

License Types

Using the License Management System - LMS

This is currently restricted to the management of evaluation licenses:

• Open the Developer Dashboard: https://developer.wacom.com/developer-dashboard To open the page you will need to login with your Wacom ID
• Select Licence Keys to display the Manage License Keys page
• Click New Evaluation License:
  
  
  
  
• You can now select Generate License for the required product:
  
  
  
  A message box indicates that a license has been created:
  
  

• Select Licence Keys to return to the Manage License Keys page. License keys are now available for download:
  
  
  
  
• Click the Download icon to download the license. The license will be saved to a file named 'license.txt' by default.
• At any time you can click the link to 'Renew License' then download a new license with a revised expiry date:
  
  

General License Information

Evaluation Licenses

The licenses are fully functional but expire 3 months after their creation date. An evaluation license can be renewed when required. In the case of the Signature SDK a signature captured using an evaluation license will be displayed with an 'Evaluation' watermark:

License format

Licences are generated in the JSON Web Token (JWT) format and are downloaded to a file such as 'License.lic'.

The JWT license contains three sections: Header.Payload.VerifySignature

See https://jwt.io/introduction/ for further details of the JWT format.

The payload section of the license contains field values including:

• license type - evaluation / commercial / enterprise
• expiry date
• App ID
• SDK supported features

The license is supplied as a text string similar to this example:

eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJMTVMiLCJleHAiOjE1MjUxMzI3OTksImlhdCI6MTUyMjMzMzkwNCwicmlnaHRzIjpbIkJBWFRFUl9BQ0NFU1MiLCJDRExfQUNDRVNTIiwiQ0RMX0xJVkVfU1RSRUFNSU5HIiwiQ0RMX1RISVJEUEFSVFlfUEVOUyIsIkNETF9QSFVfMTExIiwiU0lHX1NES19DT1JFIiwiU0lHQ0FQVFhfQUNDRVNTIl0sImRldmljZXMiOltdLCJ0eXBlIjoiZXZhbCIsImxpY19uYW1lIjoiV2Fjb20gRGVtbyBTYW1wbGUiLCJ3YWNvbV9pZCI6bnVsbCwibGljX3VpZCI6IjVjNGM2MmUyLTRiYzUtNGQ2My1hOWY5LTNkZGI4NzZlNTg3NyIsImFwcHNfd2luZG93cyI6W10sImFwcHNfaW9zIjpbXSwiYXBwc19hbmRyb2lkIjpbXSwibWFjaGluZV9pZHMiOltdfQ.iq4w04_Ip5wRobYGvmxHmIrq2KvoE13U8uDjkcncnHVbrENLnQKGVZGueDCfwMtlwhfAZ83u5W7S9wBIkA25xHfxrp969GI0C8PfaQfyGrgbAp4K1WonXdcIF6PU7A5SCjx6PhylUjEw-8SCp7K4Qe14r019ZxD7_dQUlKTjB2mYcrxoZelZ6oRFyPVgAzHZ0VaYcicPtWUGUFSqspos08B_5XjHmrqMAGBgoWeIDwCDKNuKKKRxWinXGYz3kUm8aiC66jlk-B9W8D587jEJ0nPG_bY3k0FCoViU3F5qNRTrRbXfmPnjjsrQfCygKJx1bJwWkJfs3jnT2gP0K-i9oQ

A JWT viewer can be used to display the contents of the license string, for example:

{
  "iss": "lms",
  "aud": "wes",
  "exp": 1577836800,
  "iat": 1501580587,
  "sub": "WILL",
  "rights": [
    "CDL_ACCESS",
    "CDL_LIVE_STREAMING",
    "CDL_THIRDPARTY_PENS"
  ],
  "given_name": "Will ",
  "family_name": "Test",
  "email": "developers@wacom.com",
  "type": "eval",
  "lic_name": "WILL Devices Sample",
  "lic_uid": "d8c3160a5d153af806256fcb9e88803ec5c68a48542a0de6b570fba02ba886e1",
  "apps_ios": [
    "NA"
  ]
}

As you might expect, the license contents can be viewed but not changed since the data is digitally signed.

APP ID

Most licenses require an Application ID (App ID) and this will be required when generating a license on the LMS or when requesting a license from Wacom Sales.

An APP ID is used to publish an application online (e.g. Apple Store or Google Play).

The same ID is used to generate an application license. An example could be:

com.health.mycompany.registration

An App ID is not required for an evaluation license.

To locate the App Id in an application's source code:

License Installation

The method of license installation is application dependent.

Typically the license string will be copied into the application code, for example:

try {
     InputStream license = assetManager.open("license.lic");
     LicenseBootstrap.initLicense(this.getApplicationContext(), LicenseBootstrap.readFully(license));
    }

License Expiry

A license becomes invalid when it expires for one of the reasons:

• evaluation expiry date exceeded
• licence expiry date exceeded

When a license expires the related SDK functions cease to operate and instead return a license error code. The error condition must be handled by the application.

An exception to this rule is the WILL SDK for signature:

• Expired production license: when the license has expired the SDK remains fully functional but signatures will be displayed with an 'Evaluation' watermark.
• Expired evaluation license: when the license has expired signature capture will return an error.