Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for iOS 11.0
  3. BlackBerry Dynamics SDK for iOS Development Guide
  4. Integrating CylancePERSONA
  5. Integrate CylancePERSONA with a BlackBerry Dynamics app

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
    BAFBlackberryAnalytics.framework
     from the Link Binary With Libraries build phase.
  • Remove
    BAFBlackberryAnalyticsAssets.bundle
     from the Copy Bundle Resources build phase.
  • Remove the following method calls within your project:
    • BlackberryAnalytics.setStage()
    • BlackberryAnalytics.hostInitializationCompleted()
  • Change the import for the
    BAFBlackberryAnalytics.h
     header from
    #import <BAFBlackberryAnalytics/BAFBlackberryAnalytics.h>
     to
    #import <GD/BAFBlackberryAnalytics.h>
    .
  1. In your implementation of the
    AppDelegate
    , import the header
    BAFBlackberryAnalytics.h
    .
  2. In the app target
    Capabilities
    , enable
    Access WiFi Information
    .
  3. It is recommended that you add the following usage descriptions (or your own custom descriptions) to the
    Info.plist
     file to inform the user why the app requires location permission:
    • NSLocationWhenInUseUsageDescription: "Allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns only when the app is in use. You may change this setting at any time from your device settings."
    • NSLocationAlwaysUsageDescription: "Always allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns, even when the app is not in use. You may change this setting at any time from your device settings."
    • NSLocationAlwaysAndWhenInUseUsageDescription: "Allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns both when the app is and is not in use. You may change this setting at any time from your device settings."
  4. Add the following Persona flag metadata to the
    Info.plist
     file under the ROOT <dict> tag:
    <dict>
       <key>BlackBerryDynamics</key>
       <dict>
             <key>EnableBlackBerryPersona</key>
             <true/>
       </dict>
</dict>
  5. In the Settings or Preferences section of your app UI, add a menu item called “BlackBerry Persona Settings” that calls the following method:
    BAFBlackberryAnalytics.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.