2017.7 Migration Guide

PSPDFKit for Web 2017.7 adds support for horizontal scaling, externally managed documents, an improved printing system, and much more.

This release requires changes to the server as well. Please check out our server migration guides to learn more.

Destroy API

Instance#destroy is deprecated in favor of the newly added PSPDFKit.destroy API:

// Change this…
instance.destroy();

// …to this
PSPDFKit.unload(instance);

// Change this…
instance.destroy();

// …to this
PSPDFKit.unload(instance);

We changed a few CSS classes to be more consistent with the general styling. This mainly affects the selectors for note annotation icons:

Old Class	New Class
`PSPDFKit-Note-Annotation-Icon-comment`	`PSPDFKit-Note-Annotation-Icon-Comment`
`PSPDFKit-Note-Annotation-Icon-rightPointer`	`PSPDFKit-Note-Annotation-Icon-RightPointer`
`PSPDFKit-Note-Annotation-Icon-rightArrow`	`PSPDFKit-Note-Annotation-Icon-RightArrow`
`PSPDFKit-Note-Annotation-Icon-check`	`PSPDFKit-Note-Annotation-Icon-Check`
`PSPDFKit-Note-Annotation-Icon-circle`	`PSPDFKit-Note-Annotation-Icon-Circle`
`PSPDFKit-Note-Annotation-Icon-cross`	`PSPDFKit-Note-Annotation-Icon-Cross`
`PSPDFKit-Note-Annotation-Icon-insert`	`PSPDFKit-Note-Annotation-Icon-Insert`
`PSPDFKit-Note-Annotation-Icon-newParagraph`	`PSPDFKit-Note-Annotation-Icon-NewParagraph`
`PSPDFKit-Note-Annotation-Icon-note`	`PSPDFKit-Note-Annotation-Icon-Note`
`PSPDFKit-Note-Annotation-Icon-paragraph`	`PSPDFKit-Note-Annotation-Icon-Paragraph`
`PSPDFKit-Note-Annotation-Icon-help`	`PSPDFKit-Note-Annotation-Icon-Help`
`PSPDFKit-Note-Annotation-Icon-star`	`PSPDFKit-Note-Annotation-Icon-Star`
`PSPDFKit-Note-Annotation-Icon-key`	`PSPDFKit-Note-Annotation-Icon-Key`

We changed the default printing mode from PrintMode.EXPORT_PDF to PrintMode.DOM. This should not cause issues with existing setups.

Check out the Printing guide to learn about the differences.

For a full list of changes, check out the changelog.