digified_flutter_plugin 0.0.12

Flutter plugin for Digified's Arabic eKYC and eContract SDKs. Provides native flows for identity verification and electronic contract signing with updated Android integration (FlutterActivity + Hilt) [...]

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.0.1 - 2025-11-11

Added

• Initial release of Digified Flutter Plugin
• Android integration with Digified eKYC SDK (v0.0.1)
• Android integration with Digified eContract SDK (v0.0.2)
• iOS integration with Digified SDK
• presentEKYC() method for launching eKYC identity verification flow
• presentEContract() method for launching eContract electronic signature flow
• Support for custom MainActivity extending AppCompatActivity
• Hilt dependency injection support for Android
• Material Components theme support
• Comprehensive documentation and setup guide
• MIT License

Technical Details

• Minimum Android SDK: API 24 (Android 7.0)
• Kotlin: 2.2.21
• Hilt: 2.57.1
• Minimum iOS: 16.0+
• Flutter SDK: >=3.0.0
• Dart SDK: >=2.18.0 <4.0.0

0.0.2 - 2025-11-14

Changed

• Simplified Android integration instructions: use FlutterActivity + @AndroidEntryPoint instead of manual AppCompatActivity with explicit FlutterEngine wiring.
• Refined package description to highlight native flows and updated Android approach.

Fixed

• Removed erroneous sample causing compile errors (FlutterEngineCache, incorrect lifecycle observer usage, back press override mismatch).
• Corrected and cleaned README code blocks (proper fenced formatting, no duplication).
• Ensured iOS minimum deployment target consistently documented as 16.0+.

Documentation

• Updated README: streamlined Android setup steps, clarified Hilt configuration, reinforced iOS 16+ requirement.
• Publishing guide remains unchanged.

Technical Notes

• No API surface change in Dart methods (presentEKYC, presentEContract).
• Internal Android activity recommendation changed; existing custom activities still compatible.

0.0.3 - 2025-11-16

Fixed

• Android: Plugin now gracefully handles host activity type checking at runtime instead of compile-time.
• Removed ambiguous imports causing duplicate Activity references and compile errors.
• Clearer error message when host activity doesn't extend AppCompatActivity.

Changed

• Android integration now requires AppCompatActivity host with FlutterFragment for proper Digified SDK compatibility.
• Updated README with correct AppCompatActivity + FlutterFragment setup instructions.

Documentation

• Comprehensive guide for hosting Flutter in AppCompatActivity using FlutterFragment.
• Clarified that native Digified SDK requires AppCompatActivity, not plain FlutterActivity.
• Added troubleshooting for common activity-related errors.

Technical Notes

• No changes to Dart API surface (presentEKYC, presentEContract).
• Plugin accepts any Activity but validates AppCompatActivity at runtime.
• Backward compatible: existing AppCompatActivity implementations continue to work.

0.0.4 - 2025-11-17

Updated

• Android: Updated Digified native SDK to version 0.0.3
• iOS: Updated Digified native SDK to version 1.5.2

Documentation

• Added iOS camera permission requirements (NSCameraUsageDescription) in README
• Clarified that camera access is required for document scanning and face verification

Technical Notes

• No Dart API changes
• Fully backward compatible with 0.0.3

0.0.5 - 2025-11-19

Added

• New API: setLoggingEnabled(bool enabled) method to enable/disable SDK debug logging
• Logging outputs detailed [Digified] prefixed logs on iOS for easier debugging
• Demo and example apps now enable logging by default for development

Updated

• iOS: Updated Digified native SDK to version 1.5.3

Fixed

• iOS: Fixed night mode/dark mode display issues in SDK UI

Documentation

• Added "Enable Debug Logging" section in README with usage examples
• Updated installation instructions to use version ^0.0.5
• Clarified logging should be disabled in production builds

Technical Notes

• No breaking changes to existing Dart API
• Android logging implementation placeholder (to be enabled when Android SDK supports it)
• Fully backward compatible with 0.0.4

0.0.6 - 2025-11-20

Fixed

• Android: Fixed navigation and WorkManager integration issues
• Android: MainActivity now properly uses cached FlutterEngine for plugin registration

Changed

• Breaking Change: Android MainApplication now requires Configuration.Provider implementation
• Android: Added WorkManager configuration with Hilt's DaggerWorkerFactory
• Android: Disabled automatic WorkManager initialization in AndroidManifest.xml
• Android: MainActivity now uses FlutterFragment.withCachedEngine() instead of withNewEngine()

