DocumentationAPI Reference
DocumentationAPI Reference

Android SDK v2 Changelog

[v2.2.22] - 2022-05-20

Fixed

  • Disable back action for government id flows without a back step
  • Improve handling of network errors

[v2.2.21] - 2022-05-16

Changed

  • Make the number of images captured for the government id step configurable by the server
  • Make the manual capture button delay for the government id step configurable by the server
  • Update the image shown when there was an error verifying the back side of a government id

[v2.2.20] - 2022-05-06

Changed

  • Allow users to retry navigating between certain steps on recoverable network errors
  • Allow users to retry uploading government id/document files
  • Improve network calls so they are more resilient
  • Selfie biometric consent has moved to appear above the agreement button to ensure users have read the full consent text before continuing.
  • Update dependency of Coil from 0.12.0 to 2.0.0-rc03

Fixed

  • Display errors on input fields when there is a user input error
  • Fix flickering of image/document previews in rare cases.

[v2.2.19] - 2022-04-29

Fixed

  • Fix the resolution of font names when loading custom font families in texts

[v2.2.18] - 2022-04-27

Changed

  • Handle more types of network errors

[v2.2.17] - 2022-04-22

Changed

  • Make the clickable area of the back and close button slightly bigger

Fixed

  • Fix a race condition crash on the inquiry success screen

[v2.2.16] - 2022-04-20

Added

  • Added the ability to render markdown on selfie step disclosure text

[v2.2.15] - 2022-04-13

Removed

  • The following string resources have been removed, their values are now supplied by the server:
    • pi2_selfie_hold_still

[v2.2.14] - 2022-04-04

Added

  • Added the following style attribute: personaCenterAlignRemoteAsset

Fixed

  • Handle 404s more gracefully

[v2.2.13] - 2022-03-30

Changed

  • Skip government ID select screen if only one ID class is available

Fixed

  • Allow for server-defined images to have nullable widths/heights without crashing

[v2.2.12] - 2022-03-24

Changed

  • Selfie manual capture button for the center pose now triggers a capture immediately for behavior
    consistency. Previously it would trigger a countdown instead.

Fixed

  • Show users the manual capture button immediately if auto capture cannot be performed on the device
  • Recover from camera related errors more gracefully, allow users to retake photos on error

[v2.2.11] - 2022-03-22

Changed

  • Government id list items now use textAppearanceListItem instead of textAppearanceSubtitle1
  • Selfie capture animations are now customizable via personaSelfieLookLeftLottieRaw and
    personaSelfieLookRightLottieRaw
  • When a static image (drawable) is set instead of a Lottie animation via
    personaSelfieLookLeftDrawable and personaSelfieLookRightDrawable, the animation will not play.
    Instead, the given static image will be used instead.

Fixed

  • Respect the values of personaSelfieLookLeftDrawable and personaSelfieLookRightDrawable
  • Prevent buttons from overlapping with UI elements on government ID flow

[v2.2.10] - 2022-03-16

Changed

  • Various animations and drawables are more themeable

UI UPDATES: SELFIE CAMERA CAPTURE SCREEN

We’ve made updates to the selfie verification flow to help reduce blurry and repeat pose captures. You’ll notice the following changes to the selfie verification flow:

  • New selfie animation includes an arrow that points users in the direction they should look for left and right pose capture.

  • Auto-capture is delayed for left and right pose until each animation plays. In addition, user will be able to clearly preview selfie during capture (blur overlay removed).

If you have any questions about these changes, please reach out to your CSM.

Fixed

  • Reduce flickering due to re-layouts during first render pass
  • Title/body text fields can now honor android:textAlignment properly
  • Improve government ID capture's user experience on lower end devices; make UI more responsive
  • Improve the capture speed of government ID auto capture and manual capture

[v2.2.9] - 2022-03-07

Added

  • Show a (hide-able) cancel "X" on every non-loading screen to match iOS and web
  • Added support for upload option with government id verification

Changed

  • Buttons on government id review screen will flow vertically when text is more than one line
  • Update the cancel sheet's copy

Fixed

  • Fix compatibility issues with Lottie 5.0+
  • Fix layout on government id select screen when no back button is shown
  • Fix back button on government id review screen

[v2.2.8] - 2022-02-24

Added

  • Added support for custom government id scanning lottie animation
  • Added support for custom selfie look left and look right drawable

[v2.2.7] - 2022-02-22

Added

  • Added support for custom government id overlays and hint animations

