Changelog

1.9.0 - 20.10.2026

Added

• Lottie (airbnb/lottie-spm, 4.5.0 ..< 5.0.0) SPM bağımlılığı olarak eklendi. Lottie artık SDK binary'sine gömülmez, dinamik olarak linklenir; uygulamanız da Lottie kullanıyorsa SPM iki bağımlılığı tek bir Lottie.framework altında birleştirir. Lottie, SDK'nın public API'sinde yer almaz; entegrasyon tarafında ek bir yapılandırma gerekmez.

Changed

• IdVerification bağımlılığı 1.0.7 sürümüne yükseltildi. Sürüm yükseltmesinin ardından Xcode'da File > Packages > Reset Package Caches adımının uygulanması önerilir.
• Mükerrer MRZ / OCR paketleri bağımlılık grafiğinden kaldırıldı: QKMRZScanner, QKMRZParser, SwiftyTesseract ve libtesseract artık projeye eklenmez, ocrb.traineddata uygulamaya tek kopya olarak girer.
• SDK binary'si ve kaynak dosyaları belirgin şekilde küçüldü; uygulama boyutuna etkisi azaldı.
• Görüntülü görüşmesiz pakette LiveKit / WebRTC bağımlılıkları (client-sdk-swift, webrtc-xcframework, livekit-uniffi-xcframework, swift-protobuf) yer almaz. Görüntülü görüşmeli sürümler -withLivekit ve -withVideocall ekli etiketlerle ayrıca yayımlanır.
• LiveKit varyantında (-withLivekit) client-sdk-swift paket bağımlılığı kaldırıldı; yerine webrtc-xcframework (exact: 150.7871.2) ve livekit-uniffi-xcframework (0.1.9) kullanılır.
• Framework bundle sürümü (CFBundleShortVersionString) artık yayın etiketiyle aynı değeri taşır.

Removed

• 1.8.0 ile kullanım dışı kalan şablon görselleri ve animasyonlar SDK'dan kaldırıldı. Buna bağlı olarak public Asset enum'undan Asset.Animations.idHologram, Asset.Animations.loading, Asset.Images.card, Asset.Images.idGuideFront, Asset.Images.idGuideBack, Asset.Images.idGuideRuPassport ve Asset.Images.passport çıkarıldı. Bu varlıklara doğrudan erişen entegrasyonların güncellenmesi gerekir.

Notes

• Uygulamanız da lottie-spm kullanıyorsa açılışta bir kez Class _TtC11_LottieStub10LottieStub is implemented in both … uyarısı görülebilir. Bu sınıf lottie-spm'in boş bir yardımcı hedefidir ve kullanılmaz; uyarı zararsızdır ve Lottie animasyonlarını etkilemez.

1.8.0 - 02.10.2026

Added

• Pasaport adımında pasaportun yeni veya eski tip olduğu otomatik olarak tespit edilmeye başlandı. Tespit edilen tip, belge yükleme isteğinde passport_type alanı (new, old veya unknown) ile backend'e iletilir. Entegrasyon tarafında ek bir yapılandırma gerekmez.

Changed

• Kimlik ön yüz, arka yüz ve pasaport adımlarındaki çekim ekranı yenilendi: sabit şablon görselleri kaldırıldı, belgenin konumlandırılacağı alan artık yarı saydam bir arka plan üzerinde belge çerçevesi olarak gösteriliyor.
• Canlılık adımında yüz algılama, görüntü yakalanmadan önce kullanıcının yüzünün sabitlenmesini bekleyecek şekilde güncellendi; hareketli kareler nedeniyle oluşan bulanık çekimler azaltıldı.
• IdVerification bağımlılığı 1.0.6 sürümüne yükseltildi. Sürüm yükseltmesinin ardından Xcode'da File > Packages > Reset Package Caches adımının uygulanması önerilir.

Fixed

• Akış sırasında cihaz ekranının kararması ve otomatik kilitlenmesi sorunu giderildi. SDK akış süresince ekranın kapanmasını engeller, akış sona erdiğinde bu ayar eski haline döner.

1.6.14 - 15.09.2026

Added

