DocumentationAPIChangelogTest your siteWatch a demoDashboard
Documentation
Start typing to search…

Android SDK Changelog

3.0.7 (2025-12-09)

  • Ensure datadome cookies are saved with attributes when a native context syncs with a webview to avoid duplicates
  • Add support for challenge responses with any HTTP status code

3.0.6 (2025-10-17)

  • Fix ClassCastException when upgrading an app using SDK ≤ 1.9.2 to 3.0.5, caused by a change of type for cookies stored on SharedPreferences

3.0.5 (2025-09-29)

  • Add safe handling for nullable WebResourceRequest.requestHeaders in WebViewClient.shouldInterceptRequest to prevent crashes
  • Fix missing requestId in manual integration when invoking onComplete(requestId) after challenge resolution

3.0.4 (2025-08-21)

  • Internal improvements

3.0.3 (2025-07-29)

  • Fix language mismatch on challenge page when response type is HTML
  • Add documentation for manual integration methods:
    • addDataDomeHeaders(Map<String, String> headers)
    • verifyResponse(String endpoint, Map<String, String> responseHeaders, int responseCode)
    • handleResponse(...) method overloads
    • logEvent(...) method overloads
    • DataDomeSDKManualIntegrationListener callbacks

3.0.2 (2025-07-21)

  • Fix ProGuard configuration to correctly resolve common-proguard-rules.pro by ensuring its content is merged into the final proguard.txt
  • Fix ProGuard rules to prevent obfuscation of public enum fields

3.0.1 (2025-07-11)

  • Collect additional signal to improve identification of sessions
  • Remove transitive dependency to com.infstory:proguard-annotations and improve Proguard configuration to reduce compilation times with the SDK
  • Add missing Accept-Language headers when the challenge webview reloads the page to maintain the language defined with the setResponsePageLanguage method

3.0.0 (2025-06-03)

  • Fix large HTML responses buffering to avoid truncation
  • Fix crash in manual integration when requestId is not provided and an exception is raised
  • Ensure manual response handling executes on a background thread to avoid blocking UI thread

Note:
This release does not contain any breaking change.
We are releasing this version as 3.0.0 to prevent users from mistakenly installing the unmaintained 2.0.0, which appears to be the latest version.

1.15.4 (2025-05-28)

  • Add missing whitespace in cookie-list delimiter to comply with RFC 6265
  • Remove deprecation of DataDomeSDK builder without DataDomeConfiguration parameter

1.15.3 (2025-05-09)

  • Fix cookie interception in DataDomeInterceptor to preserve all request cookie entries

1.15.2 (2025-04-24)

  • Improve on-disk cookie storage mechanism to ensure consistent persistence of new cookies

1.15.1 (2025-04-08)

  • Prevent DataDomeConfiguration from being obfuscated by ProGuard

1.15.0 (2025-04-03)

  • Send a signal payload at SDK initialization
  • Add new DataDomeSDK builder with DataDomeConfiguration parameter to enable signal payloads at SDK initialization
  • Deprecate the previous DataDomeSDK builder

1.14.6 (2025-02-25)

  • Fix a regression from previous 1.14.5 version where onError method in DataDomeSDKListener became inaccessible due to Gradle version upgrade
  • Fix code that may cause potential build inconsistencies

1.14.5 (2025-02-17)

  • Fix an issue that could occasionally cause the challenge display to be unresponsive
  • Upgrade OkHttp to 4.12.0 to address CVE-2023-3635
  • Upgrade Kotlin to 1.9.0 to address CVE-2022-24329 and remain compatible with OkHttp

Requirements

  • Minimum API level (minSdkVersion): 19
  • Minimum Kotlin version: 1.9.0

1.14.4 (2024-10-24)

  • Internal improvements

1.14.3 (2024-10-24)

  • Remove dependency on gson library
  • Add handling of cutouts for challenge display in ChallengeActivity