Added

• Android: New dependencies required:
  • androidx.hilt:hilt-work:1.3.0
  • androidx.work:work-runtime-ktx:2.10.5
  • io.digified:digified-ekyc:0.0.3 (explicit dependency)

Documentation

• Updated README with WorkManager configuration instructions
• Added detailed AndroidManifest.xml configuration with WorkManager provider
• Updated MainApplication example with WorkManager setup
• Clarified background task processing requirements

Technical Notes

• No changes to Dart API surface
• Existing apps must update MainApplication and AndroidManifest.xml
• MainActivity cached engine approach ensures proper plugin registration
• WorkManager configuration required for Digified SDK's background processing

0.0.7 - 2025-11-24

Fixed

• Android: Ensured eKYC session ID callback reliability (UI thread dispatch, duplicate callback guard, empty session ID handling).

Added

• Documentation: Android eKYC notes added to README (session ID troubleshooting, version requirements).

Changed

• Internal Android plugin now logs eKYC launch and completion for easier debugging.

Technical Notes

• No changes to Dart API surface.
• iOS unchanged in this release; Android behavioral improvement only.
• Recommended upgrade for all Android integrators relying on the eKYC session ID.

0.0.8 - 2025-11-25

Fixed

• Android: Improved eKYC callback handling with proper null/empty checks
• Android: Fixed string null-safety checks (isNullOrEmpty() to explicit null and empty checks)

Added

• Android: Enhanced logging for eKYC flow debugging
  • Logs when eKYC callback is invoked with sessionId details (value and length)
  • Logs when eKYC launch completes and is waiting for callback
  • Logs when sessionId is successfully returned to Flutter
• Android: Comprehensive error handling with try-catch blocks around result operations
• Android: Thread-safe result-sent flag using synchronized lock

Changed

• Android: Improved error messages for debugging empty sessionId issues
• Android: Better exception handling when sending results back to Flutter

Technical Notes

• No changes to Dart API surface
• iOS unchanged in this release
• Enhanced debugging capabilities for troubleshooting eKYC sessionId issues

0.0.9 - 2025-11-26

Updated

• Android: Updated Digified eKYC SDK to version 0.0.4
  • Native SDK now correctly returns eKYC sessionId in callback
  • Fixes the issue where callback was invoked with empty string

Changed

• Android: Added explicit eKYC SDK dependency in build.gradle.kts

Technical Notes

• No changes to Dart API surface
• iOS unchanged in this release
• Recommended upgrade: Version 0.0.4 of the Android eKYC SDK fixes the sessionId callback issue
• All eKYC flows should now properly return the sessionId upon completion

0.0.10 - 2025-12-01

Updated

• Android: Updated Digified eContract SDK to version 0.0.4

Technical Notes

• No changes to Dart API surface
• iOS unchanged in this release
• Maintains eKYC SDK at version 0.0.4

0.0.11 - 2025-12-10

Added

• Enhanced Theme Customization API: New setTheme() method to customize SDK appearance
• Support for customizing light and dark mode colors:
  • Text colors
  • Background colors
  • Button text colors
  • Button background colors
• All 15+ SDK views now support complete color customization
• Better visual consistency across all flows with improved dark mode support

Updated

• iOS: Updated Digified SDK to version 1.5.4 with theme customization support
• iOS: podspec dependency updated to DigifiedSDK ~> 1.5.4

Documentation

• Added comprehensive theme customization guide in README
• Included examples for company branding and accessibility themes
• Documented hex color format requirements

Technical Notes

• No breaking changes to existing API
• Dart API: setTheme() with 8 required hex color parameters
• iOS implementation includes hex color conversion (UIColor(hex:))
• All colors should be provided as hex strings (e.g., "#RRGGBB")
• Recommended to call setTheme() before launching any SDK flows
• Fully backward compatible with 0.0.10

0.0.12 - 2025-12-10

Updated

• Android: Updated Digified eKYC SDK to version 0.0.5
• Android: Updated Digified eContract SDK to version 0.0.5

Technical Notes

• No changes to Dart API surface
• iOS unchanged in this release (remains at 1.5.4)
• Android SDK versions 0.0.5 include enhanced features and bug fixes
• Maintains full theme customization support from version 0.0.11
• Fully backward compatible with 0.0.11