Configure a new or existing BlackBerry Dynamics app to use the dynamic framework

If required, Prepare an existing BlackBerry Dynamics app to use the dynamic framework.
Choose one of the following methods to configure the app to use the BlackBerry Dynamics SDK dynamic framework. BlackBerry recommends using the CocoaPods method.

Method

Steps

Use CocoaPods
  1. If you don’t have an existing pod file, use the following commands to create one: 
    cd ‘<project_directory>’pod init
  2. Add one of the following references to the BlackBerry Dynamics SDK pod: 
    pod 'BlackBerryDynamics', :podspec => 'https://software.download.blackberry.com/repository/framework/dynamics/ios/BlackBerryDynamics.podspec'

    or

    pod 'BlackBerryDynamics'
  3. To add the BlackBerry Dynamics ATSL to the target app for UI tests, add the following pod: 
    pod 'BlackBerryDynamicsAutomatedTestSupportLibrary'
    For more information, see Add automated testing to your BlackBerry Dynamics iOS app.
  4. If default.xcconfig is used by your application, add the following to the end of your Podfile: 
    post_install do |installer|  # Append configuration from default.xcconfig to configuration generated by Cocoapods  if Dir.glob("**/default.xcconfig").first()    system("find Pods -name 'Pods-*.xcconfig' -exec sh -c 'cat `find . -name default.xcconfig` >> $1' -- {} \\;")  endend
  5. Install the pods, then open your .xcworkspace file to see the project in Xcode: 
    $ pod install

$ open <your-project>.xcworkspace

Use the files available in the SDK package
  1. Extract the contents of the BlackBerry_Dynamics_SDK_for_iOS__dylib.tar.gz file from the SDK package to a directory.
  2. In the Frameworks, Libraries and Embedded Content list of the project target, add BlackBerryDynamics.xcframework, and GSEProvider.xcframework. Set the frameworks to Embed and Sign so that Xcode will change the project file by adding the frameworks to the Embed Frameworks step in the Build Phases and will configure the Runpath Search Paths accordingly.
  3. In the Build Settings of the project target, update Framework Search Paths to include the directory of the BlackBerry framework files.
  4. In the Header Search Paths, include the following entry: <directory_with_framework_files>/BlackBerryDynamics.xcframework/Headers.