License Troubleshooting | iOS

Nutrient iOS SDK is a commercial SDK and requires a license to work. We issue one license per explicit bundle ID. Contact [email protected] if you have any questions related to your license.

Bundle ID mismatch

PSPDFKit licensing issue: Your license has been registered for a different bundle identifier: “com.some.bundle.id” - not “com.actual.bundle.id”. Each Nutrient license is only valid for one explicit bundle ID and one distribution method (Enterprise or public App Store). Please contact sales at [email protected] with your requirements for a new license.

If you see this message, the bundle ID you registered in the Nutrient Portal doesn’t match the bundle ID where Nutrient iOS SDK is used.

To fix this issue, change your app’s bundle ID in Xcode to match the registered bundle ID, or get in touch with our sales team to obtain a new license.

License expired

Nutrient Licensing Issue: Your license is too old for Nutrient for iOS X.X. Please visit our customer portal at https://my.nutrient.io/ to download your new license key. If you’re not able to proceed, contact us at https://www.nutrient.io/support/request/.

This error is displayed if you didn’t renew your license or renewed it but didn’t log in to our Nutrient Portal to get the new license keys. License keys change upon renewing and need to be updated. The existing ones keep working for old versions, but once you upgrade to a newer SDK, you need the new license key.

Missing feature

Terminating app due to uncaught exception ‘NSInternalInconsistencyException’, reason: ‘Your license does not include Document Editing.’

If you see this assertion, it’s because you’re using a component that isn’t included in your license.

Contact sales at [email protected] to add the missing component to your license.

Unexpected demo mode

Read this section if you’re setting a valid license key but seeing an alert about being limited to using Nutrient for 1 hour in demo mode. You’ll see a log message such as:

This version is not for redistribution and is time-limited to 1 hour.

If this is happening, it’s likely you’re accidentally calling APIs from Nutrient before you set your license key. This results in Nutrient using a demo license.

To find where you’re calling APIs from Nutrient, set a breakpoint in the Xcode breakpoint navigator (Command + 8). Use the + button at the bottom to add a symbolic breakpoint for:

Symbol: PSPDFEnsureCoreLicenseIsInitialized
Module: PSPDFKit

This breakpoint will be hit both when the license is set successfully and when something else causes the license to initialize too early. Look at the stack trace when this breakpoint is hit to find where you’re calling APIs from Nutrient.

My license key contains invalid characters that are interpreted as code comments

Example: My license key has some invalid characters (\\) that are interpreted as code comments. I’m storing my license key in an external file, and when I add it, the app crashes at startup due to an invalid license key. Fix: Wrap your license key between single (') or double (") quotation marks like so:

PSPDFKIT_KEY = "PQmgAnmE1GsqwrY8nV2Gaq4g9wcg8XDF3p9ymbsw1npPclRg9Wsd3FQZXF2s4OT9BeiKk6g9sutdcy9032sgf8afm432wkq50SrGfi71CDuJCoVdIbF6Zj+BIYeaz38ghlFfydfMOFlfd4H5t0y"

Removed trial license requirement

We removed the requirement for a trial license key in version 10.4, so you no longer need to one to try our SDK.