Skip to content

v3.0.0-RC-1

Pre-release
Pre-release
Compare
Choose a tag to compare
@Mauin Mauin released this 05 Apr 06:10
· 0 commits to master since this release

This release is the first release candidate of the new RxFingerprint v3. This release is not production ready and meant for testing the new Android P support. RxFingerprint v3 is scheduled to be released once the Android P APIs are finalized.

Changes

Major breaking changes:

  • RxFingerprint now has to be created via a Builder.
  • Support for Android P and the new FingerprintDialog.

Deprecations

  • RxFingerprint.isHardwareDetected. Prefer rxFingerprint.isAvailable()
  • RxFingerprint.hasEnrolledFingerprints. Prefer rxFingerprint.isAvailable()

Details

RxFingerprint.Builder

Instead of having a growing class of static methods RxFingerprint now has to be created and configured with a Builder.

new RxFingerprint.Builder(context)
    .encryptionMethod(EncryptionMethod.RSA)
    .keyInvalidatedByBiometricEnrollment(true)
    .dialogTitleText("RxFingerprint")
    .dialogSubtitleText("Android P FingerprintDialog support coming soon...")
    .dialogDescriptionText("And it will keep supporting the good old FingerprintManager for devices running M and N.")
    .dialogNegativeButtonText("Cancel")
    .build();

When using the created instance the calls to authenticate, encrypt and decrypt are then greatly simplified and deduplicated.

Android P support

FingerprintDialog

RxFingerprint now supports the new FingerprintDialog provided in Android P. Depending on the Android OS version of the device RxFingerprint will either chose FingerprintDialog for devices running Android P or above or the old FingerprintManager implementation on older devices with fingerprint hardware.

The FingerprintDialog APIs will automatically show standardized UI that prompts the user to interact with their fingerprint sensor. The UI can be customized with the following methods in the RxFingerprint Builder:

  • dialogTitleText Title of the dialog
  • dialogSubtitleText Subtitle of the dialog
  • dialogDescriptionText Description shown in the dialog
  • dialogNegativeButtonText Text shown on the button that cancels the fingerprint operation

Prompting users to register a Fingerprint

Android P supports opening the system preferences and leading the user to the Fingerprint setup screen.
This can be done by calling rxFingerprint.launchFingerprintEnrollment().

Feedback

Please provide any feedback, issues or bugs you encounter while testing this version of RxFingerprint in the Issues.