Kinegram eMRTD Connector SDK iOS - Changelog

• Optimize MF/CardAccess flow (to avoid CoreNFC timeouts)
• Diagnostics: Log outbound APDU headers (no payload) for diagnostic sessions

• Diagnostics: Added detailed APDU monitoring events
• Optimize MF/CardAccess flow

• Diagnostics: Added monitoring events
• Compatibility: Improving read stability on sensitive IDs (e.g. VNM).

• Fix: Connector validation result summary now correctly reports an error when Passive Authentication (SOD signature) is invalid.

• Build: Simplify xcframework creation and set the connector binary to build for iOS 13+.
• Avoid redundant DG1 reads after CA by reusing DG1 provided by the DocVal server in the handback flow.
• Improve post‑CA behavior
• Improve NFC status reporting, surface clearer error messages

• Fix: Chip Authentication on Russian passports
• Fix: Fixes an issue with reading DG1/DG2 on some Chinese passports
• Fix: Increases compatibility with Italian ID cards
• Build: Weak-link CoreNFC in the provided xcframework so consuming apps are not forced into a strong CoreNFC dependency.

• Simplified distribution and usage: binary‑only Connector with a single XCFramework.
• No API changes required. Usage as before: Integrate via CocoaPods or SPM
• Note: Version jump comes from unification with the underlying core framework.

• Fix: Stabilize fire-and-forget mode (receiveResult=false)
• Example: Hide result output when receiveResult=false

• Fix: Remove NFC race‑guard and double‑cleanup; update KinegramEmrtd framework for stable async flow

• New: Automatic PACE selection based on document info
  • New overloads: validate(with:documentType:issuingCountry:) and startValidation(..., documentType:issuingCountry:)
  • Enables PACE polling automatically for known PACE-enabled ID cards (currently FRA, OMN), keeps it off for passports
• New: DocumentKind enum and MRZ helper DocumentKind.fromMRZDocumentCode(_:)
• Fix: Improve robustness of WebSocket connect/teardown

• New Feature: Add usePACEPolling parameter to support more documents
  • Required for reading French ID cards (FRA ID), Omani ID cards (OMN ID), etc.
  • Please be aware, that this requires changes to your app's entitlements (add PACE to com.apple.developer.nfc.readersession.formats) as described in the README

• 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)

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

• Everything begins