Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for iOS 11.2
  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 the following reference to the
      BlackBerry Dynamics SDK
       pod: 
      pod 'BlackBerryDynamics'
    3. To add the BlackBerry Dynamics ATSL to the target app for UI tests, add the following pod: 
      pod 'BlackBerryDynamicsAutomatedTestSupportLibrary'
    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' -- {} \\;")
  end
end
    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_
      <version>
      _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