Integrating PSPDFKit Using Carthage

ℹ️ Note: PSPDFKit 9 for iOS migrated to XCFrameworks to offer better cross-platform support. Carthage does not yet support XCFrameworks. This may result in errors saying “Incompatible Swift version” when using an Xcode version different from what PSPDFKit was built with. If you see this error, or if you need Mac Catalyst support, use the manual integration.

PSPDFKit is available via Carthage. If you’re new to Carthage, check out the documentation first.


  • Please don’t follow our manual integration guide if you’re using Carthage. Do not use or other scripts, as they are not necessary when using Carthage and will prevent your project from working.
  • Please make sure you have Carthage version >= 0.19 installed. You can check your Carthage version with carthage version.
  • Nightly builds are currently not supported in Carthage.

PSPDFKit is a commercial framework. As such, you get a unique Carthage URL specific to your license or trial. You can find your Carthage URL in our customer portal by choosing the Use Carthage tab when downloading PSPDFKit. If you are currently evaluating PSPDFKit, you first need a trial license, which you can obtain by clicking on the trial button on our website. Follow the instructions in the email to get the URL specific to your trial. To purchase a license, please contact our sales team.

Below you will find more information on what you have to add to your Cartfile (Carthage URLs use the same secret key as CocoaPods).

Use the Version Compatible With:

binary "" ~> 6.4

Using the above Carthage will download a PSPDFKit version compatible with 6.4. Compatibility is determined according to Semantic Versioning. This means that any version greater than or equal to 6.4, but less than 7.0, will be considered compatible with 6.4.

Use a Specific Version:

binary "" == 6.4.0

Using the above Carthage will download PSPDFKit version 6.4.0.

Use the Latest Version:

binary "" >= 6.4

Using the above Carthage will download the latest PSPDFKit version.

Follow the instructions in the Carthage documentation to finish the integration.