PSPDFKit 4.4 Migration Guide
This article provides a set of guidelines for migrating from version 4.3 to version 4.4 of PSPDFKit for Android. If you’re upgrading from a version earlier than 4.0, please review the Android 4 Migration Guide first.
Digital Signatures
The digital signing framework, which we introduced in PSPDFKit 4 for Android, was partially rewritten to support external signature providers such as hardware security modules (HSMs) and other signing entities. Moreover, the signing APIs were extended to support the implementation of multi-step signing flows — for example, when user interaction is required during the signing process.
Several methods from the original digital signatures API have been deprecated. If your app uses a custom Signer
subclass, we encourage you to migrate to the new interface.
The following resources should help you while you’re migrating to the new signing APIs:
-
Our Digital Signatures guide
-
The
CustomSignatureProviderExample
in our Catalog app, which gives a quick introduction to the new digital signing APIs
Deprecated Signing Methods
To fully support the newly added APIs, we deprecated the following methods on the Signer
and MemorySigner
classes:
-
Signer
_signFormFieldAsync(com.pspdfkit.forms.SignatureFormField, java.security.KeyStore.PrivateKeyEntry, java.io.OutputStream)
_signFormFieldAsync(com.pspdfkit.forms.SignatureFormField, java.security.KeyStore.PrivateKeyEntry, com.pspdfkit.signatures.BiometricSignatureData, java.io.OutputStream)
_signFormField(com.pspdfkit.forms.SignatureFormField, java.security.KeyStore.PrivateKeyEntry, java.io.OutputStream)
_signFormField(com.pspdfkit.forms.SignatureFormField, java.security.KeyStore.PrivateKeyEntry, com.pspdfkit.signatures.BiometricSignatureData, java.io.OutputStream)
-
MemorySigner
_signFormFieldAsync()
_signFormField()
As a replacement, use the new signFormField()
and signFormFieldAsync()
methods on Signer
.