iproov_flutter 7.0.0
iproov_flutter: ^7.0.0 copied to clipboard
The iProov Face SDK for Flutter, providing flexible authentication for identity assurance
iProov Face Flutter SDK #
7.0.0 #
iProov Face Flutter SDK v7.0.0 includes the following changes
Flutter #
- Added
IProov.isSessionActive(), which returns whether a session is currently active. Use it to detect and clean up a stale session before callinglaunch()again, avoidingCaptureAlreadyActiveException. - Fixed
IProov.cancel()hanging forever on Android: the native handler now always replies, so the returnedFuturecompletes. - Breaking:
IProov.cancel()now returnsFuture<void>instead ofFuture<bool>. It is safe to call unconditionally, andisSessionActive()is the way to check whether a session has finished. - Breaking:
Canceler.apphas been renamed toCanceler.integration, matching the native SDKs.
Android #
- Upgraded SDK to v12.0.0.
CaptureAlreadyActiveExceptionis now routed to Dart as anIProovEventErrorinstead of being swallowed inside a coroutine.- Session cancellation from
subscription.cancel()is now performed synchronously rather than in a fire-and-forget coroutine.
iOS #
- Upgraded SDK to v14.0.0.
- Added Swift Package Manager support. The plugin works with both Swift Package Manager and CocoaPods, and Flutter picks one when it builds your app: Flutter 3.44 and above uses Swift Package Manager by default, and earlier versions use CocoaPods. No changes are needed in your app.
- Added an "Avoiding
CaptureAlreadyActiveException" section describing both the normal terminal-event flow and stale-session recovery viaisSessionActive()/cancel().
Breaking changes #
- Removed
Options.orientationand theOrientationenum. IProovEventSuccessno longer carries aframe.IProovEventFailureno longer carries aframe.- Removed
ListenerNotRegisteredException. The corresponding error no longer exists in either native SDK, so it could never be thrown. - Raised the Android requirements to compileSdk 36, Kotlin 2.0.21, Android Gradle Plugin 8.9.1 and JDK 17.
- Raised the iOS requirements to iOS 16 and Xcode 26.
Behavioural changes #
- The default
filteris nowNaturalFilter(previouslyLineDrawingFilter). If you rely on the previous appearance, setfilterexplicitly.
Added #
- Added
IProov.nativeSdkVersion(), which returns the version of the native iProov SDK. - New
accessibilityoptions undergenuinePresenceAssurance(isVibrationEnabled,isSoundEnabled,isColorEnabled). - New exceptions
UnsupportedOSVersionExceptionandUnsupportedSDKVersionException. - Support for the new iOS
unsupportedDeviceerror, mapped toUnsupportedDeviceExceptionalongside the legacynotSupportedspelling of the same error. - New exceptions
ConsentRequiredExceptionandSessionCannotBeStartedTwiceException(Android only). These native errors already existed but were previously surfaced asUnexpectedErrorException.
Fixed #
- Errors from the key pair API (
keyPair.sign(),publicKey.getPem(),publicKey.getDer()) now throw the matchingIProovException. Previously the native exception escaped the Android plugin and was reported to Dart as aMissingPluginException. Android only.
6.1.0 #
6.0.0 #
iProov Face Flutter SDK v6.0.0 includes the following changes
Flutter #
- Adding the new Options in genuinePresenceAssurance(controlYPosition, controlXPosition, and scanningPrompts)
- Increase min Flutter version to 3.27.0
- Increase min Dart version to 3.0.0
iOS #
- Upgraded SDK to v13.0.0.
Android #
- Upgrading Android target sdk to 36
- Kotlin 1.8.10
- Upgraded SDK to v11.0.0.
5.3.0 #
5.2.0 #
5.1.0 #
5.0.2 #
5.0.1 #
iProov Face Flutter SDK v5.0.1 includes the following changes
Flutter #
- An
elsebranch has been added to thewhenexpression to ensure it handles all possible cases, preventing potential crashes.
5.0.0 #
4.0.4 #
- Added
additionalOptionsparameter togetToken()in the Dart API client.
4.0.3 #
4.0.2 #
4.0.1 #
iProov Face Flutter SDK v4.0.1 includes the following changes
Flutter #
- The
certificatesoption is nowList<String>?. The base64-encoded SHA-256 hash of a certificate's Subject Public Key Info is used to add a certificate. - Removed unnecessary
metalibrary
4.0.0 #
iProov SDK Face Flutter SDK v4.0.0 is a major update which includes a number of improvements and breaking changes.
Please consult the Upgrade Guide for detailed instructions on how to upgrade to this new version.
Flutter #
- To support the changes in SDK version iOS v11 and Android v9, the following have been updated:
- The following
Optionshave been removed:faceDetector,maxPitch,maxYawandmaxRaw
UserTimeoutexception has been added toIProovExceptionIProov.CancellerbecomesIProov.Canceler
- The following
iOS #
- Upgraded SDK to v11.0.0.
- Requires iOS 12.0 and above
Android #
- Upgraded SDK to v9.0.1.
- Updated Gradle to version 7.5 and Gradle build tools to 7.4.1
Example app #
- Updated the Gradle to version 7.5 and Gradle build tools to 7.4.1
3.2.0 #
iProov Face Flutter SDK v3.2.0 includes the following changes
Flutter #
- Declared support for Dart 3.
- Dependency on image package upgraded to 4.0.0
- Added
copyWith()implementation toOptions. Optionsclasses are now marked@immutable.
iOS #
- Upgraded SDK to v10.3.0.
Android #
- Upgraded SDK to v8.5.0.
API Client #
- All methods now have named parameters.
enrolPhotoAndGetVerifyToken()now supports passing assurance type.
3.1.1 #
3.1.0 #
iProov SDK Face Flutter SDK v3.1.0 includes bug fixes
Please consult the Upgrade Guide for detailed instructions on how to upgrade to this new version.
Flutter #
- Fix how
feedbackCode,reasonandframevalues are returned byIProovEventFailure, and valueframebyIProovEventSuccesin the Android side.
iOS #
- Upgraded SDK to v10.1.2.
Android #
- Upgraded SDK to v8.3.0.
3.1.0 #
iProov SDK Face Flutter SDK v3.1.0 includes bug fixes
Please consult the Upgrade Guide for detailed instructions on how to upgrade to this new version.
Flutter #
- Fix how
feedbackCode,reasonandframevalues are returned byIProovEventFailure, and valueframebyIProovEventSuccesin the Android side.
iOS #
- Upgraded SDK to v10.1.2.
Android #
- Upgraded SDK to v8.3.0.
3.0.0 #
iProov SDK Face Flutter SDK v3.0.0 is a major update which includes a number of improvements and breaking changes.
Please consult the Upgrade Guide for detailed instructions on how to upgrade to this new version.
Flutter #
- Cancelling all subscriptions to the
Stream<IProovEvent>returned fromIProov.launch()will now cancel any ongoing claim. Optionshas been overhauled to support the new SDK options in iOS v10 and Android v8 respectively.- Fixed an issue where internal plugin errors would not be properly surfaced to the app.
iOS #
- Upgraded SDK to v10.1.1.
- Fixed an issue where custom fonts would crash on two consecutive launches.
Android #
- Upgraded SDK to v8.1.0.
- Fixed an issue where custom fonts would not be applied correctly.
API Client #
- Improved exception handling.
- The API Client now requires Dart 2.17+.
Example app #
- The example app now builds with sound null safety.
2.0.0 #
iProov SDK Face Flutter SDK v2.0.0 is a major update which includes a number of improvements and breaking changes.
Please consult the Upgrade Guide for detailed instructions on how to upgrade to this new version.
Flutter #
IProov.launch()now returns aStream<IProovEvent>rather than using callbacks.Optionsare now built fromconstconstructors rather than setting individual properties.- Added comprehensive documentation to
Options. - Added the following new options, supported in the latest SDK versions:
UiOptions.floatingPromptRoundedCornersGenuinePresenceAssuranceUiOptions.readyFloatingPromptBackgroundColorGenuinePresenceAssuranceUiOptions.notReadyFloatingPromptBackgroundColorGenuinePresenceAssuranceUiOptions.readyOverlayStrokeColorGenuinePresenceAssuranceUiOptions.notReadyOverlayStrokeColorLivenessAssuranceUiOptions.floatingPromptBackgroundColorLivenessAssuranceUiOptions.overlayStrokeColor
- Fixed an issue where specifying custom certificates for pinning would result in a crash.
iOS #
- Upgraded SDK to v9.5.0.
Android #
- Upgraded SDK to v7.5.0.
API Client #
- The Dart API client is now provided as a separate module,
iproov_api_client. - Upgraded http to v0.13.4.
- Added support for the
/validateAPI call.
Example App #
- Fixed an issue where the Android example app wouldn't build due to an error relating to Android embedding.
1.0.0 #
We're pleased to announce that the iProov Face Flutter SDK is now production-ready!
Flutter #
- Added
floatingPromptEnabledtoUiOptions. - Renamed
footerTextColortopromptTextColorinUiOptions. - Removed
fontandfontResourcefromUiOptions. UsefontPathinstead, which is now cross-platform.
iOS #
- Upgraded SDK to v9.3.0.
- Updated installation instructions for Cocoapods.
- Added support for custom fonts.
Android #
- Upgraded SDK to v7.2.0.
- Added support for custom fonts.
0.2.0 #
Flutter #
- All parameters to
IProov.launch()are now named parameters. - API key and secret for the Example app should now be set in
api_keys.dart. - Added
flutter_lintsdependency to package and example app. - Added
headerBackgroundColor,footerBackgroundColor,headerTextColorandfooterTextColortoUiOptions. - General improvements to the Example app.
- Improved coding style and formatting.
- Pinning certificates should now be passed as
List<int>instead ofStringpaths.
iOS #
- Upgraded SDK to v9.2.0.
- Passing certificates directly as
List<int>is now supported. - Error handling improvements.
closeButtonImageis now supported.
Android #
- Upgraded SDK to v7.1.0.
- Passing certificates directly as
List<int>is now supported. - Error handling improvements.