SDK Changelog & Migration guide

Changed

• Changes required logPageAction callback renamed to logAction
• Changes required Configuration BankLoggerCallback's parameter type AnalyticsPage was renamed to AnalyticsOrigin. New AnalyticsOrigin enum entries were added: GALLERY, HISTORY, MAP_DETAIL, MAP_PIN. See Custom analytics section for more information.

Fixed

• iOS 16 and older – map pins behavior when loading and zooming.

Changed

• Changes required Android – Removed the "Cashback" suffix from the Offers list destinations. The SDK navigation XML destination dateio_offers_list_cashback has been renamed to dateio_offers_list, and the Compose destination dateioOffersListCashbackGraph has been renamed to dateioOffersListGraph.
• Map feature with nearby offers is now available on both iOS and Android platforms.
• New configurations set to customize predefined SDK UIs.
• New vouchers UI available.
• Information about how affiliate offers work is available before going to the e-shop.
• Optional sticky categories in the offer list added.
• Mark-as-seen logging logic changed. It now depends on the percentage of the offer seen and its time on screen.

Fixed

• Android – multiple API calls triggered when navigating from notifications in Compose-based applications.
• Android – crash when searching with short text input.
• Android – crash when visitLink call fails.

Changed

• Changes required SDK now supports backward compatibility to Java 11. Older versions are no longer supported.

Added

• Support for Compose 1.8.3 on Android.
• Support for builds with API Level 35 on Android. Make sure you properly test bottom dialogs again on Android 15+ since there were breaking changes in window insets calculation, and they might differ based on your integration. See more in Android documentation.

Fixed

• Fixed issue caused by non-unique key in offers list.

Security

• Ktor updated to version 2.3.13 on Android and iOS. Due to security issue in previous versions. Although we don't use caching plugin that introduce this vulnerability.

Fixed

• Fixed issue when UI might freeze when going to eshop or navigation to maps.

Fixed

• Mark as seen logger for iOS and Android Compose applications.

Added

• Async DateioSdkApp.shared.loadCashbackHistoryTotals() for widgets outside the SDK. You can show how much the user saved.

Fixed

• iOS – badges texts and offer card date texts.

Fixed

• Race condition when setting request headers in multiple threads.

Changed

• Changes required Configuration.homeNavigationBackButtonType - for dynamic icon type on HP (close, back, none).
• iOS – SDK no longer uses native navigation, resolving potential navigation issues and enhancing UI flexibility.

Fixed

• Android – crash when the backend returns an error and the request takes too long on HP.
• iOS – crash occurring in search results when offers include badges.

Changed

• androidx.compose.material:material updated to version 1.7.3 - 1.7.8 on Android.
• androidx.navigation:navigation-compose updated to version 2.7.7 - 2.8.5 on Android.

Added

• New voucher type – with discount highlighted.
• New analytic logger events added: AnalyticsAction.SHOW_HOW_IT_WORKS, AnalyticsAction.SEARCH_RESULT_USED, AnalyticsAction.SHOW_VOUCHER, AnalyticsAction.COPY_COUPON.

Fixed

• UI fixes.
• Minor accessibility issues.

Changed

• Badge for online offers are now shown only when offer have e-shop only.
• When setIsLocationEnabled is enabled user location is required and used only when user go to "nearby" category and optionaly on stores page.
• com.google.android.gms:play-services-location updated to version 21.2.0 on Android.
• Changes required iOS – func getRequestHeaders(completion: @escaping ([String : String]) -> Void) changed to func getRequestHeaders(requestInfo: [String: String?], completion: @escaping ([String : String]) -> Void). Request info contains URL, method, body and contentType for all requests that SDK send. If you dont need these informations, you might ignore them.

Added

• Changes required Configuration.howItWorksType – to choose what how it works type to use.
• Configuration.offerDetailMainParts – for detail sections sorting.
• Configuration.addOfferTags - to support offers tags.
• Android – requestInfo for requests. You might use both functions setRefreshAuthHeadersCallback(callback: suspend (requestInfo: Map<String, String?>, authHeaders: (Map<String, String>) -> Unit) -> Unit) or old one setRefreshAuthHeadersCallback(callback: suspend (authHeaders: (Map<String, String>) -> Unit) -> Unit).
• New screen for offer shops.
• Two columns layout.

Fixed

• iOS – issue with images when changin categories on offers list.

Changed

• Categories on offer list can be deselected. No category is selected on start (optional, can be disabled).
• Changes required iOS – simplified settings for in app language change via LocalizationConfiguration.
• androidx.compose.material:material updated to version 1.7.3 on Android.
• androidx.activity:activity-compose updated to version 1.9.0 - 1.9.2 on Android.
• androidx.navigation:navigation-compose updated to version 2.7.7 - 2.8.3 on Android.

