Licence activation

The license can be set by sending extras on an Intent delivered to the application's Activity.
The purchase key (or UUID) and the license key can be provided for the activation.

The extra names are:

kotlin

val EXTRA_PK = "purchaseKey"
val EXTRA_LK = "licenseKey" // Optional

purchaseKey is mandatory.
licenseKey is optional. If provided we'll use it for the activation, otherwise we'll retrieve any remaining license key available in the purchase.

If any of those key is provided but doesn't exist are is already used by another device it'll trigger an error displayed in the application with the reason and the keys used.

Activation by code#

kotlin

val SEND_PACKAGE = "com.benomad.benav"
val SEND_CLASS   = "com.benomad.benav.MainActivity"
val EXTRA_PK     = "purchaseKey"
val EXTRA_LK     = "licenseKey"   // optional

val i = Intent()
i.component = ComponentName(SEND_PACKAGE, SEND_CLASS)
i.flags = Intent.FLAG_ACTIVITY_NEW_TASK
i.putExtra(EXTRA_PK, "<valid_purchase_key>")
i.putExtra(EXTRA_LK, "<valid_license_key>")
startActivity(i)          // NOT sendBroadcast - the keys are read by MainActivity

These extras are read by MainActivity, so they must be sent with startActivity. A broadcast carrying them is ignored: the RNC broadcast receiver only reads BND_MESSAGE.

Activation with deeplink#

Embed a link in an HTML file: <a href="benav://licensing/purchaseKey=<valid_purchase_key>/licenseKey=<valid_license_key>">Click here to activate BeNav</a>.
Open HTML file on the device and click link.

Activation with QR code#

Generate QR code with deep link: benav://licensing/purchaseKey=<valid_purchase_key>/licenseKey=<valid_license_key>.
Open the BeNav5.
Scan QR code with device camera.