Documentation Index

Fetch the complete documentation index at: https://usercentrics.document360.io/llms.txt

Use this file to discover all available pages before exploring further.

Supportability & troubleshooting

Prev Next

Supportability

  • The Unity Editor is not supported. To test and debug the CMP,  run the project on a simulator or real device.

  • iOS & Xcode: Cocoapods must be installed for iOS builds to work, check their installation guide. When opening the project built by Unity, you should always select the .xcworkspace file created by Cocoapods.

Troubleshooting on Android

  • When Android is selected as Build Platform, the dependency manager will ask you to download the dependencies that Usercentrics needs. We recommend enabling Android Auto-resolution to handle this. Make sure you have downloaded all Android Build Support Modules including OpenJDK.

  • The Usercentrics SDK needs internet in order to initialize. Make sure you enable a required connection in your Android Player Settings under File - Build Settings - Android (selected) - Player Settings - Other Settings - Internet Access - Required.

  • When using this plugin for the first time, a popup will appear asking if you want to enable "Android Auto-resolution", we highly recommend to enable, since it's natural for some Android libraries have conflicting dependencies. Enabling this "auto-resolution", the plugin will take care of everything for you.
    Auto-resolution popup

  • Dependency conflicts (Duplicate classes) or ExternalDependencyManager fails to resolve dependencies

    If the auto-resolution process fails to resolve any conflicts, modify your project's build configuration for Android. By doing so, you will not depend solely on the ExternalDependencyManager to download all dependencies. Instead, you allow Gradle to handle the resolution of dependencies and any emerging conflicts.

    To do that, follow these steps:

    • Go to File -> Build Settings -> Switch platform to Android

    • Go to Player Settings

    • Scroll to the last section "Publishing Settings"

    • Enable "Custom Main Gradle Template"

    • Enable "Custom Gradle Properties File"

    • Save & close

    • Go to Assets - External Dependency Manager - Android Resolver - Settings

    • Make sure "Patch mainTemplate.gradle" & "Patch gradleTemplate.properties" are both enabled.