# UnifiedSDK

## Release Notes

***

### Version 6.0.0 — April 8, 2026

This is a major release introducing significant stability improvements, better error handling, and critical bug fixes. **This version contains breaking changes** — please review the migration notes in the documentation before upgrading.

#### ⚠️ Breaking Changes

* Error handling during SDK initialization has been updated. The `onCmpOnError` callback now receives a typed `AppconsentExceptions` object, giving you more granular control over initialization failures. Update your error handling accordingly.

#### What's New

* The SDK now throws a clear, catchable error during initialization if the JavaScript engine fails to start, making issues easier to diagnose.
* The consent clearing method now supports `onSuccess` and `onError` callbacks, giving you better control over the flow.
* A secure loader is now displayed while the CMP is being loaded, improving the perceived experience for your users.

#### Bug Fixes

* **Fixed** — The consent window was being hidden when switching between apps. Users can now return to a pending consent dialog without issue.
* **Fixed** — On older Android versions, the WebView was not rendering fully. This affected a significant portion of devices and has been resolved.
* **Fixed** — Tapping the "Close" button on vendor URLs in the bottom modal was incorrectly closing the entire CMP. This no longer occurs.
* **Fixed** — Navigation bar insets are now correctly handled, preventing UI overlap on devices with gesture navigation.
* **Fixed** — A race condition could cause the SDK to initialize twice when accessed from multiple threads simultaneously. This has been resolved.

#### Improvements

* Internal scope management has been optimized, resulting in better memory usage and overall SDK performance.

***

### Version 0.3.0-beta01 — February 16, 2026

#### ⚠️ Breaking Changes

* The SDK now targets API level 34, in line with Google Play's updated requirements. Please update your project's `compileSdk` and `targetSdk` accordingly.

#### What's New

* Updated TCF compliance to version 2.3, managed in coordination with our backend infrastructure.
* The SDK now detects if no WebView component is available on the device and stops initialization gracefully, preventing unexpected crashes.
* A warning is now raised if the SDK is used in a multi-process environment, helping you identify potential WebView conflicts early.
* UI insets are now managed in relation to the illustrations present in your Notice, ensuring a consistent and polished display across devices.

#### Bug Fixes

* **Fixed** — In some cases, the CMP screen would not dismiss after the user completed their consent choices.
* **Removed** — Toast notifications for internal CMP events have been removed, as they were occasionally visible to end users.

#### Improvements

* Logging has been improved for greater accuracy during debugging.
* JavaScript ↔ Kotlin communication flows have been optimized, along with improved coroutine and flow management for better runtime performance.

***

### Version 0.2.0-beta01 — December 17, 2025

#### Internal Changes

* Internal SDK module restructuring. No functional changes. If you reference internal module paths directly in your build configuration, you may need to update them — refer to the migration guide for details.

***

### Version 0.1.0-beta02 — December 9, 2025

#### Bug Fixes

* **Fixed** — The second consent layer (Layer 2) was not displaying when the CMP was opened for the first time.
* **Fixed** — The consent clearing flow was not completing correctly.

#### Improvements

* Internal logs have been updated to better reflect SDK lifecycle events, making debugging easier.

***

### Version 0.1.0-beta01 — December 5, 2025 — First Public Beta

We're excited to release the first public BETA of our new Consent Management Platform SDK. This is an early release intended for testing and integration feedback. **The API is not yet stable and may evolve — including breaking changes — in future beta updates.**

We warmly encourage you to share your feedback with us.

#### What's Included in this Release

* **SDK Initialization** — The main entry point is now available to set up and start the SDK in your application.
* **Consent UI Display** — A method to display the consent interface to your users at the right moment in your app flow.
* **Consent Status Retrieval** — You can now query whether consent has been granted for a specific vendor by ID.
* **Real-time Consent Updates** — A listener is available to receive notifications when a user updates their consent choices.
* **TCF v2.2 Compliance** — The SDK is compliant with the IAB Transparency and Consent Framework v2.2.
* **Documentation** — Initial API documentation is published and available.