Changelog

Follow us on Twitter for updates. Our blog highlights the best new features and changes.

Newest Release

9.2.0 - 21 Jan 2020

See the announcement post and migration guide for this release.

PSPDFKitUI

• API
  The color property of PSPDFColorButton is now correctly marked as optional/nullable. (#22695)
• API
  Removes support for 3rd-party styluses. (#22628)
• Removed
  Deprecates PSPDFImageQualityHigh, replacing it with PSPDFImageQualityBest. (#22763)
• Added
  Adds Dark Mode support to the notes and comments screen (PSPDFNoteAnnotationViewController). (#21333)
• Added
  Adds a high quality option to the image picker (PSPDFImageQualityHigher). (#22763)
• Added
  Adds support for Page Up / Page Down keys to go to the previous/next page. (#22415)
• Added
  Adds support for the Select All menu command on Mac Catalyst. (#22685)
• Changed
  Improves PSPDFAnnotationGridViewController so it shows more annotations when the view is larger (wider than 700 points). (#21423)
• Changed
  Improves logic around the image picker to no longer require the NSPhotoLibraryUsageDescription permission in your app’s Info.plist. (#21778)
• Changed
  Improves performance and smoothness of animations in PSPDFAnnotationTableViewController when annotation updates occur. (#22831)
• Changed
  Improves some error alert titles. (#22757)
• Changed
  Improves the ordering of the key commands exposed by PSPDFNavigationController so their order in the discoverability overlay matches the reading order of the bar buttons on screen. (#22635)
• Changed
  Improves the page selection logic to pick the most recently interacted page when switching from landscape to portrait in page curl mode. (#20452)
• Changed
  Improves the stamp annotation creation process by reducing the copying of annotations when creating them via the saved annotations picker or the stamps picker user interface. (#22666)
• Changed
  Improves the styling of the accessory view used in the PSPDFChoiceFormEditorViewController. (#19936)
• Changed
  Changes the approximate image size for PSPDFImageQualityMedium from 1024 × 768 to 1600 × 1200 because the previous size was very close to PSPDFImageQualityLow. (#22763)
• Changed
  Changes the behavior of the popover presenting PSPDFChoiceFormEditorViewController to allow dismissing the controller on tapping outside of it. (#22852)
• Changed
  Changes the hardware keyboard command to select the top/bottom item in a list from command up/down arrow to option up/down arrow in order to match standard Mac behavior. (#22683)
• Changed
  Floating keyboards now no longer trigger keyboard avoidance actions on PSPDFAvoidingScrollView subclasses apart from free-text annotation avoidance. (#22436)
• Changed
  Improve contrast, especially in Dark Mode, of some tinted UI elements such as text in the outline and icons in the annotation list. (#22197)
• Changed
  Makes the background in the image editor use a translucent color, to see the cut off part of the image. (#22914)
• Changed
  Synchronizes the default borderEffectIntensity for cloudy borders with other PSPDFKit platforms. The default intensity when switching to cloudy borders via the PSPDFKit UI is now 2 instead of 3. (#22611)
• Changed
  The image quality picker of PSPDFImagePickerController is now enabled by default. Set its allowedImageQualities to PSPDFImageQualityBest to disable this. (#22763)
• Changed
  The thumbnail grid now reloads in a more efficient way when bookmarks are changed while it is displayed. (#22687)
• Changed
  Using the keyboard shortcut to select all text or annotations on Mac Catalyst no longer shows the selection menu automatically. (#22651)
• Changed
  PSPDFBrightnessManager has a new mode to disable the idle timer completely. (#22802)
• Fixed
  Fixes an issue where -[PSPDFPageView annotationViewForAnnotation:] might have returned the wrong value, and improves the documentation of this method. (#22578)
• Fixed
  Fixes an issue where PSPDFNavigationController would pass the wrong item in the delegate callback navigationBar:shouldPopItem: when going back using a hardware keyboard. (#22635)
• Fixed
  Fixes an issue where changing pages would not work on the first and last pages on documents with a right page binding in the curl transition. (#22668)
• Fixed
  Fixes an issue where ink annotations drawn using Apple Pencil would create a temporary copy when moved while still in edit mode. (#21833)
• Fixed
  Fixes an issue where ink annotations with customized blend mode would flicker when drawing, erasing or zooming. (#21187, Z#16604)
• Fixed
  Fixes an issue where the PSPDFTabbedBar’s add document and overview buttons could have clear backgrounds. (#21725)
• Fixed
  Fixes an issue where the image in the image editor might be shown partially behind the navigation bar. It is now centered inside the safe area without being occluded. (#22914)
• Fixed
  Fixes an issue where the popover presented in the PSPDFTabbedViewController with list of open documents was not dismissed when the button presenting it was hidden. (#22799)
• Fixed
  Fixes an issue where the scrubber bar would have the wrong page marker set when reacting to a new document being set on the PSPDFViewController. (#22739)
• Fixed
  Fixes the annotation list not updating when annotations change while the list is visible. (#22789)

PSPDFKit

• API
  Changes the localized string key Redact to be for the redaction annotation type instead of the word “Redact”, which is no longer translated by PSPDFKit. In other words, the key Redact was removed and then the key Redaction was changed to Redact to match the PDF specification. The best way to get this localized string key is to use the constant PSPDFAnnotationStringRedaction. (#21243)
• API
  Changes the localized string key for the file annotation type from File to FileAttachment to match the PDF specification. The best way to get this localized string key is to use the constant PSPDFAnnotationStringFile. (#21243)
• API
  Changes the localized string key for the free text annotation type to only FreeText. The duplicate entry with the key Text is now used for note annotations to match the PDF specification. The best way to get this localized string key is to use the constant PSPDFAnnotationStringFreeText. (#21243)
• API
  Changes the localized string key for the note annotation type from Note to Text to match the PDF specification. The best way to get this localized string key is to use the constant PSPDFAnnotationStringNote. (#21243)
• API
  Changes the parameter type of the PSPDFDefaultAnnotationStyleManager methods defaultColorPresetsForKey: and defaultBorderPresetsForKey: from String/NSString to AnnotationStateVariantID/PSPDFAnnotationStateVariantID. (#22769)
• Added
  Adds support for incrementally saving encrypted documents. (#22722)
• Added
  Adds support for the JavaScript function ‘doc.gotoNamedDest’. (#18957)
• Changed
  Improves complex script text rendering. (#22573)
• Changed
  Improves error handling for -[PSPDFFileAnnotationProvider saveAnnotationsWithOptions:error:]. (#14335)
• Changed
  Improves image stamp quality and reduces PDF size growth by avoiding unnecessary image re-encoding. (#22828, #20325)
• Changed
  Improves license check error message to be more user friendly. (#12904)
• Changed
  Improves user-facing descriptions of the types of annotations by considering variants. (#21243)
• Changed
  Improve compatibility with macOS 10.15 Preview for annotation notes in the sidebar. (#22791)
• Removed
  Removes the localized strings entry with the key Squiggle, which was not used. The localized text for the squiggly annotation type has changed to ‘Squiggle’ using the key Squiggly as before. The best way to get this localized string key is to use the constant PSPDFAnnotationStringSquiggly. (#22861)
• Changed
  Uses modern NSFontDescriptor enums on macOS for better Swift bindings. (#22678)
• Fixed
  Fixes a problem where encrypted documents could not be digitally signed correctly. (#22722)
• Fixed
  Fixes a problem where some PDF pages may not be rendered correctly. (#22767)
• Fixed
  Fixes an issue that caused a blank page after flattening annotations on a certain document. (#22279)
• Fixed
  Fixes an issue where characters weren’t escaped correctly when exporting XFDF. (#22844)
• Fixed
  Fixes an issue where free-text annotations were not rendered properly on selection when rendered with filter render options. (#20512)
• Fixed
  Fixes an issue where multiple form elements that are related to the same form field could not be targeted as a group in JavaScript actions, as described by the PDF Reference. The form elements can still be addressed individually by appending .x to the (fully qualified) name of the form field, where x is the index of the form element in the annotations property of the PSPDFFormField. (#22755)
• Fixed
  Fixes an issue where popup annotations were positioned incorrectly. (#22730)
• Fixed
  Fixes an issue where text is not displayed in small free-text annotations. (#22514)
• Fixed
  Fixes an issue where the file size optimization algorithm didn’t run. (#22809)
• Fixed
  Fixes an issue where the outline was overridden if set, before property was accessed. (#22678)
• Fixed
  Fixes an issue where toggling eraser on a page with temporary rotation rendered ink annotations in a regressed state. (#22434)
• Fixed
  Fixes an issue which led to bookmarks not getting updated when importing InstantJSON. (#22198)
• Fixed
  Fixes an issue with creating a Submit Form action from JSON without action flags. (#22784)
• Fixed
  Fixes an issue with form calculations if one of the form fields contained multiple form elements. (#22675)

Instant

• Changed
  Improves the responsiveness of moving and scaling image annotations by avoiding unnecessary work. (#22578)
• Fixed
  Fixes a deadlock that could occur when changes were accumulated while a sync was already in progress. (#22703)
• Fixed
  Fixes an issue where stamps created on the iOS device would immediately vanish when deselected, and never synced. (#19742)
• Fixed
  Fixes an issue where shape annotations would grow temporarily when another shape annotation was drawn immediately afterwards. (#20236)

Examples

• Changed
  Renamed PSCAddingButtonExample.m to PSCAddingCustomViewsExample.m and improved the example which now demonstrates how to add overlay views that stay aligned with PDF content. (#21704)
• Fixed
  Fixes the close button in the document view not always working in the Split View Controller Sidebar example. (#21278)

Previous Releases

9.1.1 - 12 Dec 2019

PSPDFKit now requires and is built with Xcode 11.3 (11C29).

PSPDFKitUI

• Changed
  Right clicking on Mac Catalyst now selects text or images automatically. (#22626)
• Changed
  The image selection context menu now offers a Save option for Mac Catalyst. (#22626)
• Fixed
  Fixes a crash that would occur on some iPad devices when the app was backgrounded while the annotation tool inspector popover was visible. (#22472)
• Fixed
  Fixes an issue where the image selection was not always visible. (#22626)
• Fixed
  Fixes an issue where the keyboard shortcut items for free text annotations were not correctly updated when toggling the accessory view. (#22512)

PSPDFKit

• Changed
  Improves font selection and prefers fonts already in the document in more cases. (#22530)
• Fixed
  Fixes a race condition in PSPDFAESCryptoDataProvider that could result in app termination when Multithreaded Rendering was enabled. (#20011)
• Fixed
  Fixes an issue where a form field element appearance stream was regenerated accidentally. (#21618)
• Fixed
  Fixes an issue where flattened note annotations at the borders of pages would not be rendered correctly. (#22353)
• Fixed
  Fixes an issue where symlinks where not properly resolved for the documentsDirectoryURL in -[PSPDFLibraryFileSystemDataSource -initWithLibrary:documentsDirectoryURL:documentHandler:]. (#22518)

Examples

• Added
  Adds a Catalog example that shows how to customize the buttons that appear on the free text accessory view. (#22506)
• Added
  Adds the ability to load Instant documents from servers protected with HTTP Basic Authentication. (#18960)
• Changed
  Improves the list of examples in the Catalog app by making titles and descriptions multi-line. (#22621)

9.1.0 - 3 Dec 2019

See the announcement post.

PSPDFKitUI

• API
  Adds -[PSPDFConfiguration allowWindowTitleChange] to control window title changes in Mac Catalyst. (#22167)
• API
  -[PSPDFPageView showMenuForAnnotations:targetRect:allowPopovers:animated:] has been deprecated in favor of showMenuForAnnotations:targetRect:contextMenuOption:animated:. (#22303)
• API
  -[PSPDFPageView showMenuIfSelectedAnimated:allowPopovers:] has been deprecated in favor of showMenuWithOption:animated:. (#22303)
• API
  Changes the type of the standardAppearance and compactAppearance properties on PSPDFScrubberBar from UIBarAppearance to UIToolbarAppearance to be more consistent and specific. (#22479)
• Added
  Adds support for selecting ranges of pages in the Document Editor UI by dragging with two fingers. This can be disabled by subclassing PSPDFDocumentEditorViewController and overriding collectionView:shouldBeginMultipleSelectionInteractionAtIndexPath: to return false. (#22536)
• Added
  Adds a new keyboard shortcut (Command + option + G) to jump to a page. (#22291)
• Added
  Adds a subclassing hook to customize document saving when the app is saved for the various autosave reason (backgrounding, terminating, …). (#22077)
• Changed
  Improves conflict resolution handling after file deletion by automatically removing deleted documents from built-in view controllers when the documents don’t have any unsaved changes and are not currently being displayed. (#22025)
• Changed
  Improves page rendering when a zoomed window is resized. (#21836)
• Changed
  Improves smart thumbnail size calculation to show more thumbnails on larger screens. This is especially beneficial with Mac Catalyst. (#21424)
• Changed
  Improves the layout of the color presets in the annotation inspector on larger devices. (#21777)
• Changed
  Note annotations can now be moved faster on iPad and Mac Catalyst. The detail view animation is now instant. (#22303)
• Changed
  The delegate methods on PSPDFSpeechController are now always called on the main thread. (#22301)
• Changed
  The security part of the document info view is now shown as a separate item in the segmented control. See PSPDFDocumentInfoOptionSecurity to add or remove this new item. (#21462)
• Changed
  When context menus are enabled, selecting a note annotation will now present the PSPDFNoteAnnotationViewController. (#22303)
• Fixed
  Fixes an issue that could prevent the annotation list to be dismissed while searching. (#21895)
• Fixed
  Fixes an issue where -[PSPDFResizableView outerKnobOfType:] would return nil for the last knob type. (#22302)
• Fixed
  Fixes an issue where deleting selected annotations with the delete key didn’t work. (#22099)
• Fixed
  Fixes an issue where the keyboard shortcut items for free text annotations were not correctly updated when toggling the accessory view. (#22512)

PSPDFKit

• API
  Changed PSPDFFreeTextAnnotationView textViewForEditing from a property to a method, which changes Swift usage. (#21989)
• API
  Deprecates -attachBinaryInstantJSONAttachmentFromDataProvider:mimeType:error: and replaces it with -attachBinaryInstantJSONAttachmentFromDataProvider:error:, omitting the mimeType. (#17813)
• API
  -[PSPDFCache imageForRequest:imageSizeMatching:] now has an error parameter. (#21836)
• API
  -[PSPDFCacheInfo cacheInfoForRequest:] now has an error parameter. (#21836)
• API
  -[PSPDFRenderTask initWithRequest:] now has an error parameter. (#21836)
• API
  Deprecates the PSPDFAnnotationProviderRefreshing protocol. PSPDFContainerAnnotationProvider now conforms to this protocol, which means that PSPDFKit handles refreshing internally. If you are implementing the refreshing protocol, please contact us to discuss your requirements. (#21885)
• Added
  Adds support for Image Documents with transparency. (#18907)
• Added
  Adds support for copying ink signatures to the clipboard. (#21608)
• Added
  Adds support for input file lists (.xcfilelist) to strip-framework.sh to simplify adding the dSYMs. (#22151)
• Added
  Adds support for redaction annotations to Instant JSON. (#21389)
• Added
  Adds support for setting temporary rotations using setRotationOffset when using custom annotation providers that are subclasses of PSPDFContainerAnnotationProvider. (#21885)
• Added
  Adds the ability to initialize PSPDFImageDocument with any data provider. (#21140)
• Changed
  Improves NSSecureCoding support for various classes. (#20696)
• Changed
  Improves handling when other apps installed on the system declare new types (UTIs) for standard filename extensions like .pdf and .jpg. (#22418)
• Changed
  Improves memory usage while searching document with a lot of annotations. (#22367)
• Changed
  Improves the performance of the redaction component so that big documents are redacted quicker. (#22102)
• Changed
  Improves the rendering of annotations with dashed borders. (#10216)
• Changed
  PSPDFKit for Mac Catalyst no longer uses a separate AppKit bundle, fixing issues with App Store Connect. (#21606)
• Changed
  Rendering complex annotation appearance streams no longer blocks accessing the annotation object on a different thread. (#21836)
• Changed
  State restoration for PSPDFViewController and related classes now support secure coding. (#22125)
• Changed
  Updates HarfBuzz to version 2.6.2. (#21686)
• Fixed
  Fixes ISO8601 timezone support in Instant JSON. (#21148)
• Fixed
  Fixes a crash related to multi-threading and font loading. (#22387)
• Fixed
  Fixes a rare situation where setting form field flags may cause a deadlock. (#19942)
• Fixed
  Fixes a regression that caused certain link annotations to not work. (#21709)
• Fixed
  Fixes an issue where a deadlock could occur after executing a PDF action or JavaScript. (#22201)
• Fixed
  Fixes an issue where annotation additional actions may not be deserialized correctly. (#21983)
• Fixed
  Fixes an issue where annotations were updated too often after executing a PDF action or JavaScript. (#22201)
• Fixed
  Fixes an issue where deleting or moving pages from a PDF did not update the outline. (#21620, #22048)
• Fixed
  Fixes an issue where some filled form fields may not show their content correctly. (#22100)
• Fixed
  Fixes an issue where symlinks where not properly resolved for the documentsDirectoryURL in -[PSPDFLibraryFileSystemDataSource -initWithLibrary:documentsDirectoryURL:documentHandler:]. (#22518)
• Fixed
  Fixes an issue where text after signing had incorrect characters after looking at it in another viewer. (#20930)
• Fixed
  Fixes an issue where text entered in certain form fields was rendered garbled. (#21700)
• Fixed
  Fixes an issue where the redaction tool may not work correctly in some cases when selecting text. (#22486)
• Fixed
  Fixes widget annotation rotation property persistence when coming from Instant JSON. (#21552, #21621)

Instant

• Changed
  Reduces network traffic when loading additional layers of the same document. (#21787)
• Fixed
  Fixes an issue where purging the local storage of a PSPDFInstantClient instance would have it hang on to its existing document descriptors in an unusable state. (#21935)

Examples

• Added
  Adds Catalog example that shows how to add copyright notices to documents when sharing. (#21693)
• Added
  Adds a PSPDFCatalog example that combines a custom annotation provider with setting temporary page rotations. (#21885)
• Added
  Adds a PSPDFCatalog example that shows how to customize the buttons that appear on the free text accessory view. (#22506)
• Changed
  Improves structure of the Catalog project by grouping examples by category and sorting them alphabetically. (#22392)
• Fixed
  Fixes the document not being presented automatically after scanning a QR code in the PSPDFKit Instant example in PSPDFCatalog. (#21979)

9.0.3 - 14 Nov 2019

PSPDFKit now requires and is built with Xcode 11.2.1 (11B500).

PSPDFKitUI

• API
  The scrubber bar now uses gestures for tap detection to block system gestures such as dismissing a modal presentation with a swipe. This lead to the removal of the -[PSPDFScrubberBar processTouch:] subclassing hook, which was not being called even before this change. (#22336)
• Added
  Adds new API to PSPDFProgressLabelView to customize the colors of the text and progress indicator. (#21717)
• Added
  Adds support for system highlight colors for text selection on Mac Catalyst. (#21994)
• Changed
  Improves error handling when a document is selected in the redaction view controller. (#22169)
• Changed
  Changes the color of the placeholder text and progress view in PSPDFThumbnailViewController to use a secondaryLabelColor on iOS 13 and grayColor for older versions. (#21717)
• Changed
  Scrolling via Space/Shift-Space keyboard now correctly scrolls the active viewport on continuous scrolling, and advances pages for per-page scrolling or page curl transition. (#22118)
• Changed
  The inspector is now enabled when multiple annotations of the same type are selected. (#22195)
• Fixed
  Fixes an issue where VoiceOver would still read out the search progression PSPDFSearchViewController even after searching the document did complete. (Z#15979)
• Fixed
  Fixes an issue where PSPDFNoteAnnotationViewController didn’t correctly set the appearance of its navigation bar and toolbar. (#22000)
• Fixed
  Fixes an issue where annotation toolbar and inspector didn’t support certain appearance customizations. (#22113)
• Fixed
  Fixes an issue where documents wouldn’t be shared correctly on Mac Catalyst. (#21821)
• Fixed
  Fixes an issue where note annotations could not be deleted on Mac Catalyst. (#22083)
• Fixed
  Fixes an issue where rotating the device in page curl mode could lead to an assertion failure. (Z#16000)
• Fixed
  Fixes an issue where tapping on a search result would not necessarily scroll the search result on screen in continuous scrolling mode. (#22011)
• Fixed
  Fixes an issue where not all available options on a given PSPDFChoiceFormEditorViewController would be selectable when being presented as a popover on iOS 13. (#22247)

PSPDFKit

• Changed
  Increases image size limits. (#22029)
• Fixed
  Fixes an issue if a TrueType font collection has more than 32 fonts. (#22148)
• Fixed
  Fixes an issue where an annotation copied from another document was rendered blurry. (#20070)
• Fixed
  Fixes an issue where certain high resolution images weren’t rendered. (#22322)
• Fixed
  Fixes an issue where creating an annotation using +[PSPDFAnnotation annotationFromInstantJSON:documentProvider:error:] would lead to a crash if the destination document had multiple document providers. (#22207)
• Fixed
  Fixes an issue where form repairs were done too eagerly. (#20786)
• Fixed
  Fixes an issue where pages would be rendered with incorrect background colors when setting PSPDFRenderOptions.backgroundFill for any render type. (#21800)
• Fixed
  Fixes an issue where selecting the Open In option when sharing pages out of a document would not work. (#22209)
• Fixed
  Fixes an issue where temporarily rotated annotations were saved incorrectly in PSPDFAnnotationSaveModeEmbeddedWithExternalFileAsFallback mode. (#22188)
• Fixed
  Fixes an issue where using a big size for the digital signature container may abort the digital signing process. (#22130)
• Fixed
  Fixes a crash that would occur while rendering a thumbnail for a page which does not have a valid size. (#22365)
• Fixed
  Fixes an issue where certificates with multi-value RDNs may not be parsed correctly. (#22221)

Examples

• Changed
  Updates CustomImagePickerControllerExample.swift illustrating how to customize the PSPDFImagePickerController’s allowedImageQualities. (#22002)

9.0.2 - 21 Oct 2019

PSPDFKitUI

• Changed
  Improves the annotation popover placement algorithm. (#21851)
• Changed
  Sets the highlight text color of the labels in the search result cell to white to improve legibility. (#21964)
• Fixed
  Fixes an issue where changing the compactAppearance property of PSPDFScrubberBar had no effect. (#21927)
• Fixed
  Fixes an issue where customizing UINavigationBar via UIAppearance API had no effect in iOS 13. (#21837)
• Fixed
  Fixes an issue where saved annotations wouldn’t be displayed on PSPDFSavedAnnotationsViewController. (#21761)

PSPDFKit

• Added
  Adds support for printing array structures from JavaScript code inside a PDF. (#19063)
• Fixed
  Fixes a rare deadlock when rendering certain documents. (#21856)
• Fixed
  Fixes a rendering error where the font ArialMT wasn’t selected correctly. (#21744)
• Fixed
  Fixes an issue where PSPDFKit.bundle’s version number was incorrect on Mac Catalyst. (#21737)
• Fixed
  Fixes an issue where multiple simultaneous conflict resolution prompts could potentially trigger an internal assertion. (#21694)
• Fixed
  Fixes an issue where some Swift API, like PSPDFKitGlobal.setLogHandler(), were not accessible when using the CocoaPods integration. (#21846)
• Fixed
  Fixes a performance regression when rendering with an ICC based color space. (#21776)
• Fixed
  Fixes an issue where some properties of a widget annotation were not persisted when the document was saved. (#21546)

Instant

• Fixed
  Fixes a regression that would lead to excessive sync activity. (#21847)
• Fixed
  Fixes an issue where deleting the local storage for a layer could result in an assertion failure. The situation now fails gracefully. (#21880)
• Fixed
  Fixes an issue with the image cache where two layers of the same document would be displayed such that they appear to have identical annotations until after the first annotation update. (#21666)

Examples

• Added
  Adds a Catalog example illustrating how to customize the appearance of the navigation bar and annotation toolbar. (#21961)
• Added
  Adds a PSPDFCatalog example illustrating how to restore a document to its previously opened reading position. (#21904)
• Added
  Adds required entitlements to the Catalog example when running on macOS. (#21999)
• Fixed
  Fixes a crash that would occur when opening PSPDFCatalog on macOS. (#21738)

9.0.1 - 10 Oct 2019

PSPDFKit now requires and is built with Xcode 11.1 (11A1027).

PSPDFKitUI

• Added
  Adds new API standardAppearance and compactAppearance to style the PSPDFToolbar on iOS 13. (#21665)
• Added
  Adds allowReorderingDocuments on PSPDFTabbedViewController to support disabling reordering documents in the tabbed bar. (Z#15717)
• Fixed
  Fixes an issue on iOS 13 where menus would flicker and disappear if they were nested one level deep. This happened for changing properties of text markup annotations. (#21735)
• Fixed
  Fixes a crash when using the tab key on a hardware keyboard to navigate form fields on iOS 13. (#21613)
• Fixed
  Fixes an issue where sharing a document multiple times with custom page ranges would produce invalid documents. (#21080)
• Fixed
  Fixes an issue where the PSPDFFlexibleToolbar did not match the appearance of the given navigation bar or a toolbar on iOS 13. (#21665)
• Fixed
  Fixes an issue where the status HUD was not positioned correctly when a keyboard was visible. (#21636)
• Fixed
  Fixes an issue where the thumbnails border color was incorrect in Dark Mode in scrollable thumbnail mode. (#21642)
• Fixed
  Fixes a possible crash that would occur when exporting documents as images with flattened annotations. (#21739)
• Fixed
  Fixes an issue with certain configurations where documents may initially appear zoomed in. (#21625)

PSPDFKit

• Fixed
  Fixes an issue where documents using certain kind fonts (especially Chinese, Japanese, and Korean) would cause the app to crash. (#21626)
• Fixed
  Fixes secure coding of PSPDFRenderOptions. Before all properties would be encoded as nil or zero, which could lead to rendering pages with black backgrounds. (#21708)
• Fixed
  Fixes an issue where the z-index wasn’t preserved when flattening annotations. (#21385)
• Fixed
  Fixes an issue where a digital signature applied to a certain kind of document may not show correctly in third party PDF readers. (#18943)
• Fixed
  Fixes an issue when using multi-threaded rendering. (#18582)
• Fixed
  Fixes a crash when using the processor on certain documents with very deep object hierarchies. (#21674)

Instant

• Fixed
  Fixes a possible crash when loading annotations failed in certain Instant documents. (#21617, Z#15606)
• Fixed
  Fixes an issue where removing the local storage for a document descriptor briefly after loading it could lead to a deadlock. (#21766)

9.0.0 - 19 Sep 2019

See the announcement post.

PSPDFKit now requires and is built with Xcode 11.0.

This release features support for a new platform - Mac Catalyst. Be sure to check out our Introducing PSPDFKit for Mac Catalyst blog post for more information.

Below is a summary of the API changes in this release. For a full list, with our suggested migration strategy for each API that has been changed or removed, please see the migration guide. The guide also provides migration steps for xcframework integration and the removal of PSPDFKitSwift.

• Removed
  Removes all previously deprecated API. Please see our PSPDFKit 9 for iOS migration guide to learn about the appropriate migration strategy. (#20904)

PSPDFKitUI

• API
  Changes PSPDFStatusHUD class methods and PSPDFStatusHUDItem push methods to take a window as parameter, as there now might be multiple status HUDs due to multi-window support on iOS 13. (#21429)
• API
  PSPDFFlexibleToolbarController methods for showing/hiding toolbar now include an optional completion block. (#19807)
• API
  Renames the PSPDFConfiguration properties scrollOnTapPageEndEnabled, scrollOnTapPageEndAnimationEnabled, and scrollOnTapPageEndMargin to scrollOnEdgeTapEnabled, animateScrollOnEdgeTaps, and scrollOnEdgeTapMargin. (#20923)
• API
  The designated initializer for PSPDFViewState has been replaced in favor of -[PSPDFViewState initWithPageIndex:viewPort:selectionState:selectedAnnotationNames:]. (#20655)
• API
  PSPDFUsernameHelperWillDismissAlertNotification has been replaced with PSPDFUsernameHelperDidDismissViewNotification. This is posted after the dismissal ends rather than before to work better with sheets on iOS 13 that can be dismissed by swiping down. (#20978)
• Removed
  Removes PSPDFPresentationShouldPopoverDismissBlockKey because API provided by UIKit should be sufficient. (#20978)
• Removed
  Removes brightnessManager property from PSPDFBrightnessViewController since brightness is now directly handled on the UIScreen instance. (#21495)
• Removed
  Removes brightness related properties from PSPDFBrightnessManager. (#21495)
• Removed
  Removes interactiveReorderingGestureRecognizer from PSPDFTabbedBar since the tabbed bar uses drag and drop for reordering now. (#20431)
• Removed
  Removes support for using UIWebView in PSPDFWebViewController. (#19807)
• Added
  Adds PSPDFDocumentInfoCoordinator.documentInfoViewController to enable showing the document info UI in custom ways. (#19807)
• Added
  Adds PSPDFPageView methods for showing contextual menus: showMenuForPoint:animated: and showAnnotationMenuAtPoint:animated:. (#19807)
• Added
  Adds precise immediate text selection handling on Mac Catalyst. (#21012)
• Added
  Adds support for attaching a user activity to a tab dragged from the tabbed bar, to allow the system opening a new window scene on iOS 13. (#20431)
• Added
  Adds support for context menus to the annotation toolbar on iOS 13. (#21205)
• Added
  Adds support for dragging and dropping tabs across different PSPDFTabbedViewController instances. This can be enabled via allowDraggingTabsToExternalTabbedBar and allowDroppingTabsFromExternalTabbedBar. (#20431)
• Added
  Adds support for iOS 13 Dark Mode. (#20403)
• Added
  Adds support for the new Cut/Copy/Paste gestures from iOS 13. (#21293)
• Added
  Adds an option for rounded corners to the flexible toolbar and refines the default toolbar design. (#21206)
• Changed
  Improves compatibility with iOS 13 sheet presentations, which can be dismissed by swiping downwards. (#20978)
• Changed
  Improves logic to place the share activity view controller on the page when sharing an image. (#19807)
• Changed
  Improves the annotation line-end selection UI in the annotation style controller. (#21535, #21542)
• Changed
  Improves the annotation toolbar and document editor icon designs, so it’s easier to distinguish them. (#21078)
• Changed
  Improves toolbar selection and orientation transition animations. (#21206)
• Changed
  Changes PSPDFSignatureViewController to always use a consistent aspect ratio for the signing area. Previously this was only the case on iPad. (#20978)
• Changed
  Changes moving tabs in the tabbed bar to use drag and drop instead of interactive reordering. (#20431)
• Changed
  Changes some view controllers to always use a form sheet presentation style by default: the signature view, the link annotation editing view, and the privacy access denied view shown from the new page view. (#20978)
• Changed
  Changes the PSPDFNewPageViewController presented from the document editor to uses a standard form sheet rather than our custom half modal style (in compact widths). (#20978)
• Changed
  Changes the minimum value of the brightness slider to 0.0 instead of 0.1 to match the range of UIScreen.brightness. (#21495)
• Changed
  File Annotations can now be deleted via the default annotation menu. (#21293)
• Changed
  Improved keyboard support: Command-Arrow Up/Down navigates to first/last page. (#20869)
• Changed
  PSPDFUndoController canUndo/canRedo now always updates correctly, even if invoked via the undo manager directly. (#19807)
• Changed
  Updates default values for text selection properties textSelectionMode and shouldShowSelectionHandles on Mac Catalyst and extends the documentation for textSelectionShouldSnapToWord. (#21012)
• Fixed
  Fixes an iOS 13 specific unsatisfiable constraint warning on PSPDFAnnotationStyleViewController. (#21196)
• Fixed
  Fixes an issue that caused the search UI to be misplaced when using the search button item action with a custom button. (#21409)
• Fixed
  Fixes an issue where selection of a page did not persist on reordering using drag and drop interaction in the Document Editor. (#21474)
• Fixed
  Fixes an issue where the accessibility label of a page was incorrect after reordering the page in the Document Editor. (#21474)
• Fixed
  Fixes editing free text annotations not always showing the keyboard when using multiple windows. (#21341)
• Fixed
  Fixes the PSPDFDocumentSharingViewController showing incorrect sharing options if the selected destination was set before the controller being presented. (#21410)

PSPDFKit

• API
  -[PSPDFDataProviding replaceWithDataSink:] has been extended to include an error parameter -[PSPDFDataProviding replaceWithDataSink:error:]. (#14338)
• API
  Renames the PSPDFKit global singleton to PSPDFKitGlobal to avoid conflicts with the PSPDFKit module name in Swift. (#21292)
• API
  Swift-incompatible methods on PSPDFProcessor and delegate-based error and completion handling on PSPDFProcessorDelegate have been removed. (#21233, Z#15373)
• API
  The PSPDFProcessor PDF generation API has been converted to class methods to better isolate it from the PDF processing operations. (#21000)
• API
  The PSPDFRenderOption enumeration has been replaced with the PSPDFRenderOptions class that now properly supports NSSecureCoding. (#17342)
• API
  The shouldDeleteAnnotation property on PSPDFAnnotation has been replaced with isDeletable. (#21293)
• API
  PSPDFAnnotationStyleManager now uses PSPDFStylePreset, a new protocol, rather than __kindof PSPDFModel* to expose preset instances. (#21362)
• API
  PSPDFLineAnnotation.init(point1:point2:) is no longer a failable initializer that produces an implicitly unwrapped optional. (#21194)
• API
  The class property isDeletable on PSPDFAnnotation has been converted to a per-object property to include object flags. (#21293)
• Removed
  Removes the rendering option to disable text anti-aliasing when using the non-native text rending option. (#21204)
• Removed
  Removes the class property isWritable on PSPDFAnnotation. All implemented subclassed annotation and form types are writable. (#21293)
• Added
  Adds NSSecureCoding support to PSPDFAnnotation and its subclasses. (#12026)
• Added
  Adds NSSecureCoding support to PSPDFColorPreset and PSPDFBorderStylePreset. (#21362)
• Added
  Adds support for setting a user activity on PSPDFDocument. (#20431)
• Changed
  Improves JPEG2000 with transparency support. (#20483)
• Changed
  Improves filesystem checking to better handle external storage and file server support on iOS 13. (#21159)
• Changed
  Improves font rendering and fixes several edge cases. (#20930)
• Changed
  Improves handling and documentation of custom digital signature sizes. Now cases where the signature size exceeds the reserved size in a document will be informed correctly. (#21304)
• Changed
  Improves the validation of Instant JSON payloads so that case differences in properties are tolerated. (#21145)
• Changed
  Disables generating PDFs from URLs and HTML strings on Mac Catalyst. (#21000)
• Changed
  Updates Botan to version 2.11.0. (#20549)
• Changed
  Updates Duktape to version 2.4.0. (#20954)
• Fixed
  Fixes a bug in redaction rendering where the font size wasn’t consistent. (#21088)
• Fixed
  Fixes an issue with transparent strokeColor in Instant JSON. (#21391)
• Fixed
  Fixes an issue when importing XFDF files in specific documents. (#21271)
• Fixed
  Fixes an issue where images with the lighten blend mode didn’t get rendered correctly. (#20642)
• Fixed
  Fixes an issue where loading a document would fail if it contained JPEG2000 images not specifying a color space. (#21311)
• Fixed
  Fixes an issue where text after signing had incorrect characters after looking at it in another viewer. (#20930)
• Fixed
  Fixes an issue where the error object was not set in case of a failure in -[PSPDFDataProviding replaceWithDataSink:error:]. (#21116)
• Fixed
  Fixes an issue where using the document editor to merge a document with many pages would lead to an out-of-memory crash. (Z#15277)
• Fixed
  Fixes issues with transparent image stamp annotations. (#7646)
• Fixed
  Fixes issues with transparent images in XFDF. (#9221)
• Fixed
  Fixes some stability issues related to color space management. (#21529)
• Fixed
  Fixes some stability issues when fonts are loaded from a document. (#21042)
• Fixed
  Fixes some use cases where PDFs with JavaScript validation scripts may not work as expected. (#21291)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to show a PSPDFViewController in SwiftUI. (#20381)
• Added
  Adds an example illustrating how to always show dark user interface style on the annotation toolbar. (#20403)
• Added
  Adds multi-window support to PSPDFCatalog on iOS 13. (#20431)
• Added
  Adds support to drag and drop tabs in TabbedBarExample. (#20431)
• Changed
  Changes the default appearance of the Catalog app to match Apple recommended styling. (#20211)
• Fixed
  Fixes an issue in the catalog PSCDrawAnnotationsAsOverlayExample where annotation were not overlaid appropriately. (#21276)

8.5.2 - 6 Sep 2019

PSPDFKitUI

• Added
  Adds a new property on PSPDFConfiguration called allowRemovingDigitalSignatures to control whether a digital signature can be removed or not. See DisableRemovingDigitalSignatureExample in PSPDFCatalog for more details. (#20586)
• Changed
  Changes the designated initializer of PSPDFSignedFormElementViewController to the new added initializer initWithSignatureFormElement:allowRemovingSignature:. (#20686)
• Fixed
  Fixes an issue where a sharing action would be executed automatically if the first sharing configuration available has no options to pick from. (#20964)
• Fixed
  Fixes an issue where the existing configuration was not preserved while showing a new digitally signed document in a new controller. (#20686)

PSPDFKit

• Changed
  Improves error reporting in +[PSPDFAnnotation annotationFromInstantJSON:documentProvider:error:] when the document was misconfigured. (#21177)
• Changed
  Improves memory usage with complex documents. (#20970)
• Changed
  Improves the stability of some PDF form operations. (#21032)
• Changed
  Improves the validation of InstantJSON in some corner cases. (#20748)
• Fixed
  Fixes a problem where some dates may be incorrectly formatted as Sunday. (#20363)
• Fixed
  Fixes an issue with annotation hit testing that could result in taps being received by a link annotation that was underneath another link annotation. (#21055)
• Fixed
  Fixes an issue where link annotations with a nil border color and a valid dash array were not being rendered. (#20749)
• Fixed
  Fixes annotations being misplaced when reopening a document that loads annotations from an external file after setRotationOffset:forPageAtIndex: had been used to apply a temporary rotation when that document was saved. (#20976)
• Fixed
  Fixes annotations sometimes being blurry when reopening a document that loads annotations from an external file after setRotationOffset:forPageAtIndex: had been called before that document was saved. (#20976)
• Fixed
  Fixes annotations sometimes not being saved to an external file after only annotation updates happened and setRotationOffset:forPageAtIndex: was called before saving. (#20976)
• Fixed
  Fixes pasted rotated vector stamps being double rotated which resulted in clipping. (#20916)
• Fixed
  Fixes -[PSPDFProcessorConfiguration drawOnAllCurrentPages:] producing offset drawing when the page has a MediaBox with a non-zero origin. (#20797)
• Fixed
  Fixes the drawingBlock of PSPDFFileAppearanceStreamGenerator not automatically handling page rotation. (#20983)
• Fixed
  Fixes a possible crash in certain documents due to a null dereference in isLinkedInAcroForms. (#21121)

Instant

• Added
  Adds a migration to populate the isFitting flag for all pre-existing free text annotations when appropriate, preventing the clipping of text on other platforms. This is an extension of the earlier fix which only populated this flag when an annotation was changed again. (#20727)
• Changed
  The isFitting property of free text annotations now properly reflects whether the text did fit on iOS. The text of such annotations will no longer be clipped in documents exported from PSPDFKit Server or in PSPDFKit for Web. (#20727)

Examples

• Fixed
  Fixes a crash that would occur when opening the Kiosk Grid example on iOS 13. (#20861)

8.5.1 - 8 Aug 2019

PSPDFKitUI

• Added
  Adds -[PSPDFDocumentSharingViewController initWithDocuments:sharingConfigurations:] and makes it the designated initializer. (#20842)
• Fixed
  Fixes an issue where annotations could not be moved in the annotation list when not all annotations were shown (typically when there were links). (#20822)
• Fixed
  Fixes an assertion when presenting certain table view controllers on iOS 13. (#20833)
• Fixed
  Fixes an assertion when using a custom variant for free text annotations. (#20823)
• Fixed
  Fixes the initially selected segment in PSPDFDocumentSharingViewController being ‘Share’ instead of the first one when custom configurations are used. (#20842)

PSPDFKit

• Added
  Adds PSPDFDocumentSaveStrategyRewriteAndOptimizeFileSize to enable file size optimizations when saving documents. (#20826)
• Changed
  Improves performance when opening documents with many links. (#20786)
• Fixed
  Fixes an issue where rotating pages using the document editor would always reset the page binding setting to the left edge. (#20732)

Instant

• Changed
  Prevents text clipping on other platforms when a free text annotation was created or updated on iOS such that all text is visible. (#20727)

Examples

• Fixed
  Fixes PSCFormFillingExample to properly respect specific input formats and validations of the form fields. (#20606)

8.5.0 - 31 Jul 2019

See the announcement post.

PSPDFKit now requires and is built with Xcode 10.3 (10G8).

• Added
  Adds an optional JSON Podspec (podspec.json) that you can use by appending .json to your podspec link. Learn more in our CocoaPods guide. (#20335)

PSPDFKitUI

• API
  The PSPDFDocumentInfoCoordinator’s delegate property is now of type PSPDFDocumentInfoCoordinatorDelegate, which is a newly introduced protocol. (#20469)
• Removed
  Deprecates PSPDFSignatureViewController’s lines property in favor of its drawView.pointSequences. (#20450)
• Added
  Adds the ability for users to change the order in which annotations are stacked on the page (the z-index) from either the annotation inspector or the annotation list. (#100)
• Added
  Adds the ability for users to change the document’s page binding in PSPDFDocumentInfoViewController. (#10603)
• Added
  Adds a unified color palette. This replaces the rainbow, modern, vintage, and monochrome color palettes in the default color set provided when creating and editing annotations. (#20212)
• Added
  Adds a halfModalStyle property to PSPDFConfiguration to allow the use of the annotation inspector without the card design introduced in PSPDFKit 8.4 for iOS. (#19944)
• Added
  Adds a PSPDFDocumentInfoViewControllerDelegate protocol to respond to changes from PSPDFDocumentInfoViewController. (#20510)
• Changed
  Changes links to open in Safari by default, because we believe this provides a better user experience. This can be changed back to SFSafariViewController (the in-app browser) by setting PSPDFConfiguration.linkAction to PSPDFLinkActionInlineBrowser. (#20692)
• Changed
  Disables natural drawing for ink annotations by default because it can sometimes produce artifacts at line ends. This can be changed back using PSPDFConfiguration.naturalDrawingAnnotationEnabled. (Z#14856)
• Changed
  Reduces the minimum line width for ink annotations from 0.5 to 0.1 in the annotation inspector. (#20654)
• Fixed
  Fixes an issue that caused certain pages to fade from black on iOS 13 when they were moved on-screen. (#20513)
• Fixed
  Fixes an issue where the back button of a navigation controller did not work on iOS 13. (#20533)
• Fixed
  Fixes an issue where annotations could appear duplicated and flipped after the app goes into the background. (#18695)
• Fixed
  Fixes an issue where you could delete a non-editable note annotation. (#20419)
• Fixed
  Fixes an issue where text wouldn’t be spoken if a device was in silent mode. (#20392)
• Fixed
  Fixes a floating scrubber bar layout issue by correctly ignoring the unsupported scrubberBarType values. (#20258)
• Fixed
  Fixes PSPDFNavigationController’s back external keyboard command taking precedence over text input. (Z#14834)
• Fixed
  Fixes navigating through forms using the tab key on external keyboards not working for multi-line text fields. (#20218)
• Fixed
  Fixes a rare issue where bookmark manager initialization could be triggered recursively and assert. (#20566)

PSPDFKit

• Added
  Adds API to change the order in which annotations are stacked on the page (the z-index). (#100)
• Added
  Adds support for rotating image stamp annotations. (#19692)
• Added
  Adds support for rotating vector stamp annotations. (#20345)
• Added
  Adds support for rendering emojis in free text annotations and forms. (#20629)
• Added
  Adds a PSPDFObjectsTestIntersectionFractionKey option for the document object finder, which can be used to filter out objects based on the fraction of their area intersecting with the target rectangle. (#20643)
• Added
  Adds support for preserving the Instant JSON id in the PDF. (#20572)
• Added
  Adds support for serializing and deserializing border properties of link annotations. (#20359)
• Added
  Add support for vertical alignment in single-line form fields when exporting or printing PDF files. (#19882)
• Changed
  The pageBinding property setter of PSPDFDocument now saves the page binding into the document instead of just keeping it in memory. (#20327)
• Changed
  Improves automatic repair of AcroForms when loading documents with a large number of annotations. (#19947)
• Changed
  Updates Expat to version 2.2.7. (#20545)
• Changed
  Updates libpng to version 1.6.37. (#19851)
• Changed
  Updates openjpeg to version 2.3.1. (#20647)
• Fixed
  Fixes an issue reading media boxes. (#20592)
• Fixed
  Fixes a deadlock that could occur when performing concurrent equality checks on annotation objects. (#20688)
• Fixed
  Fixes calling sizeToFit on a free text annotation resizing the annotation incorrectly. (#20302, Z#14464)
• Fixed
  Fixes an issue where annotations could become rotated and distorted in certain documents. (#20267)
• Fixed
  Fixes the appearance stream of stamp annotations sometimes not being preserved when the annotation is rotated, which is needed to avoid distorting it. (#15898)
• Fixed
  Fixes an assertion when importing annotations outside the page range using XFDF. (#20424)
• Fixed
  Fixes page indices being incorrect after the first data provider when exporting Instant JSON from a document with multiple data providers. (#20343)
• Fixed
  Fixes a crash that would occur after applying an Instant JSON update to a document where the changes contained form field updates. (#20152)
• Fixed
  Fixes an issue where form fields with calculation order may not be flattened correctly by the processor. (#20434)
• Fixed
  Fixes an issue where some documents with dropdown fields may show an arrow when the document is flattened. (#9539)
• Fixed
  Fixes a problem where overriding the digital signature reserved size may corrupt the signature appearance. (#20496)
• Fixed
  Fixes an issue that may prevent documents with certain restrictions from being digitally signed. (#20741)
• Fixed
  Fixes an issue where a custom dataSource set on a PSPDFSigner object was overridden sometimes. (#20487)
• Fixed
  Fixes an issue where some documents signed with invisible signatures could not be validated correctly. (#20277)

Examples

• Added
  Adds a Swift counterpart to the example PSCSaveAsPDFExample.m called SaveAsPDFExample.swift. (#20672)

8.4.2 - 5 Jul 2019

PSPDFKitUI

• Added
  Adds the ability to cut or copy pages from the PSPDFDocumentEditorViewController and paste them into other applications. Pasting PDFs copied from other applications is now also supported. (#19960)
• Changed
  Improves the documentation for sharing options related to printing and preset PSPDFViewController bar button items. (#18987)
• Fixed
  Fixes internal document references not being retained when cutting and pasting pages in PSPDFDocumentEditorViewController. These are now preserved so PDF GoTo Actions still work after saving. (#19470)
• Fixed
  Fixes an issue where annotation property changes from the inspector were not preserved when killing the app before exiting the annotation state. (#20232)
• Fixed
  Fixes images having a low resolution after being attached to form elements using the buttonImportIcon JavaScript API. Images will now be added at full resolution. (Z#14555)
• Fixed
  Fixes incorrect group spacing and cell layout issues on the sharing UI. (#18987)
• Fixed
  Fixes links and text field form elements showing a black border instead of no border when no color was set on the annotation and a non-zero border thickness was set. (#20449)

PSPDFKit

• Added
  Adds -[PSPDFDocumentEditor rotationForPageAtIndex:] to get the current rotation for a page of the document being edited. (#19960)
• Added
  Adds a property on PSPDFBookmarkManager to access the associated PSPDFDocument instance. (#20226)
• Changed
  Improves the loading performance for complex documents with lots of link annotations. (#19399)
• Changed
  PSPDFBookmarksChangedNotification is no longer posted when loading a document. (#18638)
• Fixed
  Fixes very occasional text rendering problems. (#20155)

Instant

• Fixed
  Fixes markup annotations not syncing reliably. (#20235)
• Fixed
  Fixes certain annotation types appearing rotated and distorted on rotated pages. (#20291)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to add a square annotation with cloudy borders button to the annotation toolbar. (#20400)
• Fixed
  Fixes Swift and Objective-C language detection of the examples on iOS 11. (#19953, Z#13392)

8.4.1 - 20 Jun 2019

PSPDFKitUI

• Changed
  Showing the annotation toolbar programmatically is now blocked by default when saving is not possible. (#16816)
• Fixed
  Fixes an issue where top-level entries in PSPDFOutlineViewController couldn’t be searched. (#20004)
• Fixed
  Fixes an issue where pages could go blank if an element on them had first responder status while they were moved offscreen. (#19638)
• Fixed
  Fixes an issue where PSPDFTabbedViewController’s tabbed bar would not appear when the view controller was embedded in a container controller. (#19414, #19826, Z#13332)
• Fixed
  Fixes an issue where setting the barTintColor on PSPDFScrubberBar did not have any effect. (#20169)
• Fixed
  Fixes an issue where setting the tintColor of the page grabber did not have any effect. (#20081)
• Fixed
  Fixes an issue where a shape annotation with a large line thickness could disappear when resized to small sizes. (#20022)
• Fixed
  Fixes an issue where the document could be modified during saving in the document editor. (#19830)
• Fixed
  Fixes an issue where the user could open the inspector of a non-editable annotation by selecting an editable one first. (#20283)
• Fixed
  Fixes the undo behavior for free text annotation rotation and resizing so that the annotation does not get distorted. (#20133)
• Fixed
  Fixes an issue that caused the document view to be loaded prematurely during PSPDFViewController initialization. (#20255)
• Fixed
  Fixes an issue with the annotation inspector where a UITableView separator was incorrectly shown under the last item. (#20109)

PSPDFKit

• Added
  Adds support for importing and exporting free text callout annotations using JSON. (#18202)
• Changed
  Improves loading performance for documents with complex outlines. (#20279)
• Changed
  Improves rendering of text with non-Latin characters. (#20189)
• Fixed
  Fixes an issue where image stamp annotations rotated by third-party software may lose their appearance. (#20165)
• Fixed
  Fixes video metadata lookup for YouTube videos. (#20180)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to persist PSPDFSettingsViewController settings in NSUserDefaults. (#20210)
• Changed
  Improves DrawOnPagesExample.swift to show how to draw multiple watermarks with different attributes. (#18922)

8.4.0 - 30 May 2019

See the announcement post.

PSPDFKitUI

• API
  Deprecates -[PSPDFDigitalSignatureCoordinator presentSignedDocument:showingPageIndex:] in favor of presentSignedDocument:showingPageIndex:withPresentationContext: to make presenting the signed document easier. (Z#13752)
• Removed
  Deprecates PSPDFUserInterfaceView.thumbnailBarInsets, which did not do anything. (#19771)
• Removed
  Removes the optionsView property from PSPDFNoteAnnotationViewController(SubclassingHooks) because returning any other value would lead to a crash. (#19841)
• Removed
  Removes the declarations of -configureZoomView:forSpreadIndex:, and -configureScrollView: from PSPDFDocumentViewLayout(Subclassing). These methods were unimplemented, and not used internally. Calling them would have lead to an “unrecognized selector” crash. (#19841)
• Removed
  Removes the unimplemented PSPDFPageLabelView(SubclassingHooks) category. (#19841)
• Removed
  Removes the unimplemented subclassing hooks -cancelDrawingAnimated: and -doneDrawingAnimated: from PSPDFAnnotationStateManager. (#19841)
• Removed
  Removes the unimplemented category PSPDFSavedAnnotationsViewController(SubclassingHooks). Calling the method it declared would have lead to an “unrecognized selector” crash. (#19841)
• Added
  Adds a new look and feel for the scrubber bar, which now appears to be floating in the user interface. To revert to the old design, set thumbnailBarMode to PSPDFThumbnailBarModeDockedScrubberBar in PSPDFConfiguration. (#16110)
• Added
  Adds an improved, modern visual design for the annotation inspector. (#19053)
• Added
  Adds support for rotating free text annotations to any angle. (#15900)
• Added
  Adds the ability to customize the eraser thickness in the UI which can be changed in the Annotation Inspector invoked from the Annotation Toolbar. (#18918)
• Added
  Adds the ability to apply redactions in a new file, to not overwrite the current document, from the UI. (#19247)
• Added
  Adds support for showing a blend mode menu item to the markup annotations selection menu. (#19985)
• Added
  Adds a subclassing hook, -[PSPDFUserInterfaceView updatePageLabelFrameAnimated:], for changing the page label position. (#19217)
• Added
  Adds <PSPDFCommonWebView>. This protocol documents the API requirements for the object returned by the webView property of PSPDFWebViewController. It acts as an abstraction of the common API of UIWebView and WKWebView, as used by our view controller. (#19841)
• Added
  Adds biometric properties on PSPDFDrawView: pointSequences, pressureList, timePoints, touchRadii and inputMethod. Calling clear on PSPDFDrawView now also clears any currently collected biometric data. (#19800)
• Changed
  Marks the inherited initializer -[PSPDFMenuItem initWithTitle:action:] as unavailable because it cannot be used with this class. (#19841)
• Changed
  Moves PSPDFGalleryItem(Protected) into a separate header file, and turned it into a class continuation. For subclassing PSPDFGalleryItem, please use #import <PSPDFKitUI/PSPDFGalleryItem+Subclassing.h> now. (#19841)
• Changed
  Promotes the declaration of -updatePageLabel in PSPDFThumbnailGridViewCell(SubclassingHooks) up the class hierarchy to PSPDFPageCell. (#19841)
• Changed
  Single-page documents now have the thumbnail bar hidden by default. A new property in PSPDFConfiguration (hideThumbnailBarForSinglePageDocuments) lets you configure this behavior. (#16110)
• Fixed
  Fixes a crash that could occur in -[PSPDFThumbnailFlowLayout ensureLayoutAttributesForItemsUpTo:] when viewing page thumbnails in double page mode. (#19984)
• Fixed
  Fixes a regression introduced in PSPDFKit 8.3.2 where the header in the thumbnail layout would be misplaced after rotation, and the sticky header would not stick. (Z#13392)
• Fixed
  Fixes an issue where an annotation’s fillColor returned UIColor.clearColor instead of nil for a clear color. (#19896)
• Fixed
  Fixes an issue where annotations drawn in dark mode had a black fill color instead of a clear fill color. (#19831)
• Fixed
  Fixes an issue where erasing or undoing an ink annotation changed the alpha of the remainder of the drawn ink annotation on page. (#19900)

PSPDFKit

• API
  Replaces the rotation property setter of PSPDFFreeTextAnnotation with setRotation:updateBoundingBox:, which is declared in the PSPDFRotatable protocol. (#19983)
• Added
  Adds Welsh localization. (#19923)
• Added
  Adds a new PSPDFPKCS7 class for representing a digital signature PKCS7 container. (#19916)
• Added
  Adds a way to construct an instance of a PSPDFPrivateKey from NSData that represents a valid private key in either PKCS1 or PKCS8 encoding format. (#19916)
• Added
  Adds embedSignatureInFormElement: API to the PSPDFSigner, an API that embeds a digital signature in a document already prepared to contain a digital signature. (#19479)
• Added
  Adds hashDocumentProviderRange: API to the PSPDFDocumentProvider, an API that returns a hashed part of a document provider, indicated by a particular byte range. Useful for creating digital signatures. (#19479)
• Added
  Adds prepareFormElementToBeSigned: API to the PSPDFSigner, an API that reserves space in a signature form field so that it can be signed later. (#19479)
• Added
  Adds the ability to set a custom signature watermark. (#19438)
• Added
  Adds support for the Doc.documentFileName JavaScript API. (#18775)
• Changed
  Makes enums use NS_CLOSED_ENUM so Swift callers don’t need to handle unknown cases. (#18679)
• Changed
  Improves rendering of text in appearance streams. (#19877)
• Changed
  Improves the performance of some JavaScript calculation scripts. (#19234)
• Changed
  Embedded goto actions will go to the specified page instead of going to the first page of the embedded target document. (#10963)
• Changed
  Improves automatic repair of AcroForms to support more document errors. (#19834)
• Changed
  Renames PSPDFSignatureInputMethod enum to PSPDFDrawInputMethod. The previous values have been deprecated. (#19800)
• Changed
  Updates Expat to version 2.2.6. (#19868)
• Changed
  Updates the Botan library version to 2.10.0. (#19767)
• Fixed
  Fixes a bug which caused the font picker to scroll to the selected item with a jerky animation. (#19108)
• Fixed
  Fixes an issue creating form fields where some fields could not be retrieved later by their original keys. (#19945)
• Fixed
  Fixes an issue where JavaScript API doc.getField() could get into a state where it wasn’t possible to retrieve newly created form fields. (#20027)
• Fixed
  Fixes an issue where rotating a page after deleting a note annotation could lead to an assertion failure. (#19853)
• Fixed
  Fixes an issue where the line start and end of a polyline annotation didn’t honor a clear fill color. (#20097)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to add a Blend Mode menu item to the highlight annotation selection menu. (#19985)
• Added
  Adds a PSPDFCatalog example illustrating how to customize the annotation inspector to set blend mode for vector stamp annotations. (#19979)
• Added
  Adds a PSPDFCatalog example illustrating how to access the biometric data of an ink signature from a -[PSPDFSignatureViewController drawView]. (#19800)
• Added
  Adds a PSPDFCatalog example illustrating how to access the biometric properties after digitally signing a document. (#19800)
• Added
  Adds an Objective-C version of the “Document progress” example where a PDF file is downloaded and displayed using the PSPDFViewController. (#19897)
• Changed
  PSCCustomAnnotationProviderExample now properly uses the PSPDFContainerAnnotationProvider. (#20024)

8.3.2 - 15 May 2019

PSPDFKitUI

• Added
  Adds PSPDFTextSelectionMenuActionCopy, PSPDFTextSelectionMenuActionMarkup, PSPDFTextSelectionMenuActionRedact, PSPDFTextSelectionMenuActionCreateLink, and PSPDFTextSelectionMenuActionAnnotationCreation to PSPDFTextSelectionMenuAction to allow for easier customization of allowed menu actions via PSPDFConfiguration.allowedMenuActions. (#19817)
• Fixed
  Fixes a crash within PSPDFDocumentEditorViewController that would happen when calling -[PSPDFViewController reloadData] after setting a new document with a lower page count than the current one. (#19839)
• Fixed
  Fixes an issue where the annotation state of the PSPDFAnnotationStateManager was set to an empty string when no annotation tool was selected. (#19911)
• Fixed
  Fixes an issue where the thumbnails view would automatically scroll for certain documents when the stickyHeaderEnabled property of PSPDFThumbnailFlowLayout was set to YES. (#19437)
• Fixed
  Fixes the alignment of the indexing status cell in PSPDFDocumentPickerController. (#19673)

PSPDFKit

• Added
  Adds undo support for link annotations. (#19702)
• Added
  Adds a variant property on PSPDFAnnotation. (#19903)
• Fixed
  Fixes an issue where the redaction text may not be correctly added in some scenarios. (#19703)
• Fixed
  Fixes an issue with file conflict resolution which caused incorrect handling of cases where an opened document is renamed, moved, or deleted when the app is backgrounded. (#19782)

8.3.1 - 2 May 2019

PSPDFKitUI

• Fixed
  Fixes an issue where the comments indicator icon was misplaced for rotated stamp annotations. (#19652)
• Fixed
  Fixes an issue where the flexible toolbar shadow was misplaced during the animation when moving the toolbar to a new position. (#19709)
• Fixed
  Fixes an issue where the username alert’s done button would remain disabled when programmatically presenting the alert with an empty suggested name. (#19695)
• Fixed
  Fixes an issue with button alignment on the scrubber bar toolbar on devices with bottom safe area insets. (#16254)
• Fixed
  Fixes an issue with the page mode not updating when rotating the device while editing a free text annotation. (#19160)

PSPDFKit

• Changed
  Improves performance when attempting to load custom fonts on demand. (#19662, #19661)
• Changed
  Improves performance when executing JavaScript actions on form fields with complex interdependent validation logic. (#19661)
• Changed
  Improves results from PSPDFLibrary when the PSPDFLibraryMatchExactPhrasesOnly option is specified, and a tokenizer other than the default porter tokenizer is used. (#19685)
• Changed
  Prevents a potential multithreading violation when the sqlite backend is accessed while a low memory notification is broadcasted. (#19750)
• Fixed
  Fixes an issue where the PSPDFRenderDrawBlock set using -[PSPDFProcessorConfiguration drawOnAllCurrentPages:] was overridden by the PSPDFRenderDrawBlock of a PSPDFDocument’s render options. (#19541)
• Fixed
  Fixes an issue where an annotation would not be up-to-date when using the processor while using the external file annotation save mode. (#19498)
• Fixed
  Fixes an issue where readonly checkboxes may not be rendered correctly. (#19506)
• Fixed
  Fixes a crash that could occur when deleting annotations using the menu interface. (#18061)
• Fixed
  Fixes a potential crash when processing large documents under low-memory conditions. (#19768)

Examples

• Changed
  Updates PSCPredefinedEmailBodyExample to use the new Document Sharing API. (#19725)
• Fixed
  Fixes a crash on the Custom Sharing Options example in Catalog. (#19711)

8.3.0 - 23 Apr 2019

See the announcement post.

PSPDFKit now requires and is built with Xcode 10.2.1 (10E1001).

PSPDFKitUI

• API
  Changes the methods on PSPDFSaveViewControllerDelegate to better handle saving files, especially for supporting showing the system file picker. Replaces -saveViewControllerDidEnd:shouldSave: with -saveViewController:saveFileToURL:completionHandler:, -saveViewController:didFinishWithURL:, and -saveViewControllerDidCancel:; and replaces -saveViewControllerShouldSave:toPath:error: with -saveViewController:saveFileToURL:completionHandler:. (#16997)
• API
  Deprecates the document editor specific API (initWithDocumentEditorConfiguration: and documentEditorConfiguration) and removes PSPDFDocumentEditorConfigurationConfigurable conformance on PSPDFSaveViewController. (#16997)
• API
  Makes the searchString parameter in -[PSPDFDocumentPickerControllerDelegate documentPickerController:didSelectDocument:pageIndex:searchString:] correctly declared as nullable. (#19040)
• API
  Removes -[PSPDFViewModePresenter updateInsetsForTopOverlapHeight:] with dropping support for iOS 10. (#19445)
• Removed
  Deprecates -[PSPDFAnnotationPresenting didShowPageView:] in favor of -[PSPDFAnnotationPresenting willShowPageView:] to better communicate the timing of this method call. (#19333)
• Removed
  Deprecates -[PSPDFSignatureViewController keepLandscapeAspectRatio], since showing the signature drawing area in a landscape format is the default. (#18772)
• Removed
  Deprecates the PSPDFPresentationPersistentCloseButtonKey presentation option and PSPDFNavigationController’s persistentCloseButtonMode and persistentCloseButton properties. Persistent close buttons are no longer used by PSPDFKit itself and support for them will be removed in a future release. (#18867)
• Added
  Adds new UI for link annotation creation and editing via PSPDFLinkAnnotationEditingContainerViewController, PSPDFPageLinkAnnotationEditingViewController, and PSPDFWebsiteLinkAnnotationEditingViewController. (#18909)
• Added
  Adds the link annotation tool to the default Annotation Toolbar configurations. (#18909)
• Added
  Adds support for showing link annotations with multiple rects, which happens if the link spans multiple lines. (#18909)
• Added
  Adds a rotation knob to PSPDFResizableView that can be used to change the angle of standard stamps and custom text stamps. Its appearance and position can be customized using the new rotationKnob property and centerPointForRotationKnobInFrame: method on PSPDFResizableView, and the PSPDFKnobTypeRotation enum value. (#15901)
• Added
  Adds external keyboard commands to navigate lists (table views) using arrow keys. (#7824)
• Added
  Adds external keyboard commands for navigation bar and toolbar buttons when using PSPDFNavigationController. (#7824)
• Added
  Adds external keyboard commands to switch tab in the document info view. (#7824)
• Added
  Adds a configuration option to enable adding multiple bookmarks to the same page in the UI. (#16371)
• Added
  Adds shouldResetAppearanceModeWhenViewDisappears property on PSPDFViewController, which allows you to disable the appearance mode reset on -[PSPDFViewController viewWillDisappear:]. (#19562)
• Changed
  Improves Digital Signature signing experience by presenting the Annotation Toolbar only when it is required. (#18192)
• Changed
  Improves signature drawing area sizing to make sure no drawings are cut off when rotating the device or resizing the app. (#18772)
• Changed
  Improves the behavior of form fields with autosizing fonts. (#19303)
• Changed
  Improves the internal annotation username state handling which caused issues when programmatically dismissing the annotation username alert. (#18905)
• Changed
  Improves the performance and reliability of the Document Editor. (#19349)
• Changed
  Changes how editableAnnotationTypes are set on PSPDFAnnotationTableViewController when presented by PSPDFKit. Links will be filtered out by default. (#18909)
• Changed
  Changing the type of markup annotations now sets the style of the changed annotation to the last used style for the new type. (#19255)
• Changed
  Enables link annotation editing by default, by adding them to PSPDFConfiguration.editableAnnotationTypes. (#18909)
• Changed
  Improve the logic to properly inset the Annotation Toolbar when the page grabber is used. (#18685)
• Changed
  The timing of -[PSPDFDocumentViewControllerDelegate willBeginDisplayingSpreadView:forSpreadAtIndex:] as well as PSPDFDocumentViewControllerWillBeginDisplayingNotification have been changed to be called before displaying the spread, as expected from their names. (#19333)
• Changed
  PSPDFDocumentPickerController now handles sandbox restrictions on the Simulator more accurately when trying to delete documents. (#19040)
• Fixed
  Fixes a memory leak when interacting with sound annotations. (#19295)
• Fixed
  Fixes an issue that could result in blank pages after scrolling or device rotation. (#18848, #18682)
• Fixed
  Fixes an issue where PSPDFThumbnailViewController and PSPDFDocumentEditorViewController would hold outdated references for documents when calling -[PSPDFViewController reloadData], resulting in inconsistencies. (#19363)
• Fixed
  Fixes an issue where PSPDFViewController was not completely reloading after changing the document’s pageBinding property. (#19199)
• Fixed
  Fixes an issue where a document could not be deleted in PSPDFDocumentPickerController. (#19458)
• Fixed
  Fixes an issue where changing the appearance mode would not be reflected on the currently visible pages in page curl mode unless the page was changed. (#18869, Z#12698)
• Fixed
  Fixes an issue where editing permissions was not allowed if the document was opened with user (open) password. (#19188)
• Fixed
  Fixes an issue where keyboard was not dismissed in favor of a form field popover. (#6523)
• Fixed
  Fixes an issue where the activity indicator on a page was still visible even after the completion of the rendering. (#19529)
• Fixed
  Fixes an issue where the Annotation Toolbar was not correctly placed when using the page grabber and the app was resized. (#19334)
• Fixed
  Fixes an issue where the wrong preset would be selected in the Annotation Inspector if multiple presets with the same color combination where present. (#19623)
• Fixed
  Fixes an issue which caused the line annotation’s start and end color to not persist correctly. (#19535)
• Fixed
  Fixes memory leaks when using PSPDFDocumentSharingViewController. (#14468)
• Fixed
  Fixes page change keyboard shortcuts in right-to-left layouts. (#19385)
• Fixed
  Fixes the half modal inspector scroll position sometimes jumping after showing the font picker or going back. (#19050, #19052)
• Fixed
  Fixes the half modal drag indicator appearing above the font picker search field where it didn’t fit well. (#18881)

PSPDFKit

• API
  Replaces the rotation property setter of PSPDFStampAnnotation with setRotation:updateBoundingBox:, which is declared in the PSPDFRotatable protocol. (#15888)
• Removed
  Deprecates -[PSPDFBookmarkManager removeBookmarkForPageAtIndex:] in favor of the new removeBookmarksForPageAtIndex:, which more accurately describes the handling of multiple bookmarks per page. (#16371)
• Added
  Adds support for rotating stamp annotations to any angle and ensures the visual size is retained when the rotation is changed. (#15899)
• Added
  Adds a customData property to PSPDFAnnotation. The contents of this property are saved to the corresponding annotation provider. (#18889)
• Added
  Adds PSPDFDirectory.documentPickerDirectory as a way to show the system file picker for directory selection. (#16997)
• Added
  Adds a drawingBlock property to PSPDFFileAppearanceStreamGenerator to allow additional custom drawing. See AppearanceStreamGeneratorWithCustomDrawingExample in PSPDFCatalog. (#19277)
• Added
  Adds French (Canadian) localization. (#19686)
• Added
  Adds showWatermark to PSPDFSignatureAppearance. This allows hiding the watermark from digital signatures. (#19438)
• Added
  Adds support for signing PDF documents using P12 keystores that contain CA certificates. (#19448)
• Added
  Adds support for modifying form fields and annotation widgets to Instant Document JSON. (#18771)
• Added
  Adds FontStyle to Instant JSON for widget annotations. (#18083)
• Changed
  Improves JavaScript error validation and error reporting. (#18899)
• Changed
  Improves performance of pages which hold lots of objects. (#19396)
• Changed
  Improves the performance of documents with JavaScript interactivity in many common scenarios. (#19119)
• Changed
  Automatically triggers a clearCache when the data directory is set. (#18898)
• Changed
  Changes the default PSPDFDocumentEditorConfiguration.saveDirectories to PSPDFDirectory.documentPickerDirectory, to use the system file picker for choosing a save location. (#16997)
• Changed
  Increases the default levels of undo actions from 40 to 100 to store more history. (#18756)
• Changed
  Loading PDF actions is now more reliable. (#18843)
• Changed
  Optimizes storage size of Magic Ink template files. (#19453)
• Changed
  Suppresses parsing and potential display of unsupported annotation types, such as widget annotations. (#19415)
• Changed
  Updates ICU to version 63.1. (#18974)
• Changed
  Updates libjpeg-turbo to 2.0.2. (#18973)
• Changed
  Updates libpng to 1.6.36. (#18972)
• Changed
  Updates zlib to 1.2.11. (#18975)
• Fixed
  Fixes a problem where a form field that is made visible by a JavaScript script may not show its formatted appearance. (#19119)
• Fixed
  Fixes a rare issue when parsing outlines. (#19469)
• Fixed
  Fixes a very occasional crash on editing form elements. (#19595)
• Fixed
  Fixes an assertion that could occur when applying certain rotation values in Instant JSON in certain documents. (#19391)
• Fixed
  Fixes an issue exporting Instant JSON shape annotations with transparent stroke colors. (#19120)
• Fixed
  Fixes an issue when redacting documents with monochrome inline images. (#19579)
• Fixed
  Fixes an issue when drawing a path using a pattern with alpha transparency. (#19148)
• Fixed
  Fixes an issue when rendering text with an overlay blend mode. (#19151)
• Fixed
  Fixes an issue when setting transparent colors in annotations. (#19120)
• Fixed
  Fixes an issue when sharing a document that resulted in blank pages. (#19267)
• Fixed
  Fixes an issue where the QuadPoints of link annotations were saved to the PDF incorrectly. (#19427)
• Fixed
  Fixes an issue where -[PSPDFDocument+DataDetection objectsAtPDFRect:pageIndex:options:] could return a nil annotations array. (#18846)
• Fixed
  Fixes an issue where a page would sometimes fail to render when scrolling through a document quickly. (#18571)
• Fixed
  Fixes an issue where annotations created by Apple Preview may not be copied and pasted correctly. (#19154)
• Fixed
  Fixes an issue where border width and border dash array of free-text annotations were not serialized properly to Instant JSON. (#19481)
• Fixed
  Fixes an issue where entering text after a PDF document script has executed may not work correctly. (#19119)
• Fixed
  Fixes an issue where form field input may not be correctly validated while the user is typing if some form field flags are set. (#19448)
• Fixed
  Fixes an issue where link annotations may not work correctly after a document is exported. (#19222)
• Fixed
  Fixes an issue where malformed widget annotations weren’t correctly attached to the form. (#19581)
• Fixed
  Fixes an issue where opening a document with annotations written by a version of PSPDFKit prior to 8.0 could lead to a deadlock. (#19007)
• Fixed
  Fixes an issue where some JPX images may not render correctly. (#18648)
• Fixed
  Fixes an issue where some memory may be leaked after running a script. (#19016)
• Fixed
  Fixes an issue where stamps with custom AP streams were added with the wrong rotation on rotated PDF pages. (#19351)
• Fixed
  Fixes an issue where text edited in form fields was incorrectly set in other form fields as well. (#19236)
• Fixed
  Fixes an issue where the fillColor property was ignored in Instant JSON for polyline annotations. (#19443)
• Fixed
  Fixes an issue with instant ink annotation not being sent to clients. (#19325)
• Fixed
  Fixes an issue with text markup alignment on accented characters. (#18214)
• Fixed
  Fixes some characters being missing from search preview. (#19361)

Instant

• Changed
  Demotes an assertion about an unexpected state of the database to a recoverable error when applying changes from the server. (#18698)
• Fixed
  Fixes an issue where multiple authentication requests for the same layer could be running concurrently. Under certain circumstances, this could cause multiple concurrent sync requests for the same layer too. (#18698)

Examples

• Changed
  All Swift examples have been updated to Swift 5. (#19405)
• Added
  Adds a PSPDFCatalog example illustrating how to customize the tab title of a PSPDFTabbedViewController. (#19590)
• Added
  Adds a PSPDFCatalog example illustrating how to customize the table view cell for a PSPDFSearchViewController. (#19572)
• Added
  Adds an example in Swift to customize the buttons in the Annotation Toolbar. (#19232)
• Fixed
  Fixes an issue where the close button was not visible in Custom Sharing Options example. (#19345)
• Fixed
  Fixes an issue with the navigation bar’s appearance and visibility in the example catalog. (#19348)

8.2.3 - 21 Mar 2019

PSPDFKitUI

• Fixed
  Fixes an issue where -[PSPDFTabbedViewControllerDelegate tabbedPDFController:didChangeVisibleDocument:] was not getting called when closing the visible tab. (#19298)
• Fixed
  Fixes an issue where tall form fields with auto-sizing fonts would behave incorrectly. (#19303)
• Fixed
  Fixes scrubber bar flickering when manipulating annotation properties. (#19200, #19210)

PSPDFKit

• Changed
  Updates scripts embedded in PSPDFKit.framework, so Xcode does not try to sign them for specific setups. All embedded scripts need to be called with bash from now on, e.g. bash PSPDFKit.framework/strip-bitcode.sh. You can manually delete the #!/bin/sh line from the script for older versions if you encounter ERROR ITMS-90035: “Invalid Signature. Code object is not signed at all.” pointing to a script embedded in PSPDFKit.framework. (#19190)
• Fixed
  Fixes an issue where the caps key may be incorrectly enabled on some form fields. (#19246)
• Fixed
  Fixes an issue where ink drawings created in macOS Preview and represented as vector stamps could in some cases be incorrectly displayed as a default stamp. (#19157)

Examples

• Fixed
  Fixes Swift language detection in the PSPDFKit Catalog on beta versions of Xcode. (#19095)

8.2.2 - 11 Mar 2019

PSPDFKitUI

• Changed
  Improves behavior when trying to share invalid documents. (#19102)
• Changed
  Improves the behavior for multiline form fields that have autosizing fonts. (#18999)
• Changed
  Improves the behavior when interacting with form fields when the page is zoomed in. (#18417)
• Changed
  Reduces the number of registered undo actions when dragging an ink annotations, which might have caused main thread freezes previously. (#19169)
• Fixed
  Fixes an issue that prevented the shouldHideUserInterfaceOnPageChange flag from being correctly honored when using tap to scroll navigation. (#16362)
• Fixed
  Fixes an issue where document metadata was ignored when sharing through UIActivityViewController. (#19056)
• Fixed
  Fixes an issue where sound annotations could not be played back if they did not have a note attached to it. (#19038)
• Fixed
  Fixes an issue where the “Copy” option is shown for annotations that do not support copying. (#15854)
• Fixed
  Fixes an issue where undoing free text callout annotation changes did not work properly. (#18197)

PSPDFKit

• Changed
  Reduces the numbers of undo actions recorded when modifying the points of free text callout, line, polyline, and polygon annotations. (#18197)
• Removed
  Removes the PSPDFFormElementFlag enumeration, which was unused. The supported flags can be set through the readOnly, required, and noExport properties on PSPDFFormField. (#19101)
• Fixed
  Fixes a potential crash when resolving additional downloadable fonts. (#18981)
• Fixed
  Fixes a rare deadlock when using undo/redo while a document is being deallocated. (#18977)
• Fixed
  Fixes an issue that could result in missing annotation note indicators for notes added in third party editors. (#19039)
• Fixed
  Fixes an issue where a form field with custom formatting may not be formatted correctly when its exported XFDF data is imported again. (#18791)
• Fixed
  Fixes an issue where annotation note indicators could be clipped when positioned on the edge of the annotation bounding box. (#19039)
• Fixed
  Fixes an issue where changes to the fileURL property of objects in a document’s dataProviders array were not reflected in the fileURLs, or fileURL property of that document. PSPDFDocument now uses KVO to reflect changes to the fileURL property of its dataProviders that conform to PSPDFFileDataProviding in its own fileURLs, and fileURL properties. (#18835)
• Fixed
  Fixes an issue where some JavaScript keystroke handling scripts may not work as intended. (#19070)
• Fixed
  Fixes an issue where the image of a push button may be displaced in some cases. (#18932)
• Fixed
  Fixes some issues where certain properties changed by a JavaScript script may not reflect correctly in the UI. (#18125)
• Fixed
  Fixes an issue where some layers were hidden incorrectly. (#14439)

8.2.1 - 18 Feb 2019

PSPDFKitUI

• Changed
  Improves the internal annotation username state handling which caused issues when programmatically dismissing the annotation username alert. (#18905)
• Changed
  Improve the logic to properly inset the annotation toolbar when the page grabber is used. (#18685)
• Fixed
  Fixes an issue that could result in blank pages after scrolling or device rotation. (#18848, #18682)
• Fixed
  Fixes an issue where changing the appearance mode would not be reflected on the currently visible pages in page curl mode unless the page was changed. (#18869, Z#12698)
• Fixed
  Fixes an issue where keyboard was not dismissed in favor of a form field popover. (#6523)
• Fixed
  Fixes the half modal drag indicator appearing above the font picker search field where it didn’t fit well. (#18881)

PSPDFKit

• Changed
  Improves JavaScript error validation and error reporting. (#18899)
• Changed
  Automatically triggers a clearCache when the data directory is set. (#18898)
• Fixed
  Fixes an issue where -[PSPDFDocument+DataDetection objectsAtPDFRect:pageIndex:options:] could return a nil annotations array. (#18846)
• Fixed
  Fixes an issues where a page would sometimes fail to render when scrolling through a document quickly. (#18571)

8.2.0 - 7 Feb 2019

See the announcement post. PSPDFKit 8.2 for iOS is the last minor version to support iOS 10. PSPDFKit 8.3 for iOS will raise the deployment target to iOS 11, allowing us to concentrate our development and support efforts.

PSPDFKitUI

• Removed
  Deprecates -[PSPDFDocumentEditorToolbarController toggleSaveActionSheet:presentationOptions:completionHandler:] in favor of -[PSPDFDocumentEditorToolbarController toggleSavingConfirmationViewController:presentationOptions:completionHandler:]. (#17589)
• Removed
  Deprecates -[PSPDFDocumentSharingViewControllerDelegate documentSharingViewController:willShareFiles:] and adds a new delegate method to set a custom filename for the generated files when sharing documents. (#18781)
• Removed
  Deprecates PSPDFFlexibleToolbarContainerView.flickToCloseEnabled which allowed to close the toolbar by flicking down on it while dragging. (#17893)
• Removed
  Deprecates bookmarkString on PSPDFBookmarkCell, since the cell now displays multiple labels. (#10916)
• Added
  Adds additional bookmark UI features and improves the overall bookmark cell design. (#10916)
• Added
  Adds a smoother and more delightful annotation inspector on iPhone that works as a proper sliding panel to better align with modern iOS design. (#17963)
• Added
  Adds shouldStartEditingBookmarkNameWhenAdding on PSPDFBookmarkViewController to disable the new behavior where an added bookmarks’ name is automatically made editable. (#10916)
• Added
  Adds -[PSPDFConfiguration redactionUsageHintEnabled] to determine if the redaction usage hint should be shown the first time the redaction tool is selected. (#18437)
• Added
  Adds textSelectionMenuItemForCreatingAnnotationWithType: to get a text selection annotation creation menu item, to make it easier to customize the text selection menu. (#17635)
• Added
  Adds a new default annotation toolbar configuration, to make the toolbar show an appropriate amount of items, in more cases. (#17322)
• Added
  Adds a subclassing hook for customizing the alert controller shown when the document editor is going to be dismissed. (#17589)
• Added
  Adds view state restoration support for the document editor toolbar. (#18467)
• Changed
  Improves automatic font size calculation for text widgets. (#18095)
• Changed
  Improves bounding box calculation used for creating text markup and redaction annotations in the UI to more closely reflect the actual text frames, and to not accidentally mark up adjacent characters. (#17675, #16629)
• Changed
  Improves conflict resolution handling while the view controller is not visible. (#18159)
• Changed
  Improves memory usage when scrolling through pages quickly in a large document. (#18460)
• Changed
  Improves the interaction for form fields that contain both the DoNotScroll and auto-sizing font flags. (#18254)
• Changed
  Improves the way default page templates are handled on PSPDFNewPageViewController. (#18239)
• Changed
  Changes the condition for determining if all text selection markup creation menu items should be displayed, from checking if the current device is an iPad, to checking if the view is shown in a regular horizontal size class. (#18117)
• Changed
  Changes the condition for determining if the markup style menu items should be shown in a submenu, from checking if the current device is an iPad, to checking if the view is shown in a regular horizontal size class. (#18117)
• Changed
  Imposes support for setting the flexible toolbar position via the toolbarPosition property. The set value is now prioritized over any preserved user state. (#18467)
• Changed
  Padding for text selection is no longer applied on the model level for glyphs, but instead only on the UI level for the text selection view. (#18036)
• Changed
  The minimum font size is now 4px, the maximum is 200px. (#18485)
• Fixed
  Fixes a potential assertion when a HUD toggle is scheduled but the view is removed during that time. (#18670)
• Fixed
  Fixes an issue in Document Permissions screen which allowed the user to save modified permissions without setting a Document Owner password. Previously, the permissions were not getting actually updated, however the UI might have led the user to believe so. (#18496)
• Fixed
  Fixes an issue in Document Permissions screen which allowed the user to set the same Document Open and Document Owner password. They can’t be the same. For more details, please see https://pspdfkit.com/blog/2018/protecting-pdf-documents/. (#18495)
• Fixed
  Fixes an issue where a modally presented PSPDFViewController could be dismissed after tapping on an annotation from the annotations list. (#18643)
• Fixed
  Fixes an issue where a warning was needlessly logged when the license did not include the Annotation Editing component. (#18448)
• Fixed
  Fixes an issue where backward and forward buttons were not updated correctly. (#18523)
• Fixed
  Fixes an issue where drawing in the signature UI was not following the touch location. (#18522)
• Fixed
  Fixes an issue where drawing or creating text markups didn’t work when scrolling to the next or previous page after activating the tool. (#18715)
• Fixed
  Fixes an issue where form fields that were marked as multiline but had the doNotScroll flag set and are really short would fail to accept input. (#16965)
• Fixed
  Fixes an issue where highlighting text using markup annotations did not work reliably after changing page using the thumbnail scrubber bar. (#18613)
• Fixed
  Fixes an issue where image stamp annotations could be inserted in the wrong spread in double page mode. (#18654)
• Fixed
  Fixes an issue where merging markup annotations or converting a markup to a different type caused the bounding box to change unexpectedly. (#18092)
• Fixed
  Fixes an issue where selected text and annotations were shown on an external screen while screen mirroring, which caused some UI glitches. (#18570)
• Fixed
  Fixes an issue where the UIMenuController for selected annotations was not positioned correctly. (#18186)
• Fixed
  Fixes an issue where the delegate of PSPDFSignatureSelectorViewController was overriden, when set before the view appeared. (#18431)
• Fixed
  Fixes an issue where the annotation inspector popover was not positioned correctly if the annotation was partially off screen. (#18453)
• Fixed
  Fixes an issue where the document on an external screen got stuck while screen mirroring when re-connecting a display while a document was visible. (#18570)
• Fixed
  Fixes an issue where the rect of newly added stamp annotations in double page mode was incorrect. (#18654)
• Fixed
  Fixes an issue where the user interface view could get stuck in a visible or hidden state, when switching pages while editing a free text annotation. (#18541)
• Fixed
  Fixes an issue where unsaved ink annotations were rendered incorrectly after rotating the page. (#18230)
• Fixed
  Fixes customization of the subject when sharing documents via email using the system share sheet. (#18099)
• Fixed
  Fixes support for dynamic document editor toolbar button layouts by correctly invoking and honoring the -[PSPDFDocumentEditorToolbar buttonsForWidth:] subclassing hook. (#18669)

PSPDFKit

• API
  Changes the return type of -[PSPDFBookmarkManager addBookmarkForPageAtIndex:] from void to PSPDFBookmark *. (#10916)
• API
  Deprecates PSPDFDocumentSaveOptionForceRewrite in favor of newly added PSPDFDocumentSaveOptionForceSaving and PSPDFDocumentSaveOptionStrategy. (#18142)
• Removed
  Deprecates -[PSPDFDocument applyInstantJSONFromDataProvider:toDocumentProvider:error:] in favor of a version that adds a lenient parameter, that controls the behavior when the JSON is (partially) invalid. (#18630)
• Added
  Adds PSPDFOriginalFontNameAttributeName to improve handling of fonts in free text annotations where the font is not readily available. In addition, setting an annotation’s fontName now preserves the fontSize. (#18421)
• Added
  Adds localizedActionType to PSPDFAction, and changes some of the strings returned from localizedDescriptionWithDocumentProvider:. (#10916)
• Added
  Adds support for cloudy borders in shape annotations and free text annotations via Instant JSON. (#18547)
• Added
  Adds support for multi-threaded rendering. (#18199)
• Added
  Adds support for stamp and free text annotation rotation in Instant JSON. (#18019)
• Added
  Adds support for the doc.removeField JavaScript API. (#18621)
• Changed
  Improves compatibility with 3rd-party SDKs that use Aspects to hook into message passing. (#18793)
• Changed
  Improves handling of a document’s documentProviders being recreated, which happens when calling clearCache and in low-memory situations. (Z#12006)
• Changed
  Improves handling of failures to add annotations to a given annotation provider. Annotations that could not be attached to the document are now not included in the return value of an annotation provider’s -addAnnotations:options: method. (#16326)
• Changed
  Improves initial text parsing performance. (#18534)
• Changed
  Improves performance when looking up fonts. (#17981)
• Changed
  Improves the locking mechanism for password-protected documents so that calling -[PSPDFViewController reloadData] won’t reload an explicitly-locked document. (#18561)
• Changed
  Improves the performance of documents which apply masks to text objects. (#15497)
• Changed
  Allow the use of -[PSPDFDocumentProvider setRotationOffset:forPageAtIndex:] on providers with custom annotation providers like XFDF or PSPDFKit Instant. (#17603)
• Changed
  Exposes -[PSPDFAnnotation blendMode]. See https://pspdfkit.com/guides/ios/current/annotations/annotation-blend-modes/. (#18410)
• Fixed
  Fix an issue in full-text search that could cause a deadlock during indexing. (#18750)
• Changed
  Padding for glyph frames is no longer applied in PSPDFBoundingBoxFromGlyphs and PSPDFRectsFromGlyphs. PSPDFDefaultTextPaddingFactor has been removed as well. (#18036)
• Changed
  The documentProvider property on PSPDFAnnotation is now readonly. (#18578)
• Changed
  Updates the Botan library to version 2.9.0. (#18271)
• Changed
  Use app name in JavaScript alerts. (#18529)
• Fixed
  Fixes a bug where annotations parsed from XFDF would be displayed incorrectly on a rotated page. (#17603)
• Fixed
  Fixes a problem importing/exporting color values. This could lead to unnecessary appearance stream regeneration. (#18428)
• Fixed
  Fixes a rare deadlock when using ink annotations from multiple threads. (#18674)
• Fixed
  Fixes an issue when opening a rotated Image Document. (#17791)
• Fixed
  Fixes an issue where creating text markup annotations via +textOverlayAnnotationWithRects:boundingBox:pageIndex: ignored the bounding box parameter and used the union of the rects as bounding box instead. (#18092)
• Fixed
  Fixes an issue where rendering a page with lot of annotations on a large zoom scale would cause memory usage to spike. (#18224)
• Fixed
  Fixes an issue with Image Documents when images have an orientation. (#17791)
• Fixed
  Fixes an issue with Image Documents when saving back to an already rotated image. (#18483)
• Fixed
  Fixes an issue with accessing the document metadata after receiving a low memory warning. (#18769)
• Fixed
  Fixes an issue with render cancellation when using a document that contains multiple data providers. (#18563)
• Fixed
  Fixes delegates not being correctly called for PSPDFDocumentEditorDelegate for some editor actions. (#18531)
• Fixed
  Fixes text markup annotations being created incorrectly on rotated pages with text that appears the right way up. (#18219, Z#11941)

Instant

• Changed
  Improves the display of and interaction with image annotations that have not been loaded yet. (#17004)
• Changed
  Enables support for creating and modifying stamp annotations. (#18773)
• Changed
  Hide Sharing action in PSPDFInstantViewController. Instant document cannot be shared. (V#1883)
• Fixed
  Fixes an issue where stamp annotations would lead to a failed assertion. (#17911)
• Fixed
  Fixes an issue where underline annotations would not sync properly. (#18030)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to disable bouncing for the document scroll and zoom views. (#18765)
• Added
  Adds an example in Swift for using the Apple Maps widget in a PDF page. (#18067)
• Changed
  Updates Catalog example to better illustrate how to customize the file names of documents being shared. (#18574)

8.1.3 - 15 Jan 2019

PSPDFKitUI

• Added
  Adds a new subclassing hook to PSPDFDocumentSharingViewController to customize the mail compose view controller when sharing to the Email destination. (#17955)
• Changed
  Improves change tracking to prevent presentedItemDidChange loops that could prevent saves with certain system file provider extensions. (#18409)
• Changed
  Publicly declares PSPDFFlexibleToolbarContainerDelegate conformance in PSPDFDocumentEditorViewController. (#18451)
• Fixed
  Fixes an issue in the Security/Permissions screen where the toolbar buttons changed prematurely. (#18261)
• Fixed
  Fixes an issue in the document editor where adding a new page after reordering pages would undo the reordering. (#18492)
• Fixed
  Fixes an issue that prevented tapping buttons on the document editor toolbar after long-pressing the thumbnail of a single page document. (#18181)
• Fixed
  Fixes an issue where the size of the generated image for sharing changed according to the scale of the device screen. (#18217)
• Fixed
  Fixes an issue where the swipe to delete action in the annotations list only worked for the first entry. (#18207)
• Fixed
  Fixes an issue where unsaved Free Text annotations did not render correctly after rotation of a page. (#18179)
• Fixed
  Fixes an issue that prevented the UI for sharing documents from being presented. (#18039)
• Fixed
  Fixes a potential exception when dismissing the document info popover. (#18215)
• Fixed
  Fixes an exception when calculating the tab bar index with a width of zero. (#18227)

PSPDFKit

• Added
  Adds a unique identifier uuid to PSPDFAnnotation. (#17635)
• Changed
  Improves error reporting when creating an image for a page of a document fails. (#18212)
• Fixed
  Fixes an issue when invalid Image Documents are read back. (#18110)
• Fixed
  Fixes an issue where the redaction of a monochrome image may change its color unexpectedly. (#18176)
• Fixed
  Fixes an issue with some documents using large amounts of memory when searching and navigating. (#18118)

8.1.2 - 20 Dec 2018

PSPDFKitUI

• Added
  Adds -[PSPDFDocumentSharingViewControllerDelegate documentSharingViewController:shouldShareFiles:toDestination:] to be able to halt the sharing process in case you want to handle the generated files yourself. (#17957)
• Fixed
  Fixes a rare exception when doing programmatic scrolling on iOS 10. (#18048)
• Fixed
  Fixes an assertion when the page view is about to be reused, but tries to finalize displaying the multimedia gallery. (#18060)
• Fixed
  Fixes an exception when trying to invoke share in the web view controller, when no URL is set. (#18026)
• Fixed
  Fixes an issue where PSPDFDrawView could not be subclassed and overridden. (#18157)
• Fixed
  Fixes an issue where drawing strokes might have been offset when resizing the app or rotating the device. (#17320)
• Fixed
  Fixes an issue where drawings could be offset from the actual touch location on very tall or wide pages. (#17769)
• Fixed
  Fixes an issue where the values for overlayText and repeatOverlayText were not persisted in the Redaction Annotation Inspector. (#17694)
• Fixed
  Fixes an issue where video preview generation could cause the main thread to stutter. (#17802)
• Fixed
  Fixes an issue with closing a tab via the close button and a keyboard shortcut at the same time. (#18104)
• Fixed
  Fixes an issue with image cropping when the image is invalid. (#18103)

PSPDFKit

• Changed
  Improves file asset handling for invalid PDF documents. (#18102)
• Changed
  Improves handling of invalid documents when enqueueing them in PSPDFLibrary. (#18106)
• Changed
  Improves handling of malformed documents when parsing the extended graphics state. (#18057)
• Changed
  Improves the API documentation for PSPDFUsernameHelper and PSPDFDocument.defaultAnnotationUsername. (#18031)
• Changed
  Improves thread handling and exiting when an app termination event is detected. (#18044)
• Changed
  Improve app termination handling when background library indexing operations are in flight. (#18056)
• Fixed
  Fixes a crash parsing text on a very small number of documents. (#18032)
• Fixed
  Fixes an assertion that might be triggered on document deallocation when the undo controller hasn’t been cleaned up yet. (#18062)
• Fixed
  Fixes an issue where PSPDFLibrary would return incorrect results when searching within documents that contained Unicode surrogate pairs (like Emoji) in their text. (#3292)
• Fixed
  Fixes an issue where redacting certain kinds of vector graphics may incorrectly redact part of the background. (#18071)
• Fixed
  Fixes an issue where redacting certain kinds of vector graphics may result in a lot of memory consumption. (#18065)
• Fixed
  Fixes an issue where the JavaScript method Doc.print may not work correctly. (#18111)
• Fixed
  Fixes an issue where the signature overlay may show incorrect text in non-Western languages. (#17918)
• Fixed
  Fixes an issue with file change tracking that could trigger to multiple conflict resolution messages or a document reload loop. (#18090, #18133)
• Fixed
  Fixes some visualization issues with markup annotations, specially on rotated pages. (#12927, #13162, #17713, #17889, #18002, #18024)

8.1.1 - 7 Dec 2018

PSPDFKitUI

• Added
  Adds support for unlocking an encrypted document when screen mirroring, as soon as the document is unlocked on the device. (#17990)
• Changed
  Makes the draw gesture recognizer resilient against an unexpected number of touches. (#18005)
• Fixed
  Fixes a crash that could occur after deleting pages in the document editor. (#17987)
• Fixed
  Fixes a potential exception when restoring view state for the document editor, before it is loaded. (#17984)
• Fixed
  Fixes an exception that might occur when the document editor loads images in the background while the user removes pages from the document. (#17985)
• Fixed
  Fixes an incorrect license check assertion that could be triggered when transitioning between the document and thumbnail view modes. (#17994)
• Fixed
  Fixes an issue causing an infinite recursion when unlocking an encrypted document with screen mirroring enabled. (#17990)

PSPDFKit

• Changed
  Improves strikeout annotation rendering, by making the line a little bit thicker and the baseline a little bit below the vertical center. (#17889)
• Fixed
  Fixes a rare exception when deallocating undoable objects in multiple threads. (#17983)

8.1.0 - 6 Dec 2018

See the announcement post.

PSPDFKitUI

• API
  Deprecates the PSPDFPageView methods convertViewPointToPDFPoint:, convertPDFPointToViewPoint:, convertViewRectToPDFRect:, and convertPDFRectToViewRect: in favor of the clearer and more versatile pdfCoordinateSpace property. (#12053)
• API
  Deprecates PSPDFAnnotationStateManager.drawingInputMode. Set the state to PSPDFAnnotationStringEraser instead. (#17458)
• Added
  Adds -scrollsToPageAtIndex:document:animated to the PSPDFViewModePresenter protocol. (#15136)
• Added
  Adds allowEditing, rightActionButtonItems, leftActionButtonItems to PSPDFDocumentInfoViewController and PSPDFDocumentSecurityViewController to allow customizing the interface. (#16429)
• Added
  Adds visiblePageIndexes property to PSPDFViewModePresenter. (#15136)
• Added
  Adds a Cancel button to discard changes in PSPDFDocumentInfoViewController and PSPDFDocumentSecurityViewController. (#16790)
• Added
  Adds a PSPDFConfiguration option, shouldAdjustDocumentInsetsByIncludingHomeIndicatorSafeAreaInsets, to enable the document view to ignore the home indicator when calculating safe area insets. (#17849)
• Added
  Adds a pdfCoordinateSpace property on PSPDFPageView as the new preferred way to convert between PDF page and view coordinates. (#12053)
• Added
  Adds a default conflict resolution UI to PSPDFViewController, PSPDFMultiDocumentViewController and PSPDFTabbedViewController via a new PSPDFConflictResolutionManager class. (#13367)
• Added
  Adds support for all three possible double-tap actions from the second-generation Apple Pencil (UIPencilInteraction). (#17458)
• Added
  Adds support for redacting more elements, like images, paths, annotations and forms. (#17002)
• Added
  Adds the ability to share multiple pages of a document as images. (#17020)
• Added
  Adds a pencilInteraction property and annotationStateManagerDidRequestShowingColorPalette: delegate method on PSPDFAnnotationStateManager to customize Apple Pencil double-tap actions. (#17458)
• Changed
  Improves flexible toolbar behavior, by disabling user interaction on its contentView while dragging it, to not cause UI glitches in case a button tap would present UI. (#17714)
• Changed
  Improves performance when scrolling in the thumbnail list, especially for complex documents. (#17337)
• Changed
  Improves the Document Editor experience on iPhones. (#17613)
• Changed
  Improves the descriptions for errors that happen when sharing documents. (#17774)
• Changed
  Improves the experience on the Document Editor when reordering pages. (#17838)
• Changed
  Improves the page selection experience when sharing multiple documents at once. (#17138)
• Changed
  Improves the screen mirroring experience and now properly syncs the configuration between the original and the mirrored view controller. (#17484)
• Changed
  Improves the sharing experience for documents that don’t have annotations. (#17220)
• Changed
  Prevents the annotation toolbar from being visible if the document is invalid after calling -[PSPDFViewController reloadData]. (#17624)
• Changed
  Removing a page on PSPDFDocumentEditorViewController no longer briefly displays a random number as the page number. (#17727)
• Changed
  Switching between the Thumbnails view and the Document Editor now preserves the position of the current page instead of scrolling to the first page. (#15136)
• Changed
  PSPDFDocumentSharingViewController now correctly calls -[PSPDFViewControllerDelegate pdfViewController:shouldSaveDocument:withOptions:] when sharing a document. (#16488)
• Fixed
  Fixes a potential exception when calculating collection view scroll offsets on iOS 10. (#17962)
• Fixed
  Fixes an issue when deleting pages in some documents on PSPDFDocumentEditorViewController. (#17762)
• Fixed
  Fixes an issue when sharing PDF documents as images. (#17686)
• Fixed
  Fixes an issue when sharing single-page documents using certain sharing configurations. (#17705)
• Fixed
  Fixes an issue where text markup and redaction selection could mark up whole images. (#17360)
• Fixed
  Fixes an issue where the document info and security UI disabled editing for encrypted documents. (#17271)
• Fixed
  Fixes an issue where the multi-annotation selection tool started recognizing the pan gesture only after a long swipe when zoomed into the page a lot. (#17565)

PSPDFKit

• API
  The distinction between standard stamps and custom text stamps has been clarified with the following deprecations and replacements. If you previously used the stamp subject consider whether you want a standard or custom text stamp. For standard stamps, subject has been deprecated in favor of stampType and the value of this property should usually be one of the values defined by the new PSPDFStampType string enum. PSPDFKit will provide the localized title for standard stamps. localizedSubject has been deprecated in favor of title. Set the title instead of stampType for custom text stamps, where you provide a title that has already been localized or user-generated. subtext has been deprecated in favor of subtitle. (#15895)
• API
  -[PSPDFAnnotationSummarizer temporaryPDFFileURLForPages:completionBlock:] is now only available on iOS. (#17109)
• Added
  Adds a custom tokenizer (PSPDFLibraryUnicodeTokenizerName) that performs full Unicode case folding on the input text. (#16219)
• Added
  Adds better support for annotations with custom appearance streams. (#15658)
• Added
  Adds progress reporting and cancellation support to PSPDFAnnotationSummarizer. (#17749)
• Added
  Adds support for conflict resolution options to PSPDFCoordinatedFileDataProvider and PSPDFDocument. This is achieved by levering APFS to create a lightweight file copy used for safe reading and potential later restoration. (#13367)
• Added
  Adds support for page bookmarks in compound documents. (#11008)
• Changed
  Improves compatibility with forms on malformed PDFs. (#17707)
• Changed
  Improves document features to reflect the current state of the document, by automatically updating them once an encrypted document has been unlocked. (#17271)
• Changed
  Improves error handling when saving a document fails. (#17685)
• Changed
  Improves performance on initializing a data provider. (#17897)
• Changed
  Improves tracking of external file changes. (#17946)
• Changed
  Changes the type of the keys of PSPDFDocumentPDFMetadata to PSPDFMetadataName. (#16790)
• Changed
  Log message sent from our render core can now be intercepted with the log handler. (#17732)
• Changed
  PSPDFDocumentXMPMetadata and PSPDFDocumentPDFMetadata now have failable document initializers and simply return nil if a document is not valid. (#17736)
• Changed
  PSPDFUndoController now checks if an undo/redo operation can be performed and fails gracefully, instead of throwing an exception when undo/redo is called on an empty stack. (#17921)
• Removed
  Removes zooming in on search results on iPads. (#17260)
• Changed
  The disk cache is now invalidated when a device locale change is detected. (#17919)
• Changed
  The redaction feature now deletes annotations and form fields that intersect with a redaction annotation. (#17390)
• Changed
  PSPDFAnnotationSummarizer no longer returns a nullable on its initializer. (#17109)
• Fixed
  Fixes a potential race condition when changing annotation properties from multiple threads at the same time. (#17690)
• Fixed
  Fixes a problem where some text in a PDF document may be redacted incorrectly. (#17699)
• Fixed
  Fixes an issue applying redactions on encrypted documents. (#17722)
• Fixed
  Fixes an issue looking up destinations in a names tree. This could lead to unresolvable link/outline destination. (#17206)
• Fixed
  Fixes an issue opening certain documents with invalid IRT fields. (#17797)
• Fixed
  Fixes an issue that may happen after copying a page using the document editor. (#17825)
• Fixed
  Fixes an issue when using PSPDFAppearanceCharacteristics without an image. (Z#11409)
• Fixed
  Fixes an issue where XMP metadata was corrupted when saving password protected documents. This enables saving bookmarks into password protected documents. (#17238)
• Fixed
  Fixes an issue where changing the button caption property of a button from JavaScript code may not change the button appearance. (#17719)
• Fixed
  Fixes an issue where editing a form field in the middle may incorrectly move the cursor to the end. (#17926)
• Fixed
  Fixes an issue where keystroke range replacements were not caught by Javascript correctly. (#17106)
• Fixed
  Fixes an issue where some PDF documents may show an indefinite spinner and not render correctly. (#17446)
• Fixed
  Fixes an issue where the Javascript VM init sequence prevented errors from bubbling up to the user. (#17745)
• Fixed
  Fixes an issue where the overlay text of a redaction may not be in the correct place in some cases. (#17695)
• Fixed
  Fixes an issue where the wrong message is return when a certificate is expired. (#16727)
• Fixed
  Fixes an issue with importing/exporting vector stamps with InstantJSON. (#16690)
• Fixed
  Fixes issues when importing annotations on rotated pages using InstantJSON. (#17814)

Instant

• Added
  Adds support for the Magic Ink tool. (#17362)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to search and redact text. (#17755)
• Added
  Adds a PSPDFCatalog example illustrating how to write and attach Instant JSON binary data. (#17778)
• Added
  Adds an example on how to create a custom UI to enter a name for a bookmark when adding one. (#17886)

8.0.4 - 28 Nov 2018

PSPDFKitUI

• Changed
  Improves handling of annotations with invalid bounding boxes. (#17731)
• Fixed
  Fixes an issue with presenting annotation filtering progress during concurrent annotation edits. (#17730)
• Fixed
  Fixes an issue with the annotation toolbar and sub menus. (#17716)

PSPDFKit

• Changed
  Improves error handling in the text parser for corrupted PDF documents. (#17735)
• Changed
  Improves handling of embedded assets in annotations. (#17717)
• Changed
  Background library index tasks are now correctly stopped when an application will terminate event is sent. (#17733)
• Changed
  Improve NSCoder error handling support for PSPDFDataContainerProvider. (#17734)
• Fixed
  Fixes a potential issue when rendering images. (#17737)
• Fixed
  Fixes an issue where PSPDFImageDocument’s data provider would reference invalid memory. (#17763)
• Fixed
  Fixes an issue where text could not be selected in certain documents. (#17759)
• Fixed
  Fixes an issue where text for highlighted annotations sometimes didn’t include newline character. (#17595)
• Fixed
  Fixes an occasional issue when rendering text. (#17747)
• Fixed
  Fixes the PSPDFAnnotation API hasBinaryInstantJSONAttachment and writeBinaryInstantJSONAttachmentToDataSink:error: returning incorrect values in certain situations. (Z#11192)
• Fixed
  Fixes an issue where underline annotations may not work correctly on rotated pages. (#14252)

Instant

• Fixed
  Fixes an issue where attempting to sync an invalid document could lead to an assertion failure. (#17817)
• Fixed
  Fixes an issue where image attachments with a more specific MIME-type were rejected as invalid server data. (#17790)
• Fixed
  Fixes an issue where incomplete image transfers would lead to missing images and possibly a flood of sync requests. (#17788)
• Fixed
  Fixes an issue where the concurrently finishing downloads of image attachments could have lead to a crash or data loss. (#17807)

8.0.3 - 15 Nov 2018

PSPDFKitUI

• Changed
  Improves handling of cell layout when parent frame has a size of zero. (#17622)
• Changed
  Improves text selection handle behavior in documents with vertical or rotated text. (#14252)
• Fixed
  Fixes an issue when switching the annotation tool while selecting text with a markup annotation tool. (#17623)
• Fixed
  Fixes an issue where undo could remove an annotation from a previous document. (#17620)
• Fixed
  Fixes an issue with selecting a polyline or polygon annotation with the finger, while currently being created with an Apple Pencil. (#17625)

PSPDFKit

• Changed
  Improves text selection for documents with rotated pages. (#14252)
• Fixed
  Fixes a crash that may happen when trying to generate the appearance stream of a push button. (#17627)
• Fixed
  Fixes a potential issue when converting magic ink annotations. (#17618)
• Fixed
  Fixes a potential issue when rendering certain PDF documents with note annotations. (#17617)
• Fixed
  Fixes an issue in handling documents with partially invalid pages. (#17621)
• Fixed
  Fixes an issue with unexpected state when clearing the annotation selection for specific configurations. (#17619)

8.0.2 - 9 Nov 2018

PSPDFKitUI

• Added
  Adds support for the new iPad Pros. (#17522)
• Added
  Adds allowEditing, rightActionButtonItems, leftActionButtonItems to PSPDFBookmarkViewController to allow customize the interface. (#16429)
• Changed
  Improves annotation deselection behavior when creating new annotations or navigating between pages. (V#1832)
• Changed
  Improves annotations list styling while editing. (#17434)
• Changed
  Improves customization options of PSPDFDocumentInfoCoordinator. (#16429)
• Fixed
  Fixes an animation glitch with the toolbar in the document info and document security UI. (#17437)
• Fixed
  Fixes missing search on annotations list view controller. (#17482)

PSPDFKit

• Added
  Adds support for util.scand, a JavaScript API that can be used from PDF documents to parse dates from strings. (#17480)
• Changed
  Improves performance while entering text using a non-latin font into form fields. (#17593)
• Changed
  Adjust default values of PSPDFLibrary cooldown timer for iOS 12.0 and higher. (#17441)
• Changed
  Changes the format of the InstantJSON bookmark format. The id is now saved in pdfBookmarkId and skippedBookmarkIds has been renamed to skippedPdfBookmarkIds. (#17400)
• Fixed
  Fixed an issue where the wrong encoding was used for the Symbol font. (#17245)
• Fixed
  Fixes a crash that could occur if an annotation is deleted while a checkpoint is being saved. (#17408)
• Fixed
  Fixes a crash that may happen when you add form fields with certain kinds of JavaScript scripts. (#17472)
• Fixed
  Fixes an issue where JavaScript dependent calculations may not be executed after a syntax error. (#17025)
• Fixed
  Fixes an issue where JavaScript form field validation erroneously used the previous value. (#16462)
• Fixed
  Fixes an issue where redacting content in some documents may show validation issues in third party readers. (#17486)
• Fixed
  Fixes an issue where rotating a page after adding a note annotation would crash without saving the document prior to rotation. (#17473)
• Fixed
  Fixes duplicate annotations when using PSPDFXFDFAnnotationProvider together with PSPDFFileAnnotationProvider. (#17526)
• Fixed
  Fixes an issue inserting Emoji, Arabic or East Asian text in form fields. (#17574)

Instant

• Fixed
  Fixes an issue where incoming changes in the middle of editing the text of a freetext annotation would lead to an assertion failure. (#17377)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to convert HTML to PDF with Swift. (#17536)
• Added
  Adds a PSPDFCatalog example illustrating how to programmatically create a push button form field with a custom image. (#17569)
• Added
  Adds the Calculator.pdf JavaScript demo to the Catalog. This example showcases a calculator application implemented completely inside a PDF using JavaScript. (#17547)

8.0.1 - 25 Oct 2018

PSPDFKitUI

• Changed
  Improves presentation experience by changing pages without animation when external keyboard is used. (#17346)
• Changed
  Improves scrolling performance for very complex documents when zoomed in. (#16655)
• Changed
  Changes the fill color set for redaction annotation which now does not include the unsupported clear color option. (#17261)
• Changed
  Magic Ink tool now does not convert the detected shape to its corresponding shape annotation if the creation of the detected shape annotation type is not added to the edtableAnnotationTypes property of the PSPDFConfiguration object. (#17241)
• Fixed
  Fixes a crash when using page curl transition and automatic page mode, during resizing the app in Split View. (#17323)
• Fixed
  Fixes a potential crash when having a filter selected in PSPDFThumbnailViewController. (#17325)
• Fixed
  Fixes an issue where tapping on undo while drawing a polygon shape or line annotation lead to a crash. (#17296)
• Fixed
  Fixes an issue where the PSPDFScrubberBar displayed the wrong thumbnail if the document hadn’t completed rendering and also when replacing the document. (#9387, #17135)
• Fixed
  Fixes an issue where the page rendering indicator was not animated and positioned properly. (#8524)
• Fixed
  Fixes creation of overlapping markup annotations. (#17316)
• Fixed
  Fixes height of the search view controller to show all available results when possible. (#17254)
• Fixed
  Fixes height of the search view controller when no matches are found. (#17254)

PSPDFKit

• Added
  Adds -[PSPDFNamedAction initWithNamedActionType:] as alternative initializer. (#17311)
• Changed
  Improves a free text annotation compatibility with Adobe Acrobat and other PDF readers. (#15095)
• Changed
  Improves support for NSSecureCoding in PSPDFDocument. (#17273)
• Changed
  Improve magic ink’s detection of lines and arrows. (#17339)
• Fixed
  Fixes an issue rendering certain documents with complex clip paths. (#16683, #17267)

Instant

• Added
  Adds support for shape annotations. (#17239, #17263, Z#10922)
• Fixed
  Fixes a bug that deleted all local layers of a document instead of just the layer backing a document descriptor. (#17264)
• Fixed
  Fixes a deadlock that could occur when deleting a layer or all loaded data. (#17257)
• Fixed
  Fixes an issue that could cause open file descriptors to be leaked when deleting the local data for a layer, document, or the entire Instant client. (#17303)
• Fixed
  Fixes an issue where remote deletion of the last annotation on a page would not correctly update the display. (#17062)

8.0.0 - 17 Oct 2018

See the announcement post.

This release features two new components - Redaction and Comparison. If you would like to add either to your license, ping our sales team to receive a quote.

Below is a summary of the API changes in this release. For a full list, with our suggested migration strategy for each API that has been changed or removed, please see the migration guide.

• API
  Removes all deprecated API. For a full list with suggested migration paths, see the migration guide. (#16157)

PSPDFKitUI

• API
  The flow for sharing documents has been revamped to allow the user to first decide what options to apply to the sharing documents and then sharing to a given destination; this change normalizes the sharing experience across PSPDFKit. Please refer the migration guide if you did anything related to sharing, such as overriding PSPDFDocumentSharingViewController, or using PSPDFDocumentSharingCoordinator or it’s subclasses. (#16453)
• API
  Changes the return type of PSPDFPageView’s showNoteControllerForAnnotation:animated: from PSPDFNoteAnnotationViewController to void to make it clearer this can show custom UI. If you need the view controller being presented, use pdfViewController:didShowController:options:animated:. (Z#10488)
• API
  Removes incorrect usage of UI_APPEARANCE_SELECTOR on PSPDFLinkAnnotationView and improves the documentation for that class. (#16689)
• API
  Resolves incorrect type usage and improves type safety on PSPDFConfiguration.propertiesForAnnotations and related APIs, with the introduction of a new extensible enum - PSPDFAnnotationStyleKey. (#16501)
• API
  Removes PSPDFScrubberBar.isSmallToolbar since the scrubber bar can have multiple sizes now. Override scrubberBarHeight to change its size. (#16017)
• API
  Removes PSPDFFlexibleToolbarHeight, PSPDFFlexibleToolbarHeightCompact, and PSPDFFlexibleToolbarTopAttachedExtensionHeight since the flexible toolbar can now have different sizes. (#16017)
• API
  Renames PSPDFAnnotationStringRedact to PSPDFAnnotationStringRedaction, and PSPDFAnnotationTypeRedact to PSPDFAnnotationTypeRedaction. (#2127)
• API
  Renames PSPDFBackButtonStyle to PSPDFButtonStyle. (#2127)
• API
  Changes PSPDFDocumentPermissionsLevel, PSPDFFormFieldType, and PSPDFSubmitFormActionFormat from NS_OPTIONS to NS_ENUM. (#16863)
• API
  Renames PSPDFSignatureBiometricPropertiesOptionPressue to PSPDFSignatureBiometricPropertiesOptionPressure. (#16863)
• Added
  Adds PSPDFConfiguration.documentViewLayoutDirectionalLock so that the scrolling direction can be locked on the document view. (#16687)
• Added
  Adds magicInkReplacementThreshold to PSPDFConfiguration. Adjust this property to change the shape detection strictness. (#16839)
• Added
  Adds redactionInfoButton to the user interface view, that is shown when there are uncommitted redaction annotations in the document. This button can be disabled via PSPDFConfiguration.shouldShowRedactionInfoButton. (#2127)
• Added
  Adds a new ‘Spread Fitting’ setting to PSPDFSettingsViewController. (#15724)
• Added
  Adds a new Magic Ink tool that recognizes drawn shapes and converts them to shape annotations. This tool is defined as a new variant of the Ink tool: PSPDFAnnotationVariantStringInkMagic. (#3923)
• Added
  Adds a new ink_highlighter image for use with the Highlighter variant of the Ink tool. (#16839)
• Added
  Adds a section separator to the settings UI. (#16261)
• Added
  Adds accessibility labels to the note annotation style view. (#11808)
• Added
  Adds support for creating redaction annotations from the annotation toolbar and from the text selection menu. (#2127)
• Added
  Adds support for the CMD-W command to close a document tab on PSPDFTabbedViewController. (#16088)
• Changed
  Improves how the document configuration applies to the visible document by avoiding unnecessary reload. (#16486)
• Changed
  Improves state restoration after rotation on PSPDFThumbnailViewController. (#16973)
• Changed
  Improves support for Dynamic Type and self-sizing cells in table views. (#16024)
• Changed
  Improves support for following readable width for various table views and cells. (#16013)
• Changed
  Improves the playback experience of sound annotations while interacting with documents. (#16422)
• Changed
  Improves the rendering support of push buttons. (#16507)
• Changed
  Improves the undoing experience for items dropped into PSPDFDocumentEditorViewController from other applications via Drag and Drop. (#16048)
• Changed
  Changes how the presets cell title is displayed in the annotation inspector. (#16674)
• Changed
  Changes the flexible toolbar width to 50 points on iPads on iOS 12, to match the system behavior. (#16017)
• Changed
  Image Documents now offer smarter defaults for the settings controller. (#16135)
• Changed
  Introduces PSPDFStyleButton, that is used for the back/forward and redaction info button in the user interface view. (#2127)
• Changed
  Prevents the menu controller from being displayed when a markup annotation is created using a markup tool. (#16650)
• Changed
  Readonly form fields are now tappable and execute actions/additionalActions. (#16865)
• Changed
  Shows an alert with a usage description the first time the redaction feature is used. (#2127)
• Changed
  The left/right edge tap navigation (scrollOnTapPageEndEnabled) now no longer applies in vertical scrolling configurations. (#16530)
• Changed
  The menu for selected text and selected images now features a Share item. The ‘Save to Camera Roll’ menu on images has been removed, as Share includes this as potential action. We added PSPDFTextSelectionMenuActionShare to control this. (#16141)
• Fixed
  Fixes a crash that could occur when quickly changing the document presentation options. (#16659)
• Fixed
  Fixes a logic issue that prevented the highlight annotation type menu from being displayed on some configurations. (#16884)
• Fixed
  Fixes a potential UI access on the main thread from PSPDFDrawView. (#16414)
• Fixed
  Fixes a hang of the main thread when certain progress views were updated in an unforeseen manner. (#17147)
• Fixed
  Fixes an infinite loop when adjusting the document size after a device rotation. (#16579)
• Fixed
  Fixes an issue that could prevent the annotation toolbar from showing, if it was invoked when the user interface was hidden. (Z#10094)
• Fixed
  Fixes an issue that could result in an incorrect jump to page behavior in documents with varying page sizes viewed in continuous scrolling mode. (#16627)
• Fixed
  Fixes an issue where custom render options using PSPDFAppearanceModeManager were not applied when PSPDFViewController is initialized with a document. (#16728)
• Fixed
  Fixes displayed page not updating when changing tabs in page curl mode. (#16788)
• Fixed
  Fixes an issue where drawn layers disappeared if the app is backgrounded. (#16795)
• Fixed
  Fixes an issue where hidden annotations could temporary become visible during erasing. (#16750)
• Fixed
  Fixes an issue where rotating the device while PSPDFThumbnailViewController was visible, could have resulted in thumbnails disappearing. (#15527, #16678)
• Fixed
  Fixes an issue where section footers were sometimes sized incorrectly. (#16146)
• Fixed
  Fixes an issue where the close button would disappear when changing segment in the document outline after changing from regular to compact width. (#15910)
• Fixed
  Fixes an issue where the color change animation for note annotations on iOS 10 didn’t sync properly. (#16752)
• Fixed
  Fixes an issue where the selected text overlay would be misplaced on rotation. (#17139)
• Fixed
  Fixes an issue where zooming to a page index might display that page partially off-screen when using continuous page transition. (#16967)
• Fixed
  Fixes an where deleting all annotations in list animated the cells to the top right corner. (#16696)
• Fixed
  Fixes changes to PSPDFNoteAnnotationViewController’s showColorAndIconOptions property not being applied immediately while the view is visible. (Z#10487)
• Fixed
  Fixes page view size when tab bar is visible. (#16474)
• Fixed
  Fixes secure unarchiving of PSPDFViewState not working. (#16850)

PSPDFKit

• API
  PSPDFKit now uses a standardized coordinate system where the page origin is always in the lower-left corner as the page appears on screen. The simplifies interaction with pages that have a rotation or cropbox set in the PDF. Please see the migration guide if you did anything in PDF coordinates or page coordinates, such as reading or writing annotation or glyph positions, or using PSPDFViewState. (#15890)
• API
  Instant JSON binary attachment APIs now take and return a mime-type. (#16039)
• API
  Removes PSPDFPageInfo’s rect, rotatedRect, and rotationTransform. They have been replaced by size and transform. (#15890)
• API
  Separates PSPDFPageInfo’s rotation property into savedRotation and rotationOffset. (#15890)
• API
  Removes the externalSignatureDelegate property of PSPDFSigner. Use the delegate property instead, as it’s intended to be more flexible. (#15853)
• API
  Removes the synchronous signing methods in PSPDFSigner. It’s more preferred to use the ones that are based on setting a custom dataSource or delegate, as they offer more flexibility. (#15853)
• API
  Changes the parameters of the conversion functions between view and PDF coordinate spaces. (#15890)
• Added
  Adds API support for resetting form fields to the PSPDFFormParser. (#16808)
• Added
  Adds API to PSPDFProcessorConfiguration to apply redaction annotations. (#2127)
• Added
  Adds Comparison features. Adds changeStrokeColorOnPageAtIndex:toColor:, and mergePageFromDocument:password:sourcePageIndex:destinationPageIndex:transform:blendMode: to PSPDFProcessorConfiguration. (#16396)
• Added
  Adds PSPDFAdditionalFontDirectories option to configure additional font directories. (#13991)
• Added
  Adds PSPDFDocumentSaveOptionApplyRedactions to apply redactions when saving the document. (#2127)
• Added
  Adds PSPDFSignerDataSource and PSPDFSignerDelegate to be able to add digital signatures to documents asynchronously. (#15853)
• Added
  Adds maximumContiguousIndexingTime and automaticPauseDuration to PSPDFLibrary to configure the automatic pause. (#17026)
• Added
  Adds outlineColor to PSPDFAnnotationStateManager, and PSPDFAnnotationStyleKeyOutlineColor as a new annotation style key, to allow setting the outline color of redaction annotations. (#2127)
• Added
  Adds a configurable privateKey property to PSPDFSigner. For convenience, this property is already set for you if you use the most common PSPDFSigner subclass, PSPDFPKCS12Signer, as soon as you unlock the .p12 bundle. (#15853)
• Added
  Adds a new render option, PSPDFRenderOptionDrawRedactionsAsRedacted, to draw redactions in their redacted state. (#2127)
• Added
  Adds model-level support for redaction annotations via the new PSPDFRedactionAnnotation class. (#2127)
• Added
  Adds the ability to compare document pages via PSPDFProcessorConfiguration. Requires the PDF Comparison feature to be enabled in your license. (#16396)
• Added
  Adds support for bookmarks to Instant Document JSON. (#16165)
• Changed
  Improves the performance of documents with a lot of JavaScript calculations. (#11925, #16490)
• Changed
  Renames PSPDFMarkupAnnotation to PSPDFTextMarkupAnnotation, and its highlightedString property to markedUpString. (#16652)
• Fixed
  Fixes a bug where the reason or location of a digital signature may not be persisted in the document correctly. (#15853)
• Fixed
  Fixes a potential deadlock during document (re-)initialization. (#15005)
• Fixed
  Fixes a race condition that could result in an incorrect page count when using documentByAppendingDataProviders:. (#16994)
• Fixed
  Fixes a render rounding issue that may happen in PDF documents with a displaced cropbox. (#15169)
• Fixed
  Fixes an issue that caused problems saving new annotations in particular documents. (#16717)
• Fixed
  Fixes an issue when extracting link annotations. (#16854)
• Fixed
  Fixes an issue where JavaScript scripts that hold a strong local reference to event.target may not work correctly. (#16507)
• Fixed
  Fixes an issue where documents with a large number of form fields failed to display editing options. (#16911)
• Fixed
  Fixes an issue where form elements were not correctly updated. (#16408)
• Fixed
  Fixes an issue where importing images in push buttons via JavaScript may add an annotation in some cases. (#16751)
• Fixed
  Fixes an issue where not all form fields were listable immediately after opening a document. (#16479)
• Fixed
  Fixes an issue where some PDF pages could not be inserted as attachments for images. (#16729)
• Fixed
  Fixes an issue where some document outlines may not be persisted correctly after using the document processor. (#16688)
• Fixed
  Fixes an issue where some documents with JavaScript may be unresponsive for a great amount of time. (#16886)
• Fixed
  Fixes an issue where the blend mode of ink annotations may not be persisted correctly. (#16376)
• Fixed
  Fixes an issue where the system sound recorder could invoke messages on already deallocated delegates after recording a sound annotation. (#16743)
• Fixed
  Fixes an issue with JPEG2000 images. (#14850)
• Fixed
  Fixes an issue with document checkpointing after saving fails. (#16600)
• Fixed
  Fixes an issue with free text annotations reducing render quality after moving them around many times. (#16329)
• Fixed
  Fixes an locking issue that could result in a deadlock while saving document editor changes. (#16980)
• Fixed
  Fixes annotations created from Instant JSON being offset from their correct position in documents with non-uniform page sizes. (#16802, Z#10493)
• Fixed
  Fixes a performance problem with documents that contain large clipping paths. (#16481)
• Fixed
  Fixes a problem applying Instant Document JSON. (#16004)
• Fixed
  Fixes a problem rendering documents with particular fonts. (#16361)
• Fixed
  Fixes an issue where the selection indices may not be set correctly during JavaScript keystroke validation. (#17199)

Instant

• Added
  Adds support for image annotations. (#11957)
• Added
  Adds the ability edit link annotations in PSPDFInstantViewController via editableAnnotationTypes. (#16665)
• Added
  Add handling of editableAnnotationTypes in PSPDFInstantViewController. (#16139, Z#9855)

Examples

• Added
  Adds PSPDFCatalog example illustrating how to blur specific pages in a document. (#16702)
• Added
  Adds a PSPDFCatalog example illustrating how to disable auto saving and ask for permission for saving the document while exiting. (#16456)
• Added
  Adds an example showcasing how to enforce a fixed style for link annotations. (#16689)
• Added
  Adds support for opening files in place to the Catalog example. (#16497)
• Added
  Adds a PSPDFCatalog example showing show to replace PSPDFNoteAnnotationViewController with custom UI. (Z#10488)
• Changed
  Changes the page rotation examples’ title and description for better distinction. PSCRotatePageExample.m changes the orientation of the pages and saves it to the PDF making them permanent while RotatePageExample.swift rotates the pages of the document temporarily only for that opened instance. (#16996)
• Fixed
  Fixes an issue where documents did not open properly in the “Open In” example. (#16616)

7.7.2 - 23 Aug 2018

PSPDFKitUI

• Fixed
  Fixes an issue where iOS 12 could throw an exception inside -[UIAccessibilityInformationLoader _loadAccessibilityInformationOnMainThread:]. (#16489)
• Fixed
  Fixes an issue where a reused outline cell could have a custom text color set. (#16355)
• Fixed
  Fixes an issue where newly created annotations could have an incorrect fill color assigned in rare cases. (#16562)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how create free text annotations continuously. (#15825)

7.7.1 - 9 Aug 2018

PSPDFKitUI

• Added
  Adds the selection tool to the default image configuration options. (#16109)
• Added
  Adds a new markupAnnotationMergeBehavior configuration option. (#16425)
• Changed
  Improves form element behavior when the form field has scrolling disabled. (#13239)
• Changed
  Improves top content inset calculations to cover more presentation scenarios. (#16020)
• Changed
  Ensures text selection gestures are handled by a single page at a time. (#16374)
• Changed
  Form submission actions that have a mailto URL now display the system mail composer with the form in the requested format attached. (#16072)
• Changed
  Tapping a search result that changes to a different page now offers a back action to return to the previous page. (#16343)
• Fixed
  Fixes PSPDFDocumentSharingViewController.selectedOptions not being respected if set before the view controller is presented. (#15832)
• Fixed
  Fixes Drag and Drop support for PSPDFDocumentEditorViewController so that pages are always exported in the correct format if the destination application accepts PDF files. (#16230)
• Fixed
  Fixes a crash in the inline search manager through better sanitization. (#16226, Z#9937)
• Fixed
  Fixes an issue that caused newly added annotations to flicker when switching between drawing tools. (#16128)
• Fixed
  Fixes an issue where PSPDFFontPickerViewController subclasses did not honor the passed fontFamilyDescriptors completely. (#16306)
• Fixed
  Fixes an issue where selectedPages was not reset in PSPDFDocumentEditorToolbarController when setting a new documentEditor and caused selectedPages to be in an outdated state. (#16213)
• Fixed
  Fixes an issue where markup annotations were incorrectly created when tapping on an empty space. (#16189)
• Fixed
  Fixes an issue where newly created annotations could be inserted into the wrong document when switching tabs. (#16166)
• Fixed
  Fixes an issue where the search view controller would sometimes be displayed full-screen without a cancel button instead of being displayed as a popover. (#16378)
• Fixed
  Fixes an issue with using the tab bar controller when the document editor component was not licensed. (#16331)
• Fixed
  Fixes search results sometimes not being highlighted on page when tapping on a search result that is not on the current page. (#15236)

PSPDFKit

• Added
  Adds -library:didFinishIndexingDocumentWithUID:success: to PSPDFLibraryDataSource. (#16185)
• Added
  Adds -library:didRemoveDocumentWithUID: to PSPDFLibraryDataSource. (#16185)
• Added
  Adds PSPDFRotatable protocol that enables annotations to be rotated. (#16183)
• Changed
  Annotations that are hidden or have the NoView flag set are no longer part of interactions. (#16344)
• Changed
  Clarify requirements for custom UID values on PSPDFDocument. (Z#9936)
• Changed
  Ensures PSPDFDocument.title is updated when the document is unlocked. (V#1599)
• Changed
  Ensures that PSPDFLibrary stops indexing when the application is terminating. (#16212)
• Changed
  Image documents now correctly report that bookmarks are not supported. (#16138)
• Fixed
  Fixes an issue where an assertion is raised when adding an annotation while the underlying file for a PSPDFDocument is being changed. (#16276)
• Fixed
  Fixes PSPDFDocument.title not being updated when the title is changed by an instance of PSPDFDocumentPDFMetadata. (#16193)
• Fixed
  Fixes a crash that would occur when trying to edit a document after having duplicated pages. (#16360)
• Fixed
  Fixes a race condition during undo registration that could result in a bad memory access. (#16216)
• Fixed
  Fixes an issue where PSPDFLibraryFileSystemDataSource would remove previously indexed documents when adding a document in explicit mode. (#16185)
• Fixed
  Fixes an issue where calling JavaScript function AFSpecial_Keystroke with certain arguments may cause an infinite loop in some devices. (#16126)
• Fixed
  Fixes an issue where form elements were not detected by PSPDFDocument (when using PSPDFFileAnnotationProvider). (#16161)
• Fixed
  Fixes an issue where radio buttons could be unselected. (#16233)
• Fixed
  Fixes drawing annotations on rotated pages. (#16183)
• Fixed
  Fixes an issue when loading checkpoint files. (#16277)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to disable bookmark editing. (#16416)
• Added
  Adds a PSPDFCatalog example illustrating how to use a custom bookmark cell to disable renaming of bookmarks. (#16358)

7.7.0 - 19 Jul 2018

See the announcement post.

PSPDFKitUI

• API
  PSPDFTextMenu is now an extensible enum string. This changes how Swift imports the strings. (#15789)
• Removed
  Deprecates -[PSPDFViewControllerDelegate pdfViewControllerDidChangeControllerState:] in favor of -[PSPDFViewControllerDelegate pdfViewController:didChangeControllerState:error:]. (#9087)
• Removed
  Deprecates -[PSPDFPageView showSignatureControllerAtRect:withTitle:options:animated:]. Use showSignatureControllerAtRect:signatureFormElement:options:animated: instead. (#15788)
• Removed
  Deprecates insertAnnotations: and insertAnnotations:forPageAtIndex:inDocument: on PSPDFPageView. To know when annotations are inserted, listen for PSPDFAnnotationCreateActionDidInsertNotification instead. To add annotations, use addAnnotations:options: on PSPDFDocument. Set the pageIndex on an annotation before adding it to define the page. (#15788)
• Removed
  Deprecates the filtering API on PSPDFThumbnailViewController in favor of a new, more flexible asynchronous API. (#14572)
• Removed
  Deprecates showNoteControllerForAnnotation:showKeyboard:animated: on PSPDFPageView. Use showNoteControllerForAnnotation:animated: instead. (#15788)
• Added
  Adds Document Info view controller: PSPDFDocumentInfoViewController. (#12227)
• Added
  Adds Document Info view to the outline and annotation list. (#12227)
• Added
  Adds Document Security view controller. PSPDFDocumentSecurityViewController. (#12227)
• Added
  Adds Safari Reading List, Copy and Share to the menu shown when long pressing on web links. (#13798)
• Added
  Adds PSPDFAnnotationCreateActionDidInsertNotification and PSPDFAnnotationCreateActionInsertedAnnotationsKey to get better timing for newly inserted annotations. (#15788)
• Added
  Adds PSPDFDocumentSharingOptionImageWithMetadata to PSPDFDocumentSharingOptions, and adds it to the default sharing configurations. This only takes effect when sharing PSPDFImageDocuments. (#15432)
• Added
  Adds PSPDFSegmentImageProviding protocol implemented by controllers used in PSPDFDocumentInfoCoordinator, to provide image in place of title. (#13677)
• Added
  Adds a way to add multiple pages to a document using a specified configuration, via API and user interface. (#13937)
• Added
  Adds support for the Info action on documents, which now displays the new document metadata view controller. (#15987)
• Added
  Adds the ability to insert new pages at specific indexes with PSPDFNewPageViewController. (#13880)
• Added
  Adds the ability to cut and paste pages when editing a document. (#15754)
• Changed
  Improves export flow for image documents. (#15432)
• Changed
  Improves page curl to better adapt to documents that don’t match device screen ratio. (#15786)
• Changed
  Improves performance during drawing by avoiding unnecessary page re-rendering. (#16032)
• Changed
  Improve performance when scrolling page content when zoomed in. (#16029)
• Changed
  Pages now use predictive rendering while scroll deceleration is active to improve render performance. (#15542)
• Changed
  Replaces title texts with icons in the document info UI. (#13677)
• Changed
  Solves flickering on the annotation list for PDF forms. (#14881)
• Changed
  The digital signature verification popover now uses a better sizing logic. (#15942)
• Changed
  The note editor is now displayed with form presentation mode on an iPhone Plus. (#4488)
• Changed
  PSPDFDocumentEditorViewController now supports importing and exporting images and PDFs from other applications via Drag & Drop in iOS 11 and above. (#15812)
• Fixed
  Fixes PSPDFConfiguration.editableAnnotationTypes not being respected for note annotations. (#15779)
• Fixed
  Fixes a crash that occurred when rotating in page curl mode. (#15765)
• Fixed
  Fixes a crash when using custom page templates on PSPDFNewPageViewController. (#15857)
• Fixed
  Fixes an issue where PSPDFResizableViewDelegate methods were not called for custom PSPDFResizableView subclasses. (#15762)
• Fixed
  Fixes an issue where PSPDFViewController would not fully reload when appearing in some uncommon cases. (V#1309, V#1609)
• Fixed
  Fixes an issue where a page image from a document previously used with PSPDFViewController might be shown instead of the page of the current document. (#15932)
• Fixed
  Fixes an issue where annotations could be displayed mirrored or more than once after drawing. (#15770)
• Fixed
  Fixes an issue where changing PSPDFConfiguration.isFirstPageAlwaysSingle was not honored after being changed. (#15819)
• Fixed
  Fixes an issue where newly added image annotations did not respond to touches. (#15667)
• Fixed
  Fixes an issue where using buttonImport on forms via JavaScript could break the default image annotation insertion feature. (#15731)
• Fixed
  Fixes misalignment of text in PSPDFNewPageViewController when presented as full screen. (#15471)
• Fixed
  Fixes reference cycles in PSPDFDownloadManager and PSPDFGalleryViewController. (#16018)
• Fixed
  Fixes the “Open In” activity not working when sharing documents using PSPDFDocumentSharingOptionImage. (#16028)
• Fixed
  Fixes the timing for -[PSPDFDocumentViewControllerDelegate documentViewController:didCleanupSpreadView:forSpreadAtIndex:] and PSPDFDocumentViewControllerDidCleanupSpreadViewNotification. They are now correctly dispatched during spread cleanup (reuse) and not when the spreads go offscreen. (#16032)

PSPDFKit

• API
  Adds isUnlockedWithFullAccess property to PSPDFDocument. (#12227)
• API
  Improves type safety of PSPDFDocumentPDFMetadata keyed subscript access. (#12227)
• API
  Introduces dedicated types for annotation variants (PSPDFAnnotationVariantString) and state-variant identifiers (PSPDFAnnotationStateVariantID), and updates all related APIs to correctly consume and vend the new types. (#14238)
• Removed
  Deprecates PSPDFDiskCache’s jpegCompression in favor of compression. (#14075)
• Removed
  Deprecates PSPDFProcessorSkipPDFCreationKey since it no longer does anything. (#15894)
• Removed
  Deprecates the rotation property on PSPDFAnnotation and adds the same property on the subclasses PSPDFFreeTextAnnotation and PSPDFStampAnnotation. (#15894)
• Added
  Adds isEncryptedWithUserPassword, isUnlockedWithFullAccess, isUnlockedWithUserPassword properties to PSPDFDocumentProvider. (#12227)
• Added
  Adds permissionsLevel property to PSPDFDocumentProvider to indicate access level of opened document. (#12227)
• Added
  Adds support for JavaScript do not disturb mode. In that mode, if code tries to show an alert message, it will be automatically translated into a console log instead. This is useful in the batch processing of form fields that may have validation scripts attached. You can configure this mode via the javaScriptStatus property of PSPDFDocument. (#15498)
• Added
  Adds support for extracting and attaching binary Instant JSON attachments. (#15834)
• Added
  Adds support for rendering borders and border colors in link annotations. (#15566)
• Added
  Adds image attachments to Instant Document JSON. (#15748)
• Changed
  Improves document password support and compatibility with third-party readers. (#15951)
• Changed
  Improves the performance of the document searcher, specially in devices with low memory. (#15916)
• Changed
  Improves hash call performance for lazily evaluated actions. (#13917)
• Changed
  Ensures that the processor always encrypt documents using the 128-bit AES algorithm if the user didn’t change the defaults. (#15946)
• Removed
  Removes incorrect PSPDF_CLASS_AVAILABLE annotation from PSPDFDocumentEditorConfiguration. Subclassing this class is not supported, and has now been marked with PSPDF_CLASS_AVAILABLE_SUBCLASSING_RESTRICTED. (#15147)
• Changed
  PSPDFDocumentEditor now returns NSProgress when calling importPagesTo:fromDocument:withCompletionBlock:queue: for better status tracking. (#15918)
• Fixed
  Fixes PSPDFFile.fileURL returning an empty NSURL when initialized with a nil fileURL. (#16120)
• Fixed
  Fixes a crash that could occur after adding an annotation deserialized from Instant JSON. (#14815, Z#9340)
• Fixed
  Fixes a problem where a form field may not be automatically formatted in some cases. (#15567)
• Fixed
  Fixes a problem where entering text in some form fields with JavaScript validation may not be possible. (#15864)
• Fixed
  Fixes a problem where some XFA forms with JavaScript may show an alert message when the document is open. (#16000)
• Fixed
  Fixes a race condition that could lead to an assertion failure through improved locking. (#15548)
• Fixed
  Fixes a rare issue adding page references with the document editor. (#14705)
• Fixed
  Fixes an issue exporting document pages with a rare outline configuration. (#15923)
• Fixed
  Fixes an issue where a new digital signature could not be created in some documents. (#15683, #15702)
• Fixed
  Fixes an issue where bookmarks may not be saved correctly in certain documents. (#15826)
• Fixed
  Fixes an issue where rendering was being incorrectly canceled. (#15685)
• Fixed
  Fixes an issue where the library tokenizer was nil after creating the library with +[PSPDFLibrary libraryWithPath:tokenizer:error:]. (#15991)
• Fixed
  Fixes memory leaks that occurred when using PSPDFProcessor. (#15767)
• Fixed
  Fixes serialization and deserialization of the PSPDFURLAction.unmodifiedURL URL property. (#13990)

Instant

• Added
  Add support for notes on annotations that support them. (#15511)

7.6.2 - 28 Jun 2018

PSPDFKitUI

• Fixed
  Fixes PSPDFConfiguration.editableAnnotationTypes not being respected for note annotations. (#15779)
• Fixed
  Fixes a crash that occurred when rotating in page curl mode. (#15765)
• Fixed
  Fixes an issue where newly added image annotations did not respond to touches. (#15667)
• Fixed
  Fixes an issue where using buttonImport on forms via JavaScript could break the default image annotation insertion feature. (#15731)

PSPDFKit

• Fixed
  Fixes a crash that could occur after adding an annotation deserialized from Instant JSON. (#14815, Z#9340)
• Fixed
  Fixes an issue where a new digital signature could not be created in some documents. (#15683, #15702)

7.6.1 - 14 Jun 2018

PSPDFKitUI

• Fixed
  Fixes an issue that could cause blank pages in per page and continuous page modes. (#15504)
• Fixed
  Fixes an issue with PSPDFImagePickerController where allowedImageQualities was ignored if the image editor was disabled. (#15599)

PSPDFKit

• Changed
  Improves image document saving performance. (#15540)
• Added
  Adds the ability to print image documents. (#15375)
• Changed
  Image quality for JPEG now used in Image Documents. (#15499)
• Changed
  Validation errors generated by JavaScript code are now localized in every language that is currently supported. (#14577)
• Fixed
  Fixes mistaken API rename for -[PSPDFDocument fileURLs]. (#15660)
• Fixed
  Fixes an issue with vector stamp annotations becoming grey when moving or resizing them. (#15345)
• Fixed
  Fixes an issue when closing documents with smart form tab orders. (#15580)
• Fixed
  Fixes an issue where a form field may be rendered more times than necessary. (#15528)
• Fixed
  Fixes an issue where annotation additional actions may not be preserved after a document is saved. (#2185)
• Fixed
  Fixes growing image document after save. (#15479)

7.6.0 - 30 May 2018

See the announcement post.

In preparation for iOS 12, this version of PSPDFKit now drops support for iOS 9. It also requires and is built with Xcode 9.4 (9F1027a). The new Image Documents component, which enables you to keep PSPDFImageDocuments editable even after saving, requires an updated license.

We prepared a migration guide to help you with some of the API changes in this version.

PSPDFKitUI

• Removed
  Deprecates PSPDFDrawLayer related public APIs on PSPDFDrawView. (#14921)
• Added
  Adds -pdfViewController:shouldSaveDocument:withOptions: and -pdfViewController:didSaveDocument:error to PSPDFViewControllerDelegate. (#14910)
• Added
  Adds blend modes to the annotation inspector. The ink highlighter by default now uses a multiply blend mode for clear, black text. (#15080)
• Added
  Adds customization options for PSPDFNoteAnnotationViewController. (#15305)
• Changed
  Improves comment author display in PSPDFCommentCell to accommodate longer author names. (#15065)
• Changed
  Improves layout of the buttons on PSPDFSignatureViewController by making them respect the safe area and dynamic type. (#15063)
• Changed
  Improves state restoration to restore and persist selected annotations. (#14935)
• Changed
  Improves support for Dynamic Type, particularly for larger accessibility sizes. (#14788)
• Changed
  Improves the layout of the stamps grid, to always look reasonably dense, while keeping the stamps big enough to read. (#13675)
• Changed
  Changes the default state of the Store Signature checkbox to be disabled to not store the created signature without users explicitly checking it. (#15250)
• Changed
  Makes selection experience more consistent across platforms. (#14729)
• Changed
  Makes the custom stamp option in the stamps UI more apparent. (#1824)
• Changed
  Moves ‘Saved Annotations’ to its own annotation toolbar item, as opposed to being a tab on the stamps UI. (#1824)
• Changed
  Setting the doNotScroll property on a form text field now works correctly. (#14926)
• Changed
  Sharing with UIActivityViewController now only includes the document, not the title as well. This fixes a Text File being created alongside the PDF when exporting files. (#12782)
• Changed
  The userInterfaceViewMode setting now defaults to .automaticNoFirstLastPage. (#15077)
• Changed
  The behavior of scrollOnTapPageEndEnabled has been changed to be enabled by default again and reacting immediately, without waiting for a potential double tap gesture. The edge span where taps are accepted scrollOnTapPageEndMargin has been reduced to 44 pixels. The default for scrollOnTapPageEndAnimationEnabled has been changed to NO. This allows fast tapping through a document. (#13098)
• Changed
  The home indicator on iPhone X is now automatically hidden when the HUD is not visible. (#15006)
• Changed
  -[PSPDFTextSelectionView sortedGlyphs:] now sorts the passed in glyphs in their reading order. (#15400)
• Changed
  PSPDFConfiguration’s scrollOnTapPageEndMargin and scrollOnTapPageEndAnimationEnabled is now honored when using PSPDFPageTransitionCurl. (#15333)
• Fixed
  Fixes -[PSPDFConfiguration shadowOpacity] not being honored for configurations where the page transition was set to PSPDFPageTransitionScrollPerSpread. (#15369)
• Fixed
  Fixes a crash in that could occur when selecting text if the initial selection did not contain any valid characters. (#15445)
• Fixed
  Fixes a document’s table of contents’ colors not being shown correctly. (#15295)
• Fixed
  Fixes a rare issue that could lead to a crash in PSPDFResizableView layout when rotating rapidly. (#15410)
• Fixed
  Fixes an issue where comments would not scroll out from underneath the keyboard or toolbar on iOS 10 in PSPDFNoteAnnotationViewController. (#15415)
• Fixed
  Fixes an issue where drawing a signature area was not possible when digitally signing a document via the PSPDFPageView signature API. (#14765)
• Fixed
  Fixes an issue where embedded videos with autoplay enabled would start playing before their page was visible. (#14662)
• Fixed
  Fixes an issue where the font size for a form element was calculated wrong. (#15274)
• Fixed
  Fixes an issue where the printing UI wouldn’t prevent interactions with the rest of the application, breaking the printing flow. (#10480)
• Fixed
  Fixes issues with pages not being displayed in page curl mode. (#15280)
• Fixed
  Fixes layout of saved annotations and stamps UI on iPhone X. (#1824)
• Fixed
  Fixes text alignment for text field cells. (#15304)
• Fixed
  Fixes the text insertion point not always staying in the visible area while writing comments on annotations. (#14201)

PSPDFKit

• Changed
  The minimum deployment target is now iOS 10. Support for iOS 9 has been removed. (#14398)
• API
  The configuration builder blocks in PSPDFBaseConfiguration are now noescape for better Swift compatibility. (#15077)
• API
  The constants in PSPDFAnnotationStyleManager have been renamed and now better map to Swift. (#15077)
• API
  PSPDFDocument.annotationsForPageAtIndex:type: is now guaranteed to never return nil. (#15077)
• Removed
  Deprecates PSPDFFileAnnotation’s appearanceName in favor of iconName. (#15319)
• Removed
  Deprecates class-level methods on PSPDFProcessor and introduces new new instance-based API that allows for cancellation. (#10480)
• Added
  Adds the ability to keep annotations on PSPDFImageDocuments editable even after saving. Requires the Image Documents feature to be enabled in your license. See https://pspdfkit.com/blog/2018/image-documents/ for more information. (#14894)
• Added
  Adds an external file source option when adding new pages to a document with the document editor. (V##248)
• Added
  Adds blend modes to Annotations. This improves rendering for appearance steams with different blend modes. (#15080)
• Added
  Adds the ability to define arbitrary patterns for new pages when editing a document. (#14951)
• Added
  Adds the ability to embed files to PSPDFFileAnnotation using -[PSPDFEmbeddedFile initWithFileURL:fileDescription:]. See the new AddFileAnnotationProgrammaticallyExample and AddFileAnnotationWithEmbeddedFile in PSPDFCatalog. (#15210)
• Changed
  Improves JavaScript support, including form formatting, calculation, and validation. (#9501)
• Changed
  Improves XFDF output by omiting opacity if set to the default (1.0). (#15354)
• Changed
  Improves rendering behavior for stamp annotations. Stamps are keeping their aspect ratio on resizing now. Stamps created with PSPDFKit now always use the same rendering, no matter if they were just created or after being saved in the document. The subject of stamps is now always rendered in uppercase characters. Custom stamps are now sized-to-fit before adding them to the document. (#1824)
• Added
  Adds annotation name to Instant JSON. Also renamed pspdfkit/file name to filename to prevent collisions. (#14856)
• Added
  Adds better detection for standard stamp subjects for Instant JSON. (#14919)
• Changed
  Cancelling a PSPDFRenderTask now reduces further CPU usage more effectively. (#14218)
• Changed
  PSPDFPageRenderer is now deprecated and will be removed in a later update. (#15189)
• Fixed
  Fixes a crash which occurred when manually searching a protected document. (#15177)
• Fixed
  Fixes a potential deadlock situation during document cache invalidation. (#15259)
• Fixed
  Fixes an issue where glyph frames were larger than expected due to unexpected values in their fonts. (#14169)
• Fixed
  Fixes an issue where newly created note annotations would require two taps for deselection. (#15221)
• Fixed
  Fixes security vulnerability CVE-2018-9127 in Botan, where wildcard certificates could be accepted for invalid hostnames. (#15374)
• Fixed
  Fixes an issue where some action destinations may not work properly. (#14901)
• Fixed
  Fixes a problem where editing some numeric form fields didn’t show a completely numeric keyboard. (#15484)

Instant

• Added
  Adds support for Instant Layers: https://pspdfkit.com/blog/2018/instant-layers/ (#13834)
• Added
  Adds support for exporting and importing stamp annotations with images for Instant JSON. (#15296)
• Changed
  Improves error reporting regarding invalid JWTs. (Z#8755)
• Removed
  Deprecates all methods in PSPDFInstantClientDelegate in favor of renamed methods to improve API clarity and consistency. (#13834, #15464)
• Removed
  Deprecates PSPDFInstantDocumentDescriptor’s updateAuthenticationToken: and downloadDocumentUsingAuthenticationToken:error: in favor of the more specific reauthenticateWithJWT: and downloadUsingJWT:error:. (#13834)
• Removed
  Deprecates the notifications PSPDFInstantDidUpdateAuthenticationTokenNotification, PSPDFInstantDidFailUpdatingAuthenticationTokenNotification, and related PSPDFInstantAuthenticationTokenKey in favor of the notifications PSPDFInstantDidReauthenticateNotification, PSPDFInstantDidFailReauthenticationNotification, and the related PSPDFInstantJWTKey. (#13834)

Examples

• Added
  Adds a PSPDFCatalog example illustrating how to use a custom bookmark provider. (#15105)
• Changed
  Improves the Catalog’s listing of examples. The Catalog now lists all the examples in the selected language. If an example is not available in the particular language selected, then the example in the other language is listed. (#15100)

7.5.2 - 4 May 2018

PSPDFKitUI

• Fixed
  Fixes an issue where selection would work incorrectly if a page was cropped or rotated. (#15042)
• Fixed
  Fixes the spread zoom not always being reset when scrolling back to a spread in the .scrollPerSpread pageMode. (#14825)

PSPDFKit

• Fixed
  Fixes an issue where glyph frames were incorrectly calculated when the page matrix is not identity. (#13668)

7.5.1 - 25 Apr 2018

PSPDFKitUI

• Added
  Adds a signer subclassing hook to PSPDFSignatureViewController, enabling setting the certificate used for digital signing programmatically. This makes it possible to only allow the user to create a digital signature, instead of an ink signature. (#14846)
• Fixed
  Fixes an issue where a crash could occur if PSPDFNoteAnnotationViewController changed size while it was presenting an action sheet. (#14742)
• Fixed
  Fixes a keyboard avoidance offset issue during interactive keyboard dismissal. (Z#8690)
• Fixed
  Fixes document pages not being selected when the thumbnail was tapped on the bottom half. (#14764)

PSPDFKit

• Changed
  Improves compatibility of note annotations with certain 3rd-party viewers such as Apple Preview. (#14953)
• Changed
  Improves performance when annotations are loaded. (#14983)
• Changed
  Improves the logic when note icon indicators should be rendered. (#14961)
• Changed
  Saving image documents now keeps any additional extended attributes. (#14905)
• Fixed
  Fixes a problem where the text in unsigned form field overlays may be cut off. (#14922)
• Fixed
  Fixes an issue where images could be encoded in the PDF without optimization. (#14916)
• Fixed
  Fixes an issue where recording couldn’t be started for an existing sound annotation. (#15010)

7.5.0 - 11 Apr 2018

PSPDFKitUI

• API
  Adds a textView parameter to -[PSPDFNoteAnnotationViewController updateTextView]. Customize the object passed to updateTextView: instead of using the textView property. (#5721)
• API
  Deprecates PSPDFNoteAnnotationViewController’s allowEditing, beginEditing, showCopyButton, deleteAnnotationActionTitle, deleteAnnotation:, deleteOrClearAnnotationWithoutConfirmation, textView, and borderColor. (#5721)
• API
  Groups PSPDFKitThumbnailViewFilter* constants as extensible string enum. (#14571)
• API
  Removes the tapGesture property on PSPDFNoteAnnotationViewController and the class no longer conforms to UIGestureRecognizerDelegate. (#5721)
• API
  PSPDFPageView is no longer guaranteed to conform to PSPDFNoteAnnotationViewControllerDelegate. (#5721)
• API
  Deprecates shouldBeginEditModeWhenPresented on PSPDFNoteAnnotationViewController, and showNoteControllerForAnnotation:showKeyboard:animated: in favor of showNoteControllerForAnnotation:animated: on PSPDFPageView, as choosing to show the keyboard is now decided based on heuristics, if the user might want to start editing. (#14205)
• Added
  Adds UI to PSPDFNoteAnnotationViewController that enables the user to see existing reviews for a comment, add their own review status, or change their review status. (#14421)
• Added
  Adds document type attribute to document load analytics event. (#14732)
• Added
  Adds showing and adding annotation replies in PSPDFNoteAnnotationViewController. Replies will no longer be shown on the page. (#5721)
• Added
  Adds support for -[PSPDFConfiguration scrollOnTapPageEndEnabled] in page curl layouts. (#13302)
• Changed
  Improves PSPDFPageModeAutomatic behavior in connection with PSPDFPageTransitionScrollContinuous. This now always prefers single pages to take better use of the available screen real estate. (#14822)
• Changed
  Improves the layout of the search view controller on devices with bottom safe area insets. (#12969)
• Changed
  Improves type safety by removing the __kindof type annotation from -[PSPDFDrawView annotations], -[PSPDFPageView passthroughViewsForPopoverController], and -[PSPDFPageView selectedAnnotations]. This only affects Objective-C. (#14490)
• Changed
  Changing page by tapping on page edges is now disabled by default. To enable this, change PSPDFConfiguration.scrollOnTapPageEndEnabled to YES. (#14418)
• Changed
  Ensures that PSPDFAnalyticsEventNameAnnotationCreationModeExit is always logged. (#14839)
• Changed
  Ensures that the optional analytics provider tracks log deletion for all cases. (#14817)
• Removed
  Removes ellipses in menu items (UIMenuItem) because there is no standard convention for this on iOS and space can be scarce. For example ‘Inspector…’ is now ‘Inspector’. (#14235)
• Fixed
  Fixes an issue that could result in a crash when the size class changes while in a page curl layout. (#14555)
• Fixed
  Fixes an issue that makes the page curl left or right align pages even though it is in single page mode. (#14555)
• Fixed
  Fixes an issue that triggered a page change animation in page curl in some cases even though the page was already visible. (#14528)
• Fixed
  Fixes an issue where PSPDFPageView would display a wrong page in rare occasions. (#14442)
• Fixed
  Fixes an issue where annotations with the Invisible, Hidden, or NoView flags set could be tappable. (#14772)
• Fixed
  Fixes an issue where pages were not animating into place when showing or hiding the inspector. (#13627)
• Fixed
  Fixes an issue where paginated layouts would drift by a fraction of a point with every page if PSPDFViewController is set to a non-integer size in the direction of scrolling. (#14543)
• Fixed
  Fixes annotations shown as overlays (notes) not respecting the Invisible, Hidden, and NoView flags. (#5721)

PSPDFKit

• API
  Deprecates PSPDFAnnotationOptionUserCreatedKey. (#14669)
• API
  Renames PSPDFSignatureHashAlgorithmSHA386 to PSPDFSignatureHashAlgorithmSHA384 which is actually the correct name. (#13932)
• API
  tryLoadAnnotationsFromFileWithError: has been removed from PSPDFFileAnnotationProvider. Use loadAnnotationsWithError: instead to customize annotation loading. (#14570)
• API
  Deprecates PSPDFTextBlock.glyphs, PSPDFWord.glyphs, and PSPDFSelectionState.selectedGlyphs in favor of NSRange-based APIs. (#14606)
• API
  Adds isGenerated to PSPDFGlyph to check if the glyph is an autogenerated filler. (#14606)
• API
  PSPDFGlyph.indexOnPage is not -1 to indicate that it is a generated filler. Use PSPDFGlyph.isGenerated instead. indexOnPage can now be used to uniquely identify a glyph on a page, and is the index of the glyph in the PSPDFTextParser.glyphs array. (#14606)
• Added
  Adds createdAt, updatedAt and creatorName to Instant JSON. (#14443)
• Added
  Adds isReply and inReplyToAnnotation properties on PSPDFAnnotation. (#5721)
• Added
  Adds properties for author-specific state on PSPDFNoteAnnotation. (#5721)
• Changed
  Improves cleaning up resources in PSPDFDocument’s dealloc. (#14586)
• Changed
  Improves performance when examining document permission features. (#14747)
• Changed
  Improves text selection performance in documents with a lot of text. (#14516)
• Changed
  Filters out invalid characters from a page’s text. (#14516)
• Changed
  Performance improvements for documents with many data sources. (#14651)
• Changed
  Removing an annotation with removeAnnotations:options: on PSPDFAnnotationManager or PSPDFDocument now also removes replies to that annotation. (#14385)
• Changed
  The relationship between PSPDFXFDFAnnotationProvider and PSPDFFileAnnotationProvider is now more explicit. If you use XFDF for form filling, you now need to keep around both providers. Furthermore, the annotation manager now only saves into the first annotation provider implementing the save method. Previously all were called, which could have led to incorrect results. (#14323)
• Fixed
  Fixes a crash that could happen during application termination. (#14483)
• Fixed
  Fixes a lock inversion when setting up the document providers. (#14525)
• Fixed
  Fixes a potential crash when saving a document. (#14082)
• Fixed
  Fixes a potential issue when removing annotations. (#14381)
• Fixed
  Fixes an issue that prevented correct caching of rendered pages. (#14390)
• Fixed
  Fixes an issue where -[PSPDFTextParser textWithGlyphs:] would exclude the last glyph. (#14636)
• Fixed
  Fixes an issue where a flattened document shows a blank page in Preview. (#13708)
• Fixed
  Fixes an issue where action destinations would not be found if sorted incorrectly. (#14412)
• Fixed
  Fixes an issue where document checkpoints were not loaded for decoded document instances. (#14624)
• Fixed
  Fixes an issue where image data wasn’t properly removed after rewriting the PDF. (#14708)
• Fixed
  Fixes an issue where searching for text in a document would return results with empty text blocks. (#14516)
• Fixed
  Fixes an issue where some PSPDFDocumentSecurityOptions initializers would sometimes return nil. (#14646)
• Fixed
  Fixes an issue where the documents features sometimes returned an incorrect value when called right after creating a PSPDFDocument. (#14574)
• Fixed
  Fixes an issue where using a custom bookmark provider with readonly documents disabled adding and editing bookmarks. (#14574)
• Fixed
  Fixes animated GIF images support in the gallery. (#13897)
• Fixed
  Fixes document corruption issue when document has a header and is incrementally saved. (#14249)
• Fixed
  Fixes pages not being centered when zooming is disabled in landscape. (#14091)

Instant

• Changed
  Improves type safety by removing the __kindof type annotation from -[PSPDFInstantDocumentDescriptor annotationWithIdentifier:forDocument:error:]. This only affects Objective-C. (#14490)

Examples

• Added
  Adds PSPDFCatalog example illustrating how to rotate pages in 90 degree steps. (#14445)
• Added
  Adds a PSPDFCatalog example illustrating how to add a custom filter by subclassing PSPDFThumbnailViewController. (#14380)
• Fixed
  Fixes Catalog “XFDF Annotation Provider, Encrypted” example. (#13912)
• Fixed
  Fixes an issue where the Document Editor icon was not visible in NewPageFromDocumentExample.swift and ProgrammaticDocumentEditingExample.swift. (#14641)

7.4.1 - 19 Mar 2018

PSPDFKitUI

• Fixed
  Fixes an issue where enabling link annotation editing would not work. (#14477)
• Fixed
  Fixes an issue where pages had a gap between them in page curl layout. (#13329)

PSPDFKit

• Added
  Adds PSPDFAESCryptoDataSink. (#13912)
• Fixed
  Fixes an issue where the deletion of an annotation could not be undone properly. Important: Calling removeAnnotations:options: on a PSPDFFileAnnotationProvider no longer posts PSPDFAnnotationChangedNotification! Deleted annotations are still being returned from dirtyAnnotations until the next save — like before. They are, however, not returned from annotationsForPageAtIndex: anymore. This behavior is also far less surprising. (#14305)
• Fixed
  Fixes a document corruption bug when the document has a header and is incrementally saved. (#14249)
• Fixed
  Fixes Catalog “XFDF Annotation Provider, Encrypted” example. (#13912)
• Fixed
  Fixes an animation glitch when rearrange pages with the document editor. (#14367)
• Fixed
  Fixes an issue where PSPDFTextParser.glyphs could be incorrect for certain documents. (#10844)
• Fixed
  Fixes an issue where dropdown arrow on combo boxes are not seen when box has a small width. (#14326)
• Fixed
  Fixes an issue where dropdown arrows are still seen on combo boxes when document is flattened. (#9539)
• Fixed
  Fixes issue where pdfId was required when importing a Instant JSON document. (#14494)
• Fixed
  Fixes potential deadlocks during annotation rendering. (#14534)
• Fixed
  Fixes an issue where opening large documents with marked content used very large amounts of memory. (#14415)
• Fixed
  Fixes potential deadlocks when opening a lot of documents. (#14503)
• Fixed
  Fixes an issue where PSPDFFile.fileData did not lazily memory map the file data when being called from user code. (#14539)

7.4.0 - 2 Mar 2018

See the announcement post.

PSPDFKitUI

• API
  Replaces firstLineRect, lastLineRect, and innerRect properties of PSPDFTextSelectionView with rectForFirstBlock, rectForLastBlock, and selectionRects. (#9677)
• Added
  Adds a PSPDFCatalog example illustrating how to create a form programmatically. (#14215)
• Added
  Adds a PSPDFCatalog example illustrating how to use the Instant JSON Annotation and Document APIs. (#14087)
• Added
  Adds an overlay message shown when digitally signing a document without a form field. (#13583)
• Added
  Adds support for selecting vertical text. (#322)
• Changed
  Improves compatibility with the React Native view component. (#14222)
• Changed
  Improves performance by only creating the text selection view’s text parser when required. (#14291)
• Changed
  Improves performance when sharing file-based documents via the Open In activity. (#14011)
• Changed
  Improves visualization of thumbnails, especially when filtering for bookmarked or annotated pages. (#12512)
• Changed
  Improves text selection using PSPDFTextSelectionView by selecting text in distinct blocks. (#322, #9677)
• Changed
  Improves performance when editing free text annotations. (#13971)
• Changed
  Improves scrolling and zooming performance. (#13971)
• Changed
  Changes the inspector to use the annotation type as the title instead of Style. (#14057)
• Changed
  Tapping to select an annotation in multi-select mode now works again. (#11432)
• Fixed
  Fixes a crash that happened when adding stamp annotations with 3rd party stylus support enabled. (#14086)
• Fixed
  Fixes an issue where annotation notes were not editable on iPhone with iOS 9. (#14323)
• Fixed
  Fixes an issue where bookmarks could be created but not saved into a document. (#9107)
• Fixed
  Fixes an issue where content insets were not respected in searchable choice form elements while searching. (#13987)
• Fixed
  Fixes an issue where switching between documents with different page bindings didn’t update the scroll direction correctly. (#13849)

PSPDFKit

• API
  -[PSPDFContainerAnnotationProvider clearNeedsSaveFlag] now asserts that it is called inside a write block! For more details, please refer to the documentation of PSPDFContainerAnnotationProvider(SubclassingHooks). (#14181)
• API
  Certain types in Swift have been renamed to improve interoperability. (#10491)
• API
  Deprecates encryptionAlgorithm in PSPDFPrivateKey, in favor of signatureEncryptionAlgorithm, which is enum-typed. (#13940)
• API
  PSPDFDocumentSecurityOptions initializers may return error instead of assert. (#10491)
• Added
  Adds PSPDFDocumentFeatures as a central place for checking the availability of various features. (#9107)
• Added
  Adds a PSPDFCatalog example illustrating how to generate a PDF document on a mobile device without any server use. (#13776)
• Added
  Adds a new protocol, PSPDFExternalSignature, that can be used to provide a digital signature for a document externally. (#13940)
• Added
  Adds an example UpdateConfigurationWhenRotatingExample.swift for changing the configuration when rotating the device. (#13820)
• Added
  Adds support for automatic access tracking for security scoped URLs. (#13863)
• Added
  Adds the shouldTrackDeletions class property to PSPDFContainerAnnotationProvider to customize the effect of removeAnnotations:options: on dirtyAnnotations. See PSPDFContainerAnnotationProvider.h for more information. (#8839)
• Changed
  Adjusts the gap between two pages in continuous scroll mode. (#13877)
• Changed
  Changes the localized description of empty note annotations from Text to Note (localized). (#14057)
• Changed
  Improve error messages when digitally signing a document failed. (#13741)
• Changed
  Shows an error message when digitally signing failed instead of throwing an exception in some cases. (#13741)
• Changed
  PSPDFTextParser now respects reading order of text blocks defined in the PDF using Marked Content. (#9677, #322)
• Fixed
  Fixes FTS5 search on SQLite versions >= 3.20.0. (#14036)
• Fixed
  Fixes a deadlock when calling removeAllAnnotationsWithOptions: on an instance of PSPDFContainerViewController or a subclass and clarifies locking requirements. (#14178)
• Fixed
  Fixes an assertion when a non-specified named action was deserialized via Instant JSON. (#13804)
• Fixed
  Fixes an issue saving a document with invalid PDF syntax (empty dictionary key). (#14009)
• Fixed
  Fixes an issue where -[PSPDFAnnotation annotationFromInstantJSON:documentProvider:error:] attached the annotation to the document. (#14140)
• Fixed
  Fixes an issue where some annotations in a custom annotation provider were not rendered properly. (#12762)
• Fixed
  Fixes an issue where some form fields with custom FQNs may not be signed correctly. (#14309)
• Fixed
  Fixes an issue where the hash of two equal PSPDFAnnotation objects could be different. (#13852)
• Fixed
  Fixes an issue where the wrong font was selected. (#14027)
• Fixed
  Fixes crashes on document unload when FormTabOrderCalculator is being processed. (#13976)
• Fixed
  Fixes issue with text selection in certain cases. (#13803)
• Fixed
  Fixes potential crash when saving files with irregular outlines. (#14116)
• Fixed
  Fixes the issue where PSPDFDocument.hasDirtyAnnotations would return NO after removing an annotation from a custom annotation provider. (#8839, Z#5114)

Instant

• Added
  Adds PSPDFInstantErrorInvalidURL and stricter validation of the server URL to PSPDFInstantClient’s initializer. (#14158)
• Changed
  Improves recovery from network failures during sync by monitoring reachability of the Instant server. (#11901, Z#7385)

7.3.1 - 26 Jan 2018

PSPDFKitUI

• Added
  Adds the ability to undo clear actions while editing free text annotations. (#13828)
• Changed
  Improves touch handling for the scrollable thumbnail bar mode for documents with only a few pages. (#13861)
• Fixed
  Fixes a crash that occur if shake to undo is invoked during free text editing. (#13829)
• Fixed
  Fixes an issue where presented annotations toolbar was not updated after changing controller’s PSPDFConfiguration. (#13858)
• Fixed
  Fixes an issue where tapping a free text annotation while selected doesn’t start editing on 3D Touch compatible devices, or when using Apple Pencil. (#11424)
• Fixed
  Fixes an issue where the displayed page labels were incorrect when switching layouts right after initialization. (#13824)
• Fixed
  Fixes an issue which switching to the correct page when rotating from a double to a single page mode. (#13887)
• Fixed
  Fixes an issue with restoring the view state when rotating while in a page curl layout. (#13823)
• Fixed
  Fixes missing search bar in the outline and annotation list on iOS 11, if the corresponding view controllers were presented without being wrapped in a navigation controller. (Z#7994)
• Fixed
  Fixes the last stroke drawn in an ink annotation with opacity below 100% appearing too dark until the annotation is deselected. (#13895)
• Fixed
  Fixes overrideClass:withClass: in the configuration not working with PSPDFPageView. (#13881)
• Removed
  Removes the PSCUpdateConfigurationWithoutReloadingExample example, which was using outdated API. (#13801)

PSPDFKit

• Added
  Adds a allowedPathExtensions property to PSPDFLibraryFileSystemDataSource to configure the types of files it returns for indexing. (#13967)
• Fixed
  Fixes an issue where checkbox values were not updated correctly. (#13843)
• Fixed
  Fixes an issue where digitally signing a document multiple times may invalidate previous signatures. (#13582)

Instant

• Changed
  Improves the Instant Catalog example to support 7 letter codes. (#13858)

7.3.0 - 12 Jan 2018

See the announcement post.

PSPDFKitUI

• API
  Introduces -[PSPDFDocumentEditorDelegate documentEditorRequestsFullReload:], which requests a full document editor UI reload. (#13168)
• API
  Replaces policy event strings on PSPDFApplicationPolicy with an extensible enum. (#13722)
• API
  Adds +[PSPDFImagePickerController availableImagePickerSourceTypes] to allow specifying the source types of a PSPDFImagePickerController subclass. See CustomImagePickerControllerExample in PSPDFCatalog for details. (#13724)
• Added
  Adds a PSPDFCatalog example illustrating how to go to a specific outline programmatically. (#13166)
• Added
  Adds a PSPDFCatalog example illustrating how to customize page labels. (#13343)
• Added
  Adds a PSPDFCatalog example of how to monitor for touch events. (#13706)
• Added
  Adds a new signatureIntegrityStatus to PSPDFSignatureStatus, which shows if the document has been modified in a way that has broken a digital signature. (#13570)
• Added
  Adds a PSPDFConfiguration preset for easy configuration of PDF controllers showing image documents. (#13538)
• Changed
  Improves detection of the page focused by the user when rotating. (#12558)
• Changed
  Improves text selection behavior. It’s now possible to start selecting and marking up text in one direction and then switch to the opposite direction in a single gesture. (#11415)
• Changed
  Improves the PSPDFDocumentPickerController documentation. (#8417)
• Changed
  Improves support for document editing inside the tabbed view controller. (#13168)
• Changed
  Improves performance of the annotation list view controller. (#13546)
• Changed
  Improves saving when the application is backgrounded or terminated. (#13586)
• Changed
  Improves support when embedding multiple PSPDFViewController instances into a UIPageViewController instance. (#13702)
• Changed
  Improves text markup selection behavior when starting a selection outside of text and moving over text afterwards. (#11937)
• Changed
  Improves the coloring of the filter segmented control at the top of the thumbnails view. It now has higher contrast against light backgrounds and uses the tint color if it provides sufficient contrast. (V#1369)
• Changed
  Improves the accuracy of the information about the digital signature validation process by demoting some non-critical errors to warnings. (#13570)
• Changed
  Improves the page grabber layout in various configurations. (#13465)
• Changed
  Improves the annotation toolbar layout when using the page grabber or a vertical scrubber bar. (#13465)
• Changed
  Improves the sound annotation player layout when using a vertical scrubber bar on iPhone X. (#13465)
• Changed
  Improves language detection for text to speech. (#8939)
• Changed
  Hide the annotation section in PSPDFDocumentSharingViewController for documents which do not have annotations. (#13179)
• Changed
  The showsScrollIndicator properties on PSPDFDocumentView and PSPDFDocumentViewController now default to NO in scroll per spread mode. (#13506)
• Fixed
  Fixes an issue where the scrubber bar was unable to switch to the first or last page in some documents. (#13258)
• Fixed
  Fixes an issue where an assert could be triggered when replacing a file while it is being displayed. (#13362)
• Fixed
  Fixes an issue with the page view label formatter where the custom formatter was not used. (#13343)
• Fixed
  Fixes an issue where rotating from double to single page spreads leads to the wrong page when editing a note annotation. (#9524)
• Fixed
  Fixes an issue with transparent background on list of open documents. (V#1345)
• Fixed
  Fixes an issue where draw annotation tools were not properly reselected after changing layouts or rotating the device. (#12907)
• Fixed
  Fixes an issue where read-only signed digital signatures may not be tappable. (#13573)
• Fixed
  Fixes unnecessary document saves triggered by loading certain annotation types. (#13734)
• Fixed
  Fixes an issue where embedded file preview was missing the close button when useParentNavigationBar was set to YES. (#13699)
• Fixed
  Fixes a potential crash which could occur when setting a custom PSPDFApplicationPolicy in +[PSPDFKit setLicenseKey: options:]. (#13725)
• Fixed
  Fixes an issue where PDFs with corrupted pages where not rendered at all in certain layout configurations. (#13720)
• Fixed
  Fixes an issue where pages with different sizes were positioned incorrectly in thumbnail mode on devices with 3x screens. (#13693)
• Fixed
  Fixes an issue where some list boxes do not display all the possible options. (#13454)
• Fixed
  Fixes an issue where in some view hierarchies the page size was only using the visible screen space instead of the size of the view. (#13579)
• Fixed
  Fixes an issue where the content is offset when scrolling backwards. (#13551)
• Fixed
  Fixes an issue with continuous scrolling layouts that have fillAlongsideTransverseAxis disabled. (#13688)

PSPDFKit

• API
  Deprecates the baseURL property from PSPDFFileDataProvider. (#12525)
• API
  Deprecates baseURL-based PSPDFFileDataProvider initializers. (#12525)
• Added
  Adds PSPDFImageDocument for simple annotating of image files using PSPDFKit. (#13538)
• Added
  Adds form field values to Instant JSON. (#13335)
• Added
  Adds a new log level (PSPDFLogLevelCritical), that is enabled by default. (#13212)
• Added
  Adds support for PEM-encoded certificates in PKCS#7 files. (#13698)
• Changed
  Improves file coordination update notifications, by ignoring cases that do not represent content changes. (#13394)
• Changed
  Improves the detection of digital signatures in third-party PDF readers. (#13593)
• Changed
  Improves the stability of the digital signing process with some certificate authorities with missing fields. (#13694)
• Changed
  Improves locking during document cache reset. (#10984)
• Fixed
  Fixes an issue where zooming in on large free text annotations, stamps, or form fields could use a lot of memory, which could result in crashing. (#13685, #13686)
• Fixed
  Fixes missed search terms which span over a newline without a hyphen. (#11862)
• Fixed
  Fixes an issue with stamp annotations not being rendered when using XFDF. (#13330)
• Fixed
  Fixes an issue with sound annotations losing sound data when using XFDF. (#13324)
• Fixed
  Fixes specific issue where previous xref has the same object number as a newly created object. (#13183)
• Fixed
  Fixes an issue where PSPDFGalleryManifest could override a link annotation’s url in some cases. (V#1084)
• Fixed
  Fixes an issue where image stamp annotations appeared scaled up. (#13703)
• Fixed
  Fixes a problem where signed documents loaded using a data provider may incorrectly warn about changes when validated. (#13549)
• Fixed
  Fixes file coordination issues that could occur while the application is backgrounded. (#13652)
• Fixed
  Fixes an issue where a signed document may show a warning if inspected with a PDF lint tool. (#13719)
• Fixed
  Fixes an issue where PSPDFFile could in some cases return stale data for a file. (#13614)
• Fixed
  Fixes an issue where the opacity was not applied to the callout of a PSPDFFreeTextAnnotation. (#13576)
• Fixed
  Fixes an issue where some annotation widgets’ appearance streams were not updated properly when the underlying form field’s value changed. (#13344)
• Fixed
  Fixes highlight markups on some specficic documents (#13768)

Instant

• API
  Deprecates -[PSPDFInstantClient initWithServerURL:] which crashes when data cannot be read from or written to disk. This is a breaking change if you use Swift. (#13365)
• Added
  Adds -[PSPDFInstantClient initWithServerURL:error:] as the designated initializer. This allows failing gracefully when data cannot be read from/written to disk. (#13365)
• Added
  Adds PSPDFInstantDocumentState describing the possible states that a PSPDFInstantDocumentDescriptor can be in. Notifications are posted for relevant state transitions, providing significantly better feedback about a document’s sync cycle. (#11324)
• Added
  Adds API to stop a running sync cycle and improves discoverability and accuracy of documentation. (#13247)
• Fixed
  Fixes an issue where some annotations created with default properties were not synced. (#13348)
• Fixed
  Fixes a memory leak related to sync requests. (#13540)
• Fixed
  Fixes a dangling pointer issue when parsing invalid server responses. (#13557)

7.2.1 - 14 Dec 2017

PSPDFKit now requires and is built with Xcode 9.2 (9C40b).

PSPDFKitUI

• Changed
  Update the sound annotation playback toolbar view while scrolling is active. (#13274)
• Changed
  Improves positioning of form elements during editing. (#13208)
• Fixed
  Fixes a problem where some text in form fields may be cut off. (#13242)
• Fixed
  Fixes an issue where draw and selection views where not recreated when changing the page or the page transition. (#12907)
• Fixed
  Fixes an issue where the scrubber bar didn’t lay out correctly when switching documents. (#13215)
• Fixed
  Fixes an issue where an assert could be triggered while zooming. (#13403)
• Fixed
  Fixes a potential crash during scroll view observing. (Z#7695)
• Fixed
  Fixes a memory leak in the signature view controller. (#13463)
• Fixed
  Fixes ink, shape, and line annotations not being rendered correctly if they were selected while the view changes size. (#13520)
• Fixed
  Fixes an issue where an assert could be triggered while setting an empty viewport to a document view layout. (Z#7763)

PSPDFKit

• Changed
  Improves performance when fetching document level JavaScript objects. (#13281)
• Fixed
  Fixes an issue where an ink annotation’s background (fill color) was incorrectly ignored. (#13216)
• Fixed
  Fixes an issue where documents with links may not point to the correct destination after being exported. (#13341)
• Fixed
  Fixes missed search terms which span over a newline without a hyphen. (#11862)
• Fixed
  Fixes an issue with stamp annotations not being rendered when using XFDF. (#13330)
• Fixed
  Fixes an issue with sound annotations losing sound data when using XFDF. (#13324)
• Fixed
  Fixes incorrect glyph frames being returned from PSPDFTextParser for documents with vertical or rotated text. (#13423)
• Fixed
  Fixes some crashes when undoing and redoing operations. (#12358)
• Fixed
  Fixes a crash in PSPDFFileAnnotationProvider when the document has not been initialized properly. (#12358)
• Fixed
  Fixes some crashes in PDFResourceProvider caused by a race condition. (#13413)
• Fixed
  Fixes potential crashes when some classes are deallocating. (#13421)

Instant

• Added
  Adds a PSPDFCatalog example that uses Instant to load documents from our public preview server and demonstrates real-time annotation synchronization. (#11968)
• Fixed
  Fixes annotation positioning when created on a page with a transform. (#12492)

7.2.0 - 23 Nov 2017

PSPDFKitUI

• Changed
  Improves page grabber user experience when scrolling documents with various sized pages. (#11642)
• Changed
  No longer shows status HUD while opening a document in another app since this is usually fast. (#13209)
• Fixed
  Fixes an issue where the page grabber was not able to scroll all the way to the top or the bottom of a document in some view configurations. (#11642)
• Fixed
  Fixes an issue that could lead to a crash when switching between documents with different page numbers in a tabbed bar view controller. (#12513)
• Fixed
  Fixes a crash when snapshotting a page view in a page curl layout before the view was rendered for the first time. (V#1282)
• Fixed
  Fixes a crash when scrolling and zooming to a page when already zoomed in. (#13225)

PSPDFKit

• API
  Deprecates PSPDFJSONSerializing in favor of Instant JSON (See PSPDFAnnotation+Instant.h). (#10516)
• Added
  Adds Instant JSON support to PSPDFDocument and PSPDFAnnotation. (#10516)
• Fixed
  Fixes a rare text extraction issue where some space characters are not correctly extracted. (#6273)
• Fixed
  Fixes an issue where stamp annotations get blurry. (#12981)

Instant

Important: This release requires PSPDFKit Server 2017.8 for syncing. If you try to connect to an older version of the server, syncing will fail. For further information, please refer to the migration guide.

• Added
  Adds identifierForAnnotation:error: and annotationWithIdentifier:forDocument:error to PSPDFInstantDocumentDescriptor. These APIs provide a stable, unique identifier for annotations managed by Instant. The identifiers are well suited to, for example, associate arbitrary data from external sources with an annotation. (#11682)

7.1.0 - 17 Nov 2017

See the announcement post.

PSPDFKitUI

• API
  Replaces PSPDFAnnotationIgnoreNoteIndicatorIconKey in favor of PSPDFAnnotation.shouldDrawNoteIconIfNeeded. (#12687)
• API
  Adopts NS_ERROR_ENUM for error codes. This is source compatible for Objective-C but might require small adjustments in Swift code. (#13023)
• API
  The delegate of the scroll views returned in documentViewController:configureScrollView: and documentViewController:configureZoomView:forSpreadAtIndex: can now be set. (#13013)
• API
  Adds an NSError parameter to the completion handler of -[PSPDFPageCellImageLoading requestImageForPageAtIndex:availableSize:completionHandler:]. (#11499)
• Added
  Adds UI controls and model level APIs for copy and paste operations on the document editor. (#11972)
• Added
  Adds PSPDFCatalog example illustrating how to switch between double and single page mode without reloading. (#12880)
• Added
  Adds PSPDFDrawCreateModeAutomatic as the new default drawCreateMode used by PSPDFDrawView. This intelligently splits drawing into multiple ink annotations. This is especially beneficial when using Apple Pencil. (#9222)
• Added
  Adds value PSPDFSignatureInputMethodMouse to PSPDFSignatureInputMethod enum which is used when the digital signature was created with a mouse. (#12865)
• Added
  Adds PSPDFCatalog example illustrating how to programmatically add transparent stamp annotations. (#13075)
• Added
  Adds finer grained scrolling API, applicable for continuous scrolling mode. See -[PSPDFDocumentViewController scrollToSpreadAtIndex:scrollPosition:animated:] for details. (#12586)
• Added
  Adds labelFormatter property to PSPDFPageLabelView to customize page label. (#13003)
• Added
  Adds useDiskCache to PSPDFDataProviding and PSPDFDocument to configure using the disk cache on a per-document level. (#11815)
• Added
  Adds PSPDFCatalog examples illustrating how to add vector stamp annotations. (#13075, #13076, #13080)
• Changed
  Improves performance of drawing ink annotations, which is especially noticeable when using Apple Pencil. (#9222)
• Changed
  Improves handling of rendering errors in the thumbnails view. (#11499)
• Changed
  Improves displaying of the icon for annotations that have a note attached. (#12555)
• Changed
  Improves content insets and prevents the user from zooming into the areas outside a spread. (#12268)
• Changed
  Improves scroll indicator insets on iPhone X. (#12755)
• Changed
  Improves document layout on iPhone X. (#12753)
• Changed
  Improves system edge gestures handling with visible annotation toolbar. (#12837)
• Changed
  Improves usage of quantity strings (plurals). (#13039)
• Changed
  Improves scroll behavior in continuous scroll mode when zoomed in. (#13084)
• Changed
  Improves initial positioning in vertical continuous mode. (#12777)
• Changed
  Improves content offset behavior during user interface fadein in vertical continuous mode. (#12777)
• Changed
  Improves default color presets, so they better fill the space on iPhone X and 12.9” iPad. (#13117)
• Changed
  Newly added pages via the Document Editor will be added at the end of the document. (#12533)
• Changed
  Setting scrollEnabled, alwaysBounce, or showsScrollIndicator on PSPDFDocumentViewController doesn’t reload the view hierarchy anymore. (#13089)
• Changed
  Link highlights are no longer shown for full page annotations. (#13163)
• Fixed
  Fixes issue with the invisible filters in document editor on iOS 11. (#12730)
• Fixed
  Fixes issue with annotation toolbar not being able to attach to the top in nested navigation controllers setup. (#12821)
• Fixed
  Fixes the thumbnails view not updating on annotation changes when a filter is applied. (#11637)
• Fixed
  Fixes issues where the content insets for document views were not properly calculated. (#12808)
• Fixed
  Fixes issue where text in form fields are always black. (#12449)
• Fixed
  Fixes a crash when rotating from double page spreads in landscape to single page spreads in portrait. (#12983)
• Fixed
  Fixes a crash when using additionalScrollViewFrameInsets in continuous scrolling layouts. (#13079)
• Fixed
  Fixes a regression that caused pages to be slightly zoomed in after rotation. (#12825)
• Fixed
  Fixes issue where the navigation bar did not fade out with the user interface on iOS 10. (#12912)
• Fixed
  Fixes it not being possible to scroll to the bottom of the color presets in some view sizes such as on a 4” iPhone in landscape. (#13096)
• Fixed
  Fixes an issue where scrolling when zoomed in continuous scroll mode would be jumpy. (#12454)
• Fixed
  Fixes an issue where spreads larger than the viewport size would start in the center. (#12852)
• Fixed
  Fixes an issue where scrolling with the page grabber could cause the page to shift when zoomed in. (#12985)
• Fixed
  Fixes actions not being executed for full page annotations. (#13163)
• Fixed
  Fixes an issue where the annotation toolbar could show only a subset of buttons after inserting a signature on iPhone. (#13106)
• Fixed
  Fixes an issue where the status bar was incorrectly shown or hidden on iPhone, when a PDF controller was re-shown in a different orientation. (#13077)
• Fixed
  Fixes an issue where a spread view could not be found when restoring view states which led to an assertion. (V#1261)
• Fixed
  Fixes a rare crash that could occur during rotation in page curl mode. (#12877)
• Fixed
  Fixes an issue when applying additional scroll view frame insets to a scroll per spread layout. (#12734)

PSPDFKit

• API
  Deprecates PSPDFAnnotationTriggerEventLooseFocus in favor of PSPDFAnnotationTriggerEventLoseFocus. (#13078)
• Changed
  Improves detection of RichMedia elements and always prefers to show controls for audio-only tracks. (#12986)
• Changed
  Improves the performance of document outline parsing when the document is very big. (#11854)
• Fixed
  Fixes the positioning of the underline on text when no ascending characters are present on the line. (#11489)
• Fixed
  Fixes a problem where some PDF documents may not show every form field element. (#12998)
• Fixed
  Fixes an rare crash in PSPDFLibraryFileSystemDataSource due to mutation of a set while enumerating it. (#12987)
• Fixed
  Fixes a potential issue when trying to interact with a form whilst a PSPDFProcessor is in progress. (#12973)
• Fixed
  Fixes an issue where some highlight annotations were rendered incorrectly in specific PDFs. (#12937)
• Fixed
  Fixes missing document link action when destination is not defined. (#12917)
• Fixed
  Fixes a potential issue when trying to interact with a form whilst a PSPDFProcessor is in progress (#12973)

Instant

Important: This is the last release of Instant compatible with PSPDFKit Server 2017.7 and earlier. The next release will require 2017.8. This release adds showing an alert informing users that they need to update your app if the server version is too new. You should update your app with this version of Instant as soon as possible so once you update the server to 2017.8 users are informed of why document downloading and syncing does not work and how to fix it. For further information, please refer to the migration guide.

• Added
  Adds showing the user an alert if the Instant framework version is too old to connect to the server. This can be disabled with the new shouldShowCriticalErrors property on PSPDFInstantViewController. (#12870)
• Added
  Adds error codes for the cases where the client and server have incompatible versions: PSPDFInstantErrorOldClient and PSPDFInstantErrorOldServer. (#12720)
• Fixed
  Fixes PSPDFInstantSyncingLocalChangesDisabled symbol not being exported. (Z#7443)
• Fixed
  Fixes an issue that could lead to a failed assertion when adding annotations while there were unsynced changes. (#13122, Z#7442)

7.0.3 - 26 Oct 2017

• Added
  Adds CocoaPods dSYM support for all frameworks to improve crash report symbolication. (#11666)

PSPDFKitUI

• Changed
  Improves note view controller insets on iPhone X. (#12816)
• Changed
  Improves thumbnail sizing in the document editor on iPhone X. (#12815)
• Changed
  Improves the search controller layout on iPhone X. (Z#7121)
• Fixed
  Fixes issues with the fullscreen gallery layout on iPhone X. (#12731)
• Fixed
  Fixes a regression that prevented searching for fonts in PSPDFFontPickerViewController. (#12831)
• Fixed
  Fixes an issue with the annotation toolbar not respecting the safe area in the top position. (#12833)
• Fixed
  Fixes the sound annotation player layout if a bottom toolbar is shown. (Z#7266)
• Fixed
  Fixes an issue where modally presented PSPDFTabbedViewController wasn’t displaying the close button. (#12811)
• Fixed
  Fixes a crash that could occur in continuous mode, if scrolling was still ongoing while the PDF controller was being dismissed. (V#1250)
• Fixed
  Fixes an issue that scrolled to the wrong offset when calling setContinuousSpreadIndex: on a zoomed in document with layout that has spreadBasedZooming disabled. (#12788, V#1253)
• Fixed
  Fixes it not being possible to create some annotation types after changing pages while the tool is being used, typically while using Apple Pencil. (#12744)
• Fixed
  Fixes ‘Open In’ not correctly working on iOS 10 and 9. (#12829)
• Fixed
  Fixes the color picker layout on iPhone X. (#12854)
• Fixed
  Fixes zooming to a search result making it fill the entire screen. (#12441)
• Fixed
  Fixes PSPDFConfiguration.searchResultZoomScale not being respected. Changes default to specify automatic zoom scale. (#12675)
• Fixed
  Fixes the thumbnails view sometimes not scrolling or not showing some pages if the document’s first page has a different aspect ratio to other pages. (V#1219)
• Fixed
  Fixes blurry text fields when zoomed into a form. (#12661)
• Fixed
  Fixes an issue when PSPDFKit is used in projects that do not use ARC. (#12892)

PSPDFKit

• Added
  Adds support for transferring document level JavaScript when processing a document (#12769)
• Fixed
  Fixes an issue with file size when flattening annotations. (#12749)
• Fixed
  Fixes an issue in the bookkeeping of spread views which resulted in an assertion when looking for a specific page view. (#12654)
• Fixed
  Fixes an issue where PSPDFProcessor didn’t export some annotations in particular documents. (#11795)
• Fixed
  Fixes an issue when saving a document that has been restored from a checkpoint. (#12890)
• Fixed
  Fixes an issue with incorrect tab order in forms. (#12902)
• Fixed
  Fixes an issue where some flattened documents may not show correctly in third party readers. (#12901)
• Fixed
  Fixes an issue where actions weren’t properly persisted. (#12884)
• Fixed
  Fixes an issue when exporting XFDF with non-ascii characters. (#12892)
• Fixed
  Fixes an issue when the appearance stream of form elements was not correctly reset when applying XFDF values. (#12892)