Prepare an existing BlackBerry Dynamics app to use the dynamic framework

Complete the steps below if you have an existing BlackBerry Dynamics app that uses the static BlackBerry Dynamics SDK library (GD.Framework).
  1. Delete the ~/Library/Application Support/BlackBerry folder.
  2. In the Xcode Project Navigator panel for your project, delete all of the references to GDAssets.bundle and GD.framework or GD.xcframework.
  3. Update the project’s import paths to reference BlackBerryDynamics instead of GD.
    • For example, for C-style import or includes, change GD/ to BlackBerryDynamics/GD/.
    • For module-based imports, replace GD with BlackBerryDynamics.
    Note: GD_C_NETUtility and sqlite3 have been moved from GD to GD_C modules.
  4. In the default.xcconfig file, remove the 3 lines starting with FIPS_PACKAGE, LDPLUSPLUS, and LD.
  5. In the Frameworks, Libraries and Embedded Content list of the project target, add the following items:
    • BlackBerryDynamics.xcframework
    • GSEProvider.xcframework

    Set 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.

    Note that in SDK version 14.0 and earlier, BlackBerry Dynamics apps using BlackBerryDynamics.xcframework linked to a combination of BlackBerryCerticom.xcframework and BlackBerryCerticomSBGSE.xcframework; with SDK version 15.0 and later, BlackBerry Dynamics apps using BlackBerryDynamics.xcframework need to link only to GSEProvider.xcframework.

  6. In the Build Settings of the project target, update Framework Search Paths to include the directory of the BlackBerry framework files.
  7. In the Header Search Paths, include the following entry: <directory_with_framework_files>/BlackBerryDynamics.xcframework/Headers
Configure a new or existing BlackBerry Dynamics app to use the dynamic framework.