Added

• Support and demo for bottom bar implementation.
• Callbacks for analytic logger for bank logging.
• Routing to offer details, categories, history and offer activation outside of SDK via Configuration.processNotification(...). This method can be used for actions triggered by push notifications or application banners.
• Support for categories in mark as seen logger.
• iOS – system map application chooser.
• Negative values in transaction history are highlighted (optional).

Fixed

• Issue with affiliates vouchers.
• Android – crash when using Compose application and lineHeight is not set.
• Minor UI fixes.

Added

• New view for categories on homepage.

Fixed

• iOS – crash when re-initializing SDK. Make sure that you call DateioSdkApp.shared.destroy() when you logout user.
• Android – mark as seen logger.
• Minor UI fixes.

Fixed

• Android – fixed crash when using Lottie 6.4.0.
• Android – improved support for target version 34 and AGP 8.1.+.
• Further unification between Android and iOS.
• Minor UI fixes.

Removed

• Support for non UI configured SDK.

Fixed

• iOS – Significant performace improvement when scrolling in list.
• UI fixes and improvements.

Added

• iOS – DateioSdkConfiguration.dateio_hides_bottom_bar flag for hiding bottom bar if needed.

Fixed

• UI fixes.
• Issue on How It Works popup for iOS < 16 when using custom font.

Changed

• Changes required Android – SDK should be used as edge-to-edge from now. Set WindowCompat.setDecorFitsSystemWindows(window, false), set transparent status bar and delete android:fitsSystemWindows="true" from activity_demo.xml if present.
• Changes required Method DateioSdkApp.shared.configure modified. Now it allows passing parameters with UI configurations. Predefined configurations will be delivered together with the SDK.

Added

• iOS – UI customization via protocols.
• Vouchers as bottom sheet supported.
• Configuration.offerDetailHeaderParts for reordering parts in detail screen.

Changed

• New color scheme with surfaces, fill, text, state and stateWeak introduced.
• iOS and Android textations and icons further unified.

Added

• iOS – UI customization via protocols.
• Configuration.tutorialsType whatever show overlay with tutorial or tutorial banner.
• Detailed How It Works bottom sheet.
• Different UIs for navigation, history, search screen and errors messages.

Added

• Support for Material3 via update androidx.compose.material:material to version 1.6.5.
• You might enable confirmation popup before user will go to eshop via Configuration.showAffiliatePopup = true.

Fixed

• UI fixes for CCB, affiliates, vouchers, tutorials and some textations.
• Fixes in dark theme.

Removed

• Plain HTTP disalowed - it will thrown error from now.

Changed

• Changes required Object ApiRegistrationRepositoryDefault renamed to ApiAuthRepositoryDefault.
• Changes required Method registerUser now don't have parameter. From now it require standard client token, as others API calls.
• Paging libraries updated to version 3.2.1 on Android.
• Logging to BE unified between iOS and Android.

Added

• Parameter Configuration.api.version.
• Method ApiAuthRepositoryDefault.logoutUser().
• Method ApiAuthRepositoryDefault.deleteUser().
• Method Configuration.setOnApiErrorCallback.

Fixed

• Fixes in dark theme.
• Minor UI fixes.

Added

• Configuration.sslInterceptor and Configuration.sslNetworkInterceptor for Certificate Transparency.

Fixed

• Minor UI fixes.

Added

• Navigation inside SDK supported.
• Configuration.sslPins for SSL pinning.
• Method Configuration.allowedOfferTypes(...) for disabling certain offers type.

Added

• Method Configuration.setIsLocationEnabled(bool).
• Android – Further UI customization allowed.
• iOS – support for integration via CocoaPods.

Added

• Configuration.setRefreshAuthHeadersCallback(...) for refreshing tokens.
• Support for Apple silicon Macs.

Added

• Support for Voucher and Cumulative Cashback.
• Android – UI customization.

Changed

• Android – Banking applications with navigation via Jetpack Navigation component is no longer required. SDK can be used also in applications which use Fragment manager.

Added

• Methods destroy, registerUser and loadNewOffersCount.

Added

• First public version. SDK contains three main screens (cashback offer list, cashback history, offers search by text and category) plus one sub-screen (offer detail).
• Cashback and Affiliate offers.
• iOS – support for SwiftUI and UIKit applications.
• Android – Kotlin with Composer supported, Java with XML Views supported. Banking app navigation implemented with Jetpack Navigation component required.