1.14.2 (2024-10-11)

  • Fix focus on instances of DataDomeWebView to allow on-screen keyboard to be shown

1.14.1 (2024-09-24)

  • Prevent DataDomeWebView from being obfuscated by ProGuard
  • Allow extensions of the DataDomeWebView class

1.14.0 (2024-09-18)

  • Add support for HTML challenge response
  • Add DataDomeWebView class for automated cookie sharing
  • Add support for additional challenge display after an invisible device-check
  • Adjust codebase to prevent LeakCanary from reporting a false positive memory leak
  • Deprecate bypassAcceptHeader method for custom Accept headers as the SDK now supports HTML responses

Breaking changes

  • For manual integration, a domain is required as a parameter for handleResponse method
    handleResponse(Map<String, String> headers, int statusCode, String data, @NonNull String domain)

1.13.9 (2024-07-26)

  • Optimize connectivity listener permissions in the challenge page.
  • Add support of connectivity listener for Android APIs < 21
  • Add a detection of StrictMode's penaltyDeath method

Update permissions

  • Remove:
    • WRITE_SETTINGS (signature permission)
    • CHANGE_NETWORK_STATE (normal permission)
  • Add:
    • ACCESS_NETWORK_STATE (normal permission)

1.13.8 (2024-07-19)

  • Fix ProGuard rule that was preventing JS callback retention, causing captcha resolution issues

1.13.7 (2024-07-18)

  • Ensure that thedwsid SFCC cookie is always injected into Webview cookie manager before displaying captcha

1.13.6 (2024-06-26)

  • fix captcha display issue for SFCC
  • improve debugging logs

1.13.5 (2024-06-05)

  • Fix back button behavior for challenge display when singleTask launch mode is used

1.13.4 (2024-05-17)

  • Improve payload exception handling
  • Fix captcha back behavior

1.13.3 (2024-05-13)

  • Add support of Brotli compression

1.13.2 (2024-04-25)

  • Optimize retry process performance.

Update permissions

  • Add:
    • WRITE_SETTINGS (signature permission)
    • CHANGE_NETWORK_STATE (normal permission)

1.13.1 (2024-02-26)

  • Fix captcha display after a device-check verification.
  • Deprecate the clearDataDomeCookie method with a warning message to warn of its use in production
  • Add SFCC header parsing for response page type redirection

1.13.0 (2024-01-30)

  • Add clearDataDomeCookie method
  • Support SFCC blocked response detection with 403 status code

1.12.0 (2024-01-17)

  • Add support for Device Check response with invisible mode enabled
  • Fix the issue of retrying failed requests order

1.11.0 (2023-10-23)

  • Customize the language of the DataDome response pages
  • Deprecate .agent method to set user-agent header

1.10.1 (2023-09-25)

  • Improve cookie management using an in-memory cached cookie to limit read/write operations from disk storage
  • Fix mobile payload sending for allowed responses.

Requirements

  • Kotlin plugin version >=1.3.50

1.9.2 (2023-06-16)

  • Prevent NullPointerException from occurring on redirection responses (302) without a Location header

1.9.1 (2023-06-14)

  • Prevent duplicate requests from being sent on retries when a captcha is canceled.
  • Enhance captcha Webview security by disabling potential exploitable methods.

1.9.0 (2023-05-19)

  • Upgrade Android API level to 33
  • Upgrade Okhttp library version to 4.9.2 to fix CVE-2021-0341
  • Upgrade gson library version to 2.8.9 to fix CVE-2022-25647
  • Fix a closed response bug

1.8.2 (2023-05-17)

  • Fix out-of-memory error on large HTTP responses

1.8.1 (2023-04-21)

  • Code fixes to prevent null context exception
  • Remove Multidex
  • Code improvement

1.8.0 (2023-03-06)

  • Support external cookie handling via CookieJar

1.7.0 (2023-02-17)

  • Improve response validation process
  • Add optional verbose logger

