Mac Catalyst PDF SDK

Above: the MacReader sample app showing the NSToolbar on the macOS window, as well as the UIMenus provided by PTDocumentController.

Apryse’s Mac Catalyst PDF SDK comes with simple-to-use Objective-C and Swift APIs to bring document viewing, creating, searching, annotation, and editing capabilities to native MacOS and iOS apps.

Our goal with Mac Catalyst is for our existing iOS UI to be as close as possible to the native AppKit look and feel -- without sacrificing functionality or the convenience of using a single API for iOS and macOS. We are continuously improving the library, so stay tuned for exciting new features. Please get in touch with us.

Apryse’s fully supported SDK is trusted by thousands of innovative startups, governments, and Fortune 500 businesses (see customers). Apryse technology is built from the ground up and is not dependent on any external third-party open-source software.

Mac Catalyst is an exciting technology from Apple that makes it incredibly easy to build a state-of-the-art Mac app by porting an existing iOS application.

Your Apryse SDK-based Catalyst apps can be released via the Mac App Store or by simply sharing a binary. You can also use Apryse macOS Electron if you need a Mac app that runs on an older macOS release (prior to macOS 10.15 Catalina).

The PTDocumentController shows a PDF viewer and annotator complete with controls such as an annotation toolbar, page layout controls, bookmarks, thumbnail viewer, etc. All of its component pieces are part of the Tools framework, and this class packages them into one easy to use view controller.

The PTDocumentController in our Catalyst SDK also provides a ready-made NSToolbar which provides convenient access to many of the built-in controls described above. The toolbar is available as a property on the document view controller: documentController.macToolbar.

The Apryse SDK can easily be integrated into your Catalyst apps. XCFrameworks for both the PDFNet framework and Tools UI framework are included in the Apryse SDK for iOS. The SDK can be integrated by CocoaPods, Swift Package Manager, or by manually integrating the XCFrameworks into your Xcode project. Please see the Getting Started guide for more information.

To show a PTDocumentController, override the viewDidAppear() method in your UIViewController class and then open the documentController using:

1//Import the PDFNet and Tools libraries
2#import <PDFNet/PDFNet.h>
3#import <Tools/Tools.h>
4
5- (void)viewDidAppear:(BOOL)animated {
6    // Create a PTDocumentController
7    PTDocumentController *documentController = [[PTDocumentController alloc] init];
8    // Conform to the `PTDocumentControllerDelegate` protocol
9    documentController.delegate = self;
10    // The PTDocumentController must be in a navigation controller before a document can be opened
11    UINavigationController *navigationController = [[UINavigationController alloc] initWithRootViewController:documentController];
12    // Open a file from URL.
13    NSURL *fileURL = [[NSURL alloc] initWithString:@"https://pdftron.s3.amazonaws.com/downloads/pl/sample.pdf"];
14    [documentController openDocumentWithURL:fileURL];
15    // Show navigation (and document) controller.
16    [self presentViewController:navigationController animated:YES completion:nil];
17}

To show the PTDocumentController's NSToolbar, make the view controller conform to the PTDocumentControllerDelegate protocol and implement the delegate method, documentControllerDidOpenDocument:documentController.

1// Set the toolbar in the `documentControllerDidOpenDocument:documentController` delegate method
2- (void)documentControllerDidOpenDocument:(PTDocumentController *)documentController
3{
4    #if TARGET_OS_MACCATALYST
5    UIWindowScene *windowScene = [UIApplication sharedApplication].windows.firstObject.windowScene;
6    windowScene.titlebar.titleVisibility = UITitlebarTitleVisibilityHidden;
7    windowScene.titlebar.toolbar = documentController.macToolbar;
8    #endif
9}

In addition, the view controller also provides a set of UIMenus which you can use to provide quick access to certain actions and view modes in the menu bar of your Catalyst app. To use these menus in your app you can use these menus in the buildMenuWithBuilder: method in your AppDelegate. See this guide from Apple for more information about the UIMenuSystem.

1-(void)buildMenuWithBuilder:(id<UIMenuBuilder>)builder
2{
3    [super buildMenuWithBuilder:builder];
4
5    // Make sure the App Delegate has a valid reference to a `PTDocumentController` object
6    if (self.documentController == nil) {
7        return;
8    }
9    /** The View Modes menu contains actions for setting the view mode on the document
10     *  e.g. Continuous scroll, single page mode, facing page mode.
11     */
12    UIMenu *viewModesMenu = self.documentController.viewModesMenu;
13
14    // The Additional View menu contains actions for toggling reader mode or displaying the annotation toolbar
15    UIMenu *additionalViewMenu = self.documentController.additionalViewMenu;
16
17    /** The Navigation Lists menu contains actions for displaying navigation lists in the side panel:
18     *  Table of Contents (document outline), Annotations list, User Bookmarks list, or the thumbnails browser.
19     */
20    UIMenu *navigationListsMenu = self.documentController.navigationListsMenu;
21     
22    // The Navigate Doc menu contains actions for navigating the document
23    UIMenu *navigateDocMenu = self.documentController.navigateDocMenu;
24
25    // The Annotate menu contains actions for adding annotations to the document
26    UIMenu *annotateMenu = self.documentController.annotateMenu;
27
28    [builder insertChildMenu:viewModesMenu atStartOfMenuForIdentifier:UIMenuView];
29    [builder insertChildMenu:navigationListsMenu atStartOfMenuForIdentifier:UIMenuView];
30    [builder insertChildMenu:additionalViewMenu atStartOfMenuForIdentifier:UIMenuView];
31    [builder insertSiblingMenu:annotateMenu afterMenuForIdentifier:UIMenuView];
32    [builder insertSiblingMenu:navigateDocMenu afterMenuForIdentifier:UIMenuView];
33}

The MacReader sample app included in the download package demonstrates how to integrate the Apryse SDK into your app. The sample can be found in the Samples directory in the SDK download.

Above: the MacReader sample app showing the annotation context menu which is activated by right-clicking (control-clicking) or performing a two-finger tap gesture on the document.

macOS dark mode is also supported:

Light Mode	Dark Mode

• Direct MS Office document viewing and conversion
• Fully customizable open source UI to improve app engagement
• Document reflow to increase readability and accessibility on mobile
• File streaming to view remote and complex documents faster
• Night mode to improve viewing in low-light environments
• And much more...

• PDF, PDF/A
• DOC, DOCX, XLSX, XLS, PPTX, PPT (no MS Office licenses or software is required)
• JPG, HEIF, BMP, TIF, PNG, SVG, EMF, GIF
• PAGES, KEYNOTE, NUMBERS
• RTF, TXT
• HTML
• XPS

• macOS Catalina (10.15+)