2017.8 Migration Guide
PSPDFKit for Web 2017.8 changes annotation IDs from integers to strings.
This requires that all clients (iOS, Android, and Web), along with the server, are updated to the latest version at the same time. If you’re maintaining an Instant setup, make sure to check out the server migration guides.
Annotation API Changes
Annotationsubclasses now have a string value for the
idfield. This ID will still be generated automatically whenever
The concept of local ID and global ID is gone completely. The Web client can now generate a unique string ID, which is also used to reference the annotation when it is saved to Instant or Instant JSON.
Instance#resolveLocalIdwas removed and is now available as
Instance#ensureAnnotationSaved. This method still accepts an annotation and will resolve the promise when the annotation is persisted. The
idproperty of the annotation will now stay stable and will no longer be updated when the promise resolves.
The document format of Instant JSON no longer requires the
lastAnnotationIdproperty. Importing the previous version of Instant JSON (with number values for annotation IDs) using the
Config#instantJSONoption is still supported. When
Instance#exportInstantJSONis called the next time, the format will automatically be upgraded. The IDs of existing annotations will simply be cast to string (so
For more details, check out our updated Annotation and Instant JSON guides.
For a full list of changes, check out the changelog.