Integrate
CylancePERSONA
with a
BlackBerry Dynamics
app

If you previously integrated the separate

BlackBerry Analytics

SDK with your

BlackBerry Dynamics

app, after you upgrade to use SDK version 8.0, do the following to remove the previous integration:

Remove the dependency on the

BlackBerry Analytics

SDK from the

build.gradle

file:

implementation(name:'BlackberryAnalytics-release, ext:'aar')

Verify that the dependency on the SDK .aar file is correctly linked in your

build.gradle

Remove the following method calls within your project:

BlackberryAnalytics.setStage()

BlackberryAnalytics.hostInitializationCompleted()

Add a compile dependency for

Google Play

Services 17.0.0 or later (for example, for

Gradle

, com.google.android.gms:play-services-location:17.0.0).

Add the following

CylancePERSONA

flag metadata to the

<app_name>/assets/com.blackberry.dynamics.settings.json

file, or create the file if it doesn't exist:

{
    "EnableBlackBerryPersona": true
}

In the Settings or Preferences section of your app UI, add a menu item called “BlackBerry Persona Settings” that calls the following method:

BlackberryAnalytics.displaySISsettings.

This method triggers the

BlackBerry Dynamics Runtime

to display a screen that prompts the user to opt in or opt out of

CylancePERSONA

using the user’s location and IP address data when assessing the user’s risk level.

This is a mandatory legal requirement to ensure that the end user can choose whether to allow

CylancePERSONA

to collect and use data.

Verify that the dependency on the SDK .aar file is correctly linked in your

build.gradle

Note that

CylancePERSONA

requires the ACCESS_FINE_LOCATION permission. If you submit the app to

Google Play

, for the question “Display User’s Location to Others”, answer “No”.