Integrating PSPDFKit Using Carthage

ℹ️ Note: Using Carthage may result in errors saying “Incompatible Swift version - framework was built ...” when using a different Xcode version than the version we used to build PSPDFKit. If you see this error, you can work around this harmless warning by using the same version of Xcode we used for the release.

Alternatively, to fix this issue or if you need Mac Catalyst support, you can use Swift Package Manager or manual integration instead.

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

Quick Start

  1. Get Carthage via brew install carthage (this requires Homebrew to be installed).

  2. Create a Cartfile in the same directory where your .xcodeproj or .xcworkspace is.

  3. Add PSPDFKit as a dependency to this Cartfile:

binary ""
  1. Run carthage update.

  2. If successful, a Cartfile.resolved file and a Carthage directory will appear in the same directory as your Xcode project.

  3. Drag the binaries from Carthage/Build/<platform> into your application’s Xcode project.

Depending on how you use Carthage, you might require additional steps, as listed in the Carthage Quick Start guide.


  • Please don’t follow our manual integration guide if you’re using Carthage.

  • Please make sure you have Carthage version >= 0.35.0 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’re 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’ll 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 "" ~> 10.0

Using the above will download a PSPDFKit version compatible with 9.3. Compatibility is determined according to semantic versioning. This means any version greater than or equal to 9.0, but less than 7.0, will be considered compatible with 9.3.

Use a Specific Version:

binary "" == 9.3.1

Using the above will download PSPDFKit version 9.3.1.

Use the Latest Version:

binary ""

Using the above will download the latest PSPDFKit version.

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