Fixed

  • Allow "center-only" selfie experiences to pass
  • Fixed crash in government id

[v2.2.6] - 2022-02-16

Added

  • Various theme attributes have been added

Changed

  • Default alignment of ui step screens
  • Country select now presents a bottom sheet instead of a dropdown

[v2.2.5] - 2022-02-11

Added

  • Auto-capture for center pose selfies
  • Support for additional government IDs
    • Citizenship Certificate
    • Consular ID
    • Foreigner ID
    • Health Insurance Card
    • Long Term Pass
    • National Bureau of Investigation Certificate
    • Permanent Account Number card (SSN)

Changed

  • Autofocus first input field on page load
  • Only allow digits (0-9) in day/month input fields

[v2.2.4] - 2022-02-04

Added

  • Added support for custom Selfie animation on selfie start view with
    • Lottie file personaInquirySelfieLottieRaw
    • Size between 0.0 and 1.0 for personaInquirySelfieLottieWidthPercent

Removed

  • The following string resources have been removed, their values are now supplied by the server:
    • persona_selfie_persona_governmentid_submitting_title
    • persona_selfie_persona_governmentid_submitting_body
    • selfie_hint_center
    • selfie_hint_look_left
    • selfie_hint_look_right

[v2.2.3] - 2022-02-03

Fixed

  • Use styles that are night-mode friendly for chevrons and arrows

[v2.2.2] - 2022-02-01

Added

  • Support SVGs from the server

Fixed

  • Enable haptic feedback on older versions of Android
  • Address resource contention that stopped the camera after many usages

[v2.2.1] - 2022-01-28

Changed

  • Change selfie capture to be more strict, surface errors to users
  • Depend on Kotlin 1.5.31
  • Update resources to prevent name collisions with the v1.x SDK

[v2.2.0] - 2022-01-25

Breaking

  • com.withpersona.sdk has been changed to com.withpersona.sdk2 everywhere

[v2.1.3] - 2022-01-24

Added

  • Support for server driven localizations in selfie templates

Changed

  • Cancel modal now uses textAppearanceHeadline6 and textAppearanceSubtitle1

Removed

  • The following string resources have been removed:
    • persona_selfie_start_title
    • persona_selfie_start_body
    • persona_selfie_start_button

[v2.1.2] - 2022-01-18

Added

  • Support for more server driven localizations on government ID templates
  • Support more components for form templates
  • Added address auto complete on address fields
  • Improve auto capture to take better pictures

Changed

  • Update dependencies
  • Various bug fixes

[v2.1.1] - 2021-12-13

Added

  • Allow multiple documents to be added on the same step

Changed

  • Update dependencies

[v2.1.0] - 2021-11-18

Added

  • Support completing an Inquiry flow without showing a completion screen

Changed

  • Redesign Government ID capture screens
  • Secondary buttons are now outlined
  • Update dependencies

Fixed

  • Remove Snackbar usage in Sandbox which older versions of AGP strips out
  • Use the Material UI background for materialButtonStyle and materialButtonStyleSecondary

[v2.0.3] - 2021-10-20

Fixed

  • Return an error when the SDK is launched without internet
  • Return session when canceling from document upload step

[v2.0.2] - 2021-10-13

Added

  • Support document upload step
  • Forward along server errors on the Inquiry creation step
  • Return error if using an incompatible template ID

Fixed

  • Starting an Inquiry by Inquiry Template Version has been fixed
  • Removed loading indicator blip after selfie and document verifications
  • Re-add Field population on client-side Inquiry creation

Changed

  • Update dependencies

[v2.0.1] - 2021-08-26

Added

  • Support the Keypass ID and Visa government ID types
  • Show a cancel confirmation pop-up

Fixed

  • InquiryField.Unknown return the name of the unknown type instead of just "unknown"

Changed

  • Footer now has a thin line on top of it

[v2.0.0] - 2021-08-05

Added

  • Support AndroidX's registerForActivityResult for interacting with the Inquiry
  • Cancel response now returns the sessionToken so the Inquiry flow can be resumed

Changed

  • Success and Failure callbacks are now represented by Complete with a status of completed
    or failed (though can be customizable in the future)
  • Support Inquiry templates prefixed with itmpl_ instead of tmpl_
  • Attributes returned in the Success response are now in the Complete's fields response

Deprecated

  • Recommend moving off Inquiry#onActivityResult and onto AndroidX's registerForActivityResult

Removed

  • Relationships and the containing list of Verification no longer exists