How to resolve SDK errors "Cannot Load Bundle" and "Symbol not found"

Both errors Cannot Load Bundle and Symbol Not Found are typically originating from issues with linking frameworks for your iOS project.

Usercentrics mobile SDK consists of two packages: Usercentrics and UsercentricsUI, that may rely on each other depending on functionality and API you use. The packages are distributed using specific naming conventions. Example naming conventions for each linking type can be found below.

When seeing the error Cannot Load Bundle:

Typically, this error occurs when the dynamic versions of the SDK packages have been linked statically, or the other way around - when the static versions of the packages have been linked dynamically. Please check the following:

• Have you included static or dynamic versions of the SDK packages into your project
• If using Cocoapods: ensure the linking in your podfile aligns with your chosen framework files, for example, when working with dynamic frameworks, the podfile needs to be set up dynamically.
• If on Unity: double-check which Unity package has been imported (static / dynamic) and adjust your iOS resolver settings accordingly

When seeing the error Symbol not Found:

This error is usually caused by using a non-Unity version of Usercentrics package in combination with the Unity-specific version of UsercentricsUI package. To resolve this error, review the package naming conventions in the Manual linking section above, and replace packages with the correct ones as needed.