• Xamarin.iOS Bindings for PSPDFKit 9.2.0 for iOS
• Xamarin.Mac Bindings for PSPDFKit 4.2.0 for macOS

The PSPDFKit SDK is a framework that allows you to view, annotate, sign, and fill PDF forms on iOS, Android, Windows, macOS, and Web.

PSPDFKit Instant adds real-time collaboration features to seamlessly share, edit, and annotate PDF documents.

• Xamarin.Android Bindings for PSPDFKit for Android: PSPDFKit/Xamarin-Android
• Xamarin Bindings for PSPDFKit for Windows UWP: PSPDFKit/Xamarin-UWP

In order to build this binding project you need:

• Visual Studio for Mac or Windows
• Xamarin.iOS 13.6 +
• Xamarin.Mac 6.6 +

1. Clone this repository to your computer.
2. Open the Xamarin-iOS directory.

1. In order to use this C# binding because Xamarin does not support xcframework yet, you will need to obtain the full PSPDFKit framework files using the COCOAPODS_KEY from your customer portal if you haven't done so already, or request an evaluation version.
2. Replace COCOAPODS_KEY with your key and download the following two zip files.
   • https://customers.pspdfkit.com/cocoapods/COCOAPODS_KEY/pspdfkit/9.2.0.zip
   • https://customers.pspdfkit.com/cocoapods/COCOAPODS_KEY/instant/9.2.0.zip
3. Extract the zip files you downloaded in step 2 and copy the following files into the specified directories:

iOS: From PSPDFKit-for-iOS zip.

• Copy PSPDFKit.framework into PSPDFKit.iOS.Model folder.
• Copy PSPDFKitUI.framework into PSPDFKit.iOS.UI folder. *
• Copy Instant.framework into PSPDFKit.iOS.Instant folder. *

Mac: From PSPDFKit-for-macOS dmg.

• Copy PSPDFKit.framework into PSPDFKit.Mac.Model folder. *

* Items with an asterisk are optional, if you do not provide a framework, by default we won't generate its bindings, but most of the time you will want to provide PSPDFKit.framework and PSPDFKitUI.framework at minimum.

1. Open PSPDFKit.sln located in the root folder.
2. Build the binding projects inside the iOS or Mac solution folders.
3. Get the dlls from the bin folder of each project.
4. Go to Step 4 - Integrating into your ptoject.

We are using Cake as our build system, this allows us to build on both Windows and Mac from a single script.

1. Run ./build.sh (Mac) / .\build.ps1 (Windows) command from the root directory.
2. All the resulting dlls will be inside the root folder.
3. Go to Step 4 - Integrating into your ptoject.

We use the Default build task which builds all binding projects as long as the frameworks are present inside each directory (see Step 2 - Copy required files), if an optional framework is not present this Task will just skip.

In the case you just want the Mac bits to be built you can do ./build.sh --target mac. Here are the most common tasks available in the build script, they are particularly useful when you are integrating this into a CI Server.

To list all available tasks you can do ./build.sh --showdescription.

Add the generated PSPDFKit dlls as a reference to into your own Xamarin project and add the corresponding using statements depending on the dlls referenced into your project.

using PSPDFKit.Model;
using PSPDFKit.UI;
using PSPDFKit.Instant;

Also you do need to set your license key early on in your AppDelegate, before accessing any other PSPDFKit classes.

public override bool FinishedLaunching (UIApplication application, NSDictionary launchOptions)
{
	PSPDFKitGlobal.SetLicenseKey ("YOUR_LICENSE_KEY_GOES_HERE");
	// ...
}

Support for Instant was added with the Xamarin.iOS Bindings for PSPDFKit 7.2.0 for iOS.

With PSPDFKit Instant, it’s easier than ever to add real-time collaboration features to your PSPDFKit-powered app, allowing your users to seamlessly share, edit, and annotate PDF documents across iOS, Android, and web. With just a few lines of code, PSPDFKit Instant gives your users a massive productivity boost.

For more information about Instant, please have a look at our website.

You can find several sample projects in the Examples folder, including a catalog, Xamarin.Forms, and macOS example.

1. Complete Step 2.
2. Open the PSPDFKit.sln solution in Visual Studio.
3. Select the example project and device you want to run it on (alternatively you can also right-click on the project and select "Build Project Name").

This example is included in the PSPDFCatalog example, but you can also find the code here.

The PSPDFKit Instant example shows how easy and efficient Instant works. Just go the Instant demo page and tap on Instant on iOS, this will show a code at step three, which you have to enter in the example on your device. Afterwards you'll be connected to the server and you can start testing!

The PSPDFCatalog project includes various examples for pretty much every use-case and will help you to build your own app with PSPDFKit.

The XFSample.iOS project is an example showcasing how to build an app with PSPDFKit using Xamarin.Forms.

MacPDFViewer is an easy example on how build a PDF viewer on Mac.

Please ensure you signed our CLA so we can accept your contributions.