PLUSNative Android Studio Licensing Sample

If you haven't already done so, download the Protection PLUS 5 SDK Android Edition zip file (usually named ProtectionPLUS5Android.zip).  You will typically acquire a link or button to download this zip file in an email if you are evaluating, or by logging-in as an existing customer at www.softwarekey.com. After downloading this zip file, extract its contents to a directory / folder of your choosing, and take note of the location you selected.

Next, open Android Studio. From the Welcome screen select "Open an existing Android Studio Project", or from within Android Studio use the File/Open menu. Browse to the Protection PLUS 5 SDK Android Edition\Samples\Java\Android\LicensingSample sub-directory located where you extracted the Protection PLUS 5 SDK Android Edition zip file.

From the File menu select Project Structure to show the Project Structure settings.

On the left click Project then on the right select your desired SDK in the drop-down and click the OK button.

Connect your Android device. Optionally, you may use your preferred emulator.

From the menu select Run/Run...

Select the Device to use.

On the device you will see the main LicensingSample Activity.

To activate the Sample Licensing Application automatically using SOLO Server, press the Activate Online button. A new Activity will prompt for a License ID and Password (both are required). Specifying an installation name is optional but helpful when performing multiple installations for different machines and/or users.

For ease of use, all of the Protection PLUS 5 SDK sample applications use a generic Test Author account with its own Encryption Key ID. We will use this Test Author account on SOLO Server to generate the License ID and password necessary to activate the Licensing Sample

To log into the SOLO Server Test Account, use the Test Author credentials given below:

Login ID: test
Password: test

Once logged in, go to the menu Configure / Products.

The Product List page will show all of the products available to the Test Author. Expand ‘Show Options’ beside the Protection PLUS 5 SDK Sample product. The Option Details show different Product Options for activating the Licensing Sample application. For this tutorial, we will generate a license for the Full License.

Creating the License

To add a test license, go to the menu Customers / Add Test License.

Select the Protection PLUS 5 SDK Sample Full License and click Add New Test License.

On the Add Test License page, do not change the default values and click Add License.

The test license has now been created based on the Protection PLUS 5 SDK Sample Full License Product Option settings and attached to a new, unregistered customer record.

Click on the License ID in the Licenses & Other Items section to load the License Details page.

Activating with the License

Return to the activation prompt for our Licensing Sample.

Enter the License ID and Activation Password in their respective fields and, optionally, an Installation Name.

Click Activate to communicate with SOLO Server for license validation.

Upon successful activation, a confirmation dialog is shown. If the activation fails, please verify the information entered with the license details on SOLO Server.

The License Status will now show as Fully Licensed.

A license can be refreshed with updated information sent from SOLO Server. We can modify customer details from the License Details page on SOLO Server. On the License Details page, click Edit, located to the right of the Customer ID.

Modify the Company Name and additional fields as you please. Uncheck the check box setting to the right of Unregistered. Scroll to the bottom and click Save.

After the Customer Details have been saved, the page returns to the Customer Information page. This page includes customer details we have edited in addition to licenses and previous orders.

Return to the Licensing Sample Main Activity to proceed with a license refresh. Press Refresh License. If the license successfully refreshed, the License Status will now update with the modified customer details.

Deactivating an installation disables use of the software on that device, and increments the Activations Left count of the License ID in SOLO Server, which allows the user to activate the software on a different device. The License ID also has a Deactivations Left count, which allows you to limit the number of times a customer can deactivate and transfer a license.

The Protection PLUS 5 SDK Sample Full License Product Option is configured to start with one Activation Left and one Deactivation Left. After activating in Step 2, the License ID you are using should not have any Activations Left.

To deactivate, click the Deactivate button. A confirmation will appear if the license was successfully deactivated.

The License Status will now show "Evaluation expired."

In SOLO Server, this License ID will now have one Activation Left and zero Deactivations Left, which allows the user to activate one more time on a different computer. You can manually update the number of Activations or Deactivations on the License Details page in SOLO Server.

An installation can also be remotely deactivated through SOLO Server.

A manual activation allows you to activate a computer that does not have an Internet connection. It will create an activation request that must be transferred to another device that does have an Internet connection. The request can be a string or a file.

If you previously activated this sample application, but have not deactivated yet, please complete Step 4 before continuing.

Click Activate / Activate Manually to proceed with testing a manual activation.

Return to SOLO Server using the Test Author account. Perform a quick search for the License ID previously used to activate online (If you no longer have this number, proceed to create a new License ID as shown in Step # 2).

When we clicked on deactivate license, SOLO Server automatically incremented the amount of activations left by 1. This setting was predefined in the Product Option ID we selected for testing. If you need to manually increase the number of activations left, you can increment this number by clicking the + button to the right of the Activations Left field.

Return to the Activate Manually screen for our Licensing Sample. Enter the License ID and Password in their respective fields and press Generate Request as it will then be enabled.

Browse to a location to save the file.

Save the generated request file.

Transfer this request file to your computer and double-click it. Your computer's browser will open to the License Portal page.

The License Portal will now generate an encrypted response. Click the Download button and save the response file to the computer. Transfer this file back to the Android device.

Return to the activation and press the Open Activation File button. Browse to the response file you transferred back to your device.

Upon successful activation, a confirmation dialog is shown. If the activation fails, please verify the information entered with the license details on SOLO Server.

The License Status will now show as Fully Licensed.