Obtaining & Installing

Obtaining

Downloads location

The most recent version of the Android uSDK can be downloaded here. The corresponding iOS uSDK is located here. Currently, the most recent uSDK version is 6.4 so it is recommended for use. If an older version is needed, then mSIGNIA administration should be contacted.

License key

It is required to obtain a license key to use the uSDKs. Usually mSIGNIA administrator provides it to the customer. The license key should be passed to the uSDK at initialization time as shown later in this document.

The exact way of passing the license key to the uSDK depends on the interface used - it is different for the pure 3DS and the simplified interfaces. Below are links to code samples (for both platforms and interfaces) that show the details:

Installing

Android

Below is a routine for getting the Android uSDK installed in an application.

  1. Place uSDK aar into your application libs directory.

  2. Add these lines inside the dependencies in the app's build.gradle file with actual uSDK aar file name instead usdk-6.X.YY+rel.ZZ:

dependencies { ... // The uSDK implementation(name: 'usdk-6.X.YY+rel.ZZ', ext: 'aar') // uSDK dependencies implementation 'com.google.code.gson:gson:2.8.1' implementation 'com.google.android.gms:play-services-location:${playServicesVersion}' implementation 'com.google.android.gms:play-services-ads-identifier:${playServicesVersion}' implementation 'com.google.android.gms:play-services-auth-api-phone:${playServicesVersion}' implementation 'com.android.support:appcompat-v7:${supportLibVersion}' }

You may need to add libs directory as repository in the app's build.gradle file if you have not used manual linking before:

repositories { flatDir { dirs 'libs' } ... }

iOS

To install the iOS uSDK follow these steps:

  1. Place the uSDK.framework directory into your project directory

  2. In Xcode, click on your project. Then click on the target you want to link to. Finally, click on Build Phases.

  3. Expand the Link Binary With Libraries section.

  4. Click the +

  5. Then click Add Other and choose Add Files

  6. Navigate to uSDK.framework directory

  7. Click Open

The sample applications show the uSDK installed and integrated