--- title: "Nutrient iOS SDK troubleshooting | Nutrient SDK" canonical_url: "https://www.nutrient.io/guides/ios/troubleshoot/" md_url: "https://www.nutrient.io/guides/ios/troubleshoot.md" last_updated: "2026-05-15T17:18:57.913Z" description: "Solutions for common issues and errors in Nutrient iOS SDK with debugging tips and workarounds." --- # Troubleshooting Troubleshoot common issues you might encounter when setting up Nutrient iOS SDK. ## Getting started - [Signed disk image](https://www.nutrient.io/guides/ios/security/signed-disk-image.md) - [Framework signature validation failed](https://www.nutrient.io/guides/ios/troubleshooting/getting-started/framework-signature-validation-failed.md) - [Add the license key](https://www.nutrient.io/guides/ios/getting-started/adding-the-license-key.md) ## Configuration - [Nutrient doesn’t compile or link](https://www.nutrient.io/guides/ios/configuration-issues/pspdfkit-doesnt-compile-or-link.md) - [Application archival](https://www.nutrient.io/guides/ios/configuration-issues/app-fails-to-archive.md) ## Usage - [Dealing with exceptions](https://www.nutrient.io/guides/ios/usage-issues/dealing-with-exceptions.md) ## Rendering - [Custom fonts](https://www.nutrient.io/guides/ios/features/custom-fonts.md) - [Changing the font size or color of page text](https://www.nutrient.io/guides/ios/customizing-pdf-pages/changing-the-font-size-or-color-of-page-text.md) - [The complexities for rendering PDFs](https://www.nutrient.io/guides/ios/troubleshooting/complexities-of-rendering-pdfs.md) - [A gray/white/black page is rendered](https://www.nutrient.io/guides/ios/rendering-issues/a-graywhiteblack-page-is-rendered.md) - [In Adobe Acrobat, hyperlinks are clickable, but in Nutrient, some or all of them are not marked as touchable](https://www.nutrient.io/guides/ios/rendering-issues/in-adobe-acrobat-hyperlinks-are-clickable-but-in-pspdfkit-some-or-all-of-them-are-not-marked-as-touchable.md) - [Inconsistent fonts](https://www.nutrient.io/guides/ios/rendering-issues/inconsistent-fonts.md) - [Inconsistent labels](https://www.nutrient.io/guides/ios/rendering-issues/inconsistent-labels.md) - [Nutrient doesn’t show the PDF form](https://www.nutrient.io/guides/ios/rendering-issues/pspdfkit-doesnt-show-the-pdf-form.md) ## Performance or file size - [Reducing PDF file size](https://www.nutrient.io/guides/ios/generating-pdfs/reducing-pdf-size.md) - [Slow file saving](https://www.nutrient.io/guides/ios/faq/growing-pdf-file-size.md) ## User interface - [Transparent bar backgrounds](https://www.nutrient.io/guides/ios/troubleshooting/user-interface/transparent-bar-backgrounds.md) - [Handle displaying documents in UISplitViewController](https://www.nutrient.io/guides/ios/troubleshooting/split-view-controller.md) - [Print button is not showing up in the toolbar](https://www.nutrient.io/guides/ios/troubleshooting/print-button-is-not-showing-up-in-the-toolbar.md) ## Errors and warnings - [PSPDFKit.bundle could not be located](https://www.nutrient.io/guides/ios/configuration-issues/pspdfkitbundle-issues.md) - [Error 999](https://www.nutrient.io/guides/ios/pspdfkit-instant/error-999.md) - [PSPDFKit resource issue](https://www.nutrient.io/guides/ios/faq/incorrect-bundle-version.md) - [Error ITMS-90060](https://www.nutrient.io/guides/ios/announcements/version-string-enforcements.md) - [Not trusted](https://www.nutrient.io/guides/ios/signatures/troubleshooting/chain-of-certs-not-valid.md) - [Undefined symbols](https://www.nutrient.io/guides/ios/usage-issues/undefined-symbols-error.md) - [SQLite warnings](https://www.nutrient.io/guides/ios/troubleshooting/sqlite-warnings.md) ## License - [Finding the app bundle ID](https://www.nutrient.io/guides/ios/faq/finding-the-app-bundle-id.md) - [What is a bundle ID?](https://www.nutrient.io/guides/ios/faq/what-is-a-bundle-id.md) - [License troubleshooting](https://www.nutrient.io/guides/ios/troubleshooting/license-troubleshooting.md) - [Getting the currently used version](https://www.nutrient.io/guides/ios/license-issues/getting-the-currently-used-version.md) - [Updates have expired](https://www.nutrient.io/guides/ios/license-issues/updates-have-expired.md) - [Using the license key in other languages](https://www.nutrient.io/guides/ios/license-issues/using-the-license-key-in-other-languages.md) ## Miscellaneous - [Advanced Crash Report Symbolication](https://www.nutrient.io/guides/ios/troubleshooting/advanced-symbolication.md) - [App Store submissions](https://www.nutrient.io/guides/ios/troubleshooting/app-store-submissions.md) - [Bug reporting](https://www.nutrient.io/guides/ios/troubleshooting/bug-reporting.md) - [Removing architectures](https://www.nutrient.io/guides/ios/troubleshooting/removing-architectures.md) --- ## Related pages - [Best practices](/guides/ios/best-practice.md) - [iOS PDF bookmark SDK](/guides/ios/bookmarks.md) - [Mac Catalyst PDF library](/guides/ios/catalyst.md) - [Cordova PDF library](/guides/ios/cordova.md) - [Contributing to Nutrient projects](/guides/ios/miscellaneous/contributing.md) - [Discover innovative PDF SDK demos for multiple platforms](/guides/ios/demo.md) - [Compare documents on iOS](/guides/ios/compare-documents.md) - [Download our iOS library](/guides/ios/downloads.md) - [iOS PDF library](/guides/ios.md) - [visionOS buides: Integrate our PDF library](/guides/ios/intro-visionos.md) - [iOS guides: Integrate our PDF library](/guides/ios/intro.md) - [iPhone PDF library](/guides/ios/iphone.md) - [Ionic PDF library](/guides/ios/ionic.md) - [iPad PDF Library](/guides/ios/ipad.md) - [Knowledge base](/guides/ios/kb.md) - [Swift PDF library](/guides/ios/swift.md) - [Upgrade and migration guides](/guides/ios/upgrade.md) - [visionOS PDF library](/guides/ios/visionos.md) - [Xamarin.iOS PDF library](/guides/ios/xamarin.md) - [Changelog for iOS](/guides/ios/changelog.md)