• KPS adımı eklendi: kullanıcı arayüzü olmayan, SDK'nın doğrudan backend sorgusu yaparak sonucuna göre bir sonraki adıma geçtiği Kimlik Paylaşım Sistemi doğrulaması. .setStepType(.kps) ile kullanılır.
• Adım bazlı NFC metin yapılandırması eklendi: StepBuilder.setNFCTextConfig(_:) ile successfulReadText, scanDescription ve retryDescription özelleştirilebilir.
• Cihaz güvenlik kontrolü eklendi: setSecurityCheckEnabled(true) ile jailbreak, simülatör, debugger ve hooking tespiti açılır. Kontrol her çalıştığında SECURITY_CHECK_PASSED veya SECURITY_WARNING olayı üretilir; kompromize cihazlarda akış hata ekranıyla durdurulur. Mesajlar setSecurityErrorMessage ile özelleştirilebilir.
• Başarı ekranı metinleri özelleştirilebilir hale geldi: setCompletedScreenTexts(_:) ve CompletedScreenTexts (titleText, descriptionText, buttonText).
• Işık uyarıları yapılandırılabilir hale geldi: setOverexposureWarning(_:) ve setLowLightWarning(_:) metotları ile WarningConfig (.enabled(message:) / .disabled). Varsayılan değer .disabled'dır.
• UIConfig tema token'ları genişletildi. ColorsConfig'e primaryColor, onPrimaryColor, surfaceColor, onSurfaceColor, backgroundColor, errorColor, successColor, textPrimaryColor, textSecondaryColor ve lineButtonTextColor; ShapesConfig'e cardCornerRadius, imageFrameCornerRadius ve bottomSheetCornerRadius; TypographyConfig'e promptFontSize ve promptFontWeight eklendi.
• TextConfig'e görüntülü beyan ekranı için startButtonText ve stopButtonText eklendi.
• Adım bazlı buton metni ve kapatma butonu kontrolü eklendi: StepBuilder üzerinde setApproveButtonText, setRetakeButtonText ve setCancelButtonIsActive. Adım bazlı değerler UIConfig.textConfig ile verilen genel metinleri ezer.
• enterKYC fonksiyonuna, video görüşme isteklerinde randevu tanımlayıcısı olarak kullanılan roomName parametresi eklendi.
• Sertifika sabitleme desteği belgelendi: setPinnedCertificate(from:orEmbeddedFile:isPEM:).
• onEvent ile iletilen tüm LogState olayları ve raw value'ları dokümana eklendi.
• Delegate'e alternatif olan KYCManager.onError closure'u ve TeydexError üzerinden okunabilen title, message, extraDetail alanları dokümana eklendi.
• Kurulum bölümüne paket varyantları ve Reset Package Caches hakkında bilgilendirme notu eklendi.
• NFC adımında doğum yeri bilgisi okunmaya başlandı.

Changed

• Kırıcı değişiklik: TeydexError alt enum'larının case isimleri UPPER_SNAKE_CASE biçimine taşındı. Örnek: .cameraPermissionDenied → .CAMERA_PERMISSION_DENIED, .deviceNotHaveNfc → .DEVICE_NOT_HAVE_NFC, .nfcDisabled → .NFC_NOT_ENABLED, .deviceInitFailed → .CAMERA_CONFIGURATION_FAILED, .externalAuthFailed → .CARD_AUTH_FAILED. setCameraErrorMessage, setNFCErrorMessage gibi metotlara sözlük veren entegrasyonların güncellenmesi gerekir.
• enterKYC(clientToken:...) imzası deprecated olarak işaretlendi; yerine akışın başlatılacağı ekranı alan enterKYC(from:...) kullanılmalıdır.
• Yeni hata aileleri eklendi: TeydexError.PermissionError, TeydexError.SecurityError, TeydexError.NetworkError ve TeydexError.VideoRecordError. Bu aileler için setPermissionErrorMessage, setSecurityErrorMessage, setNetworkErrorMessage ve setVideoRecordErrorMessage metotları kullanılabilir.
• CameraSourceError ailesine FACE_DETECTION_FAILED ve APP_WENT_BACKGROUND case'leri eklendi.

Fixed

• Video görüşmede karanlık ekran sorunu giderildi.
• Başarısız sonuçlanan video görüşmelerde yaşanan donma sorunu giderildi.
• Canlılık adımında oluşan çökme giderildi.
• Görüntülü beyan adımında kayıt ön izlemesinin görünmemesi sorunu giderildi.
• Görüntülü beyan adımındaki ses sorunu giderildi ve varsayılan zaman aşımı süresi güncellendi.
• Görüntü sıkıştırma davranışı iyileştirildi.

1.4.6 - 13.05.2026

Added

• VideoRecord (Görüntülü Beyan) adımı eklendi: kullanıcının ekranda gösterilen metni yüksek sesle okuyarak video kaydı oluşturduğu sesli video doğrulama adımı. .setStepType(.videoRecord) ile kullanılır; setStartButtonText, setStopButtonText, setApproveButtonText, setRetakeButtonText ve setVideoRecordDuration ile yapılandırılabilir.

Changed

• onProcessFinished ile dönen KYCProcessResult.failed ve cancelled sonuçlarının imzası değişti: step: KYCStep? yerine stepName: String?, failed sonucundaki reason: TeydexError yerine reason: String kullanılıyor. Bu tipleri kullanan entegrasyonların güncellenmesi gerekir.

Fixed