Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for iOS 13.0
  3. BlackBerry Dynamics SDK for iOS Development Guide
  4. Steps to get started with the BlackBerry Dynamics SDK
  5. Using the BlackBerry Dynamics SDK framework
  6. Configure a new or existing BlackBerry Dynamics app to use the dynamic framework

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

  1. 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,
      BlackBerryCerticom.xcframework,
      BlackBerryCerticomSBGSE.xcframework
      .Set all of the above 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.