1.6.15 (2023-02-06)

  • Fix payload screen-size nullability

1.6.14 (2023-01-04)

  • Reduce cookie storage latency

1.6.13 (2022-11-24)

  • Fix captcha listener status when captcha is dismissed

1.6.12 (2022-10-05)

  • SFCC module adaptations

1.6.11 (2022-05-20)

  • Fixed captcha loop by filtering on invalid cookie

1.6.10 (2022-02-08)

  • Fixed an issue with the event tracker.

1.6.9 (2021-11-19)

  • Fixed an issue when running activity on single instance mode.

1.6.8 (2021-11-19)

  • Expose getCookieWithAttributes function.

1.6.7 (2021-11-12)

  • Added a new method to share the DataDome cookie with all attributes.

1.6.6 (2021-08-06)

  • Remove any dependencies to jCenter.

1.6.5 (2021-06-18)

  • Moved the SDK to Maven Central.

1.6.4 (2021-05-20)

  • Fixed proguard dependencies in pom.xml

1.6.3 (2021-04-27)

  • Release the SDK on JitPack.io. Bintray is being discontinued by JFrog.

1.6.2 (2020-11-03)

  • Fixed on bug occurring when navigating to an hypertext link in the captcha page while the android back button is disabled.

1.6.1 (2020-07-29)

  • Fixed a crash occurring when updating cookies

1.6.0 (2020-07-29)

  • Improved stability

1.5.9 (2020-07-24)

  • Fixed a concurrency crash while storing locally generated cookies

1.5.8 (2020-06-24)

  • Fixed a bug on the event tracker related to manual integration

1.5.7 (2020-04-02)

  • Improved Android X and AppCompact compatibility

1.5.6 (2020-03-31)

  • Improved lambda method

1.5.5 (2020-02-06)

  • Improved cookie handling

1.5.4 (2020-02-02)

  • Added enhancements for manual integration implementation

1.5.3 (2020-01-15)

  • Introduced manual integration

1.5.2 (2019-10-31)

  • Improved touch events method

1.5.1 (2019-10-16)

  • Improved events for better bot detection

1.5.0 (2019-10-10)

  • Added functionality for handling multiple requests
  • Added more improvements to Interceptor
  • Added more improvements to the retry functionality
  • Introduced customization for the back button's behavior on the Captcha page

1.4.11 (2019-10-06)

  • Improved velocity tracking
  • Added enhancements for testing, obfuscation and size optimization

1.4.10 (2019-08-27)

  • Improved the retry functionality

1.4.9 (2019-08-02)

  • Improved delegate calls

1.4.8 (2019-07-16)

  • Improved events handling

1.4.7 (2019-07-03)

  • Improved dependencies

1.4.6 (2019-05-22)

  • Added support for non-ASCII cookies

1.4.5 (2019-05-14)

  • Improved event send

1.4.4 (2019-04-11)

  • Improved headers compatibility

1.4.3 (2019-04-10)

  • Removed Guava dependency
  • Improved cookie handling

1.4.2 (2019-04-04)

  • Improved Interceptor compatibility
  • Added more improvements to events

1.4.1 (2019-03-29)

  • Improved Interceptor integration
  • Improved events

1.4.0 (2019-03-25)

  • Introduced improved cookie support
  • Introduced the option to disallow overriding the Accept header

1.3.0 (2019-02-28)

  • Added Application Context support

1.2.3 (2019-02-22)

  • Improved Interceptor performance

1.2.2 (2019-01-23)

  • Modified cookie handling in DataDomeInterceptor

1.2.1 (2019-01-16)

  • Introduced convenience tracking methods for touch events

1.2.0 (2019-01-11)

  • Introduced DataDomeActivity integration
  • Introduced Interceptor integration

1.1.0 (2018-12-14)

  • Modified DataDome SDK to be compatible with Android API 16+

1.0.0

  • Initial release

Updated 9 days ago