Kinegram eMRTD Connector SDK iOS - Changelog
- Added support for CocoaPods again (in addition to SPM)
Notice: The recommended way is to integrate the SDK via SPM, as cocoapods is only in maintenance mode since 2024-09 (see official announcement)
Major Version Release - V2
This is a major rewrite of the eMRTD Connector SDK with significant architectural changes and breaking changes from V1.
✨ Key Improvements:
- Solves the iOS 20-second NFC timeout issue by moving APDU exchanges to the device
- Simple one-call validation API with
validate(with:)
- Modern Swift concurrency with async/await
- Improved error handling and progress reporting
⚠️ Breaking Changes:
-
New WebSocket protocol - Uses v2 protocol
-
Complete API redesign - Async/await based, simplified interface
-
Minimum iOS version increased from iOS 13.0 to iOS 15.0
-
Swift Package Manager only - CocoaPods support removed
-
Binary dependency required - Now includes
KinegramEmrtd.xcframework
📚 Migration:
See MIGRATION_V1_TO_V2.md for detailed migration instructions from V1.
- Add a flag
enableDiagnostics
to interface functions for enabling diagnostics in the DocVal server.
- Add support for setting custom HTTP headers for the WebSocket connection. See
connect
method in EmrtdConnector
class.
- Seperate github build jobs (no functional change to framework)
- Optimized github build action (no functional change)
- Added also validationID to ObjC interface
- Add a simplified and ObjectiveC compatible version, build as static framework. See folder
ObjCFramework
for more info.
- Improve documentation
- Rename library module from
KTAKinegramEmrtdConnector
to KinegramEmrtdConnector
!
Update your import statements accordingly.
- Add instruction to set "Team" in signings config to Readme
- Also parse the optional field "files_binary" in the EmrtdPassport Result JSON
- Show Details if Passive Authentication not successful
- Enforce Document Number to be Upper Case
- Minor Improvements to the Documentation
- Minor Improvements to the Documentation
- Improvements to the API of
EmrtdConnector
- Make Example App use revised EmrtdConnector API
- Additions to the Documentation