> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/integration/implementation-steps/android/android-sdk-changelog.md).

# Android SDK Changelog

{% updates format="full" %}
{% update date="2026-06-23" %}

## 1.7.3

* Added comprehensive on-device debug logging for app messages.
* Improved reliability for recording app message impressions.
  {% endupdate %}

{% update date="2026-05-19" %}

## 1.7.2

* More reliably detect foregrounding/backgrounding when a user performs the Pushly ID debug sequence.
  {% endupdate %}

{% update date="2026-03-12" %}

## 1.7.0

* Adds support for Catalog `RATE_ITEM` and `COMPLETE_ITEM` actions. See the [Catalog Documentation](/integration/implementation-steps/apple-ios/sdk-swift-obj-c/e-commerce-support.md) for more information.
  {% endupdate %}

{% update date="2026-02-17" %}

## 1.6.1

* Fixes sorting issue with multiple immediate app messages.
  {% endupdate %}

{% update date="2025-11-05" %}

## 1.6.0

* Adds support for E-Commerce `VIEW_ITEM` and `SAVE_ITEM` actions.
  {% endupdate %}

{% update date="2025-10-14" %}

## 1.5.0

#### Added

* Added support for the **immediate** display condition to [App Messages](/platform/app-messages.md).
  {% endupdate %}

{% update date="2025-10-03" %}

## 1.4.3

#### Fixed

* Fixed potential crashes on Android 15+ by replacing deprecated Kotlin methods with safe alternatives.
  {% endupdate %}

{% update date="2025-09-25" %}

## 1.4.2

#### Fixed

* Fixed an issue that could result in notifications not displaying when the `meta` field is `null`.
  {% endupdate %}

{% update date="2025-08-25" %}

## 1.4.1

#### Fixed

* Fixes an issue with references to the LiveActivities interface.
  {% endupdate %}

{% update date="2025-08-25" %}

## 1.4.0

#### Updated

* Updates Firebase BOM dependency to version `34.1.0`.
* Removed dependency on Firebase Messaging KTX library.
  {% endupdate %}

{% update date="2025-08-05" %}

## 1.3.6

#### Fixed

* Fix edge case where old FCM token is persisted after a new token is generated.
  {% endupdate %}

{% update date="2025-07-31" %}

## 1.3.5

#### Fixed

* Ensure the proper app icon is used.
  {% endupdate %}

{% update date="2025-03-17" %}

## 1.3.4

#### Fixed

* Additional guards against action button concurrent access; Fixes a race condition related to showing notification action buttons.
  {% endupdate %}

{% update date="2025-02-05" %}

## 1.3.3

#### Fixed

* Fixed an issue with the network detection module resulting in possible failed host checks during network requests.
  {% endupdate %}

{% update date="2025-01-27" %}

## 1.3.2

#### Updated

* Updated background permissions check frequency to better account for manual integrations and quicker subscription change response times.
  {% endupdate %}

{% update date="2025-01-23" %}

## 1.3.1

#### Updated

* Updated Live Activity ContentState with expanded Java interoperability support.
  {% endupdate %}

{% update date="2025-01-21" %}

## 1.3.0

#### Added

* Added support for [Live Activities](/integration/implementation-steps/android/sdk-kotlin-java/live-activities.md) on Android.

#### Updated

* Updates `PNNotification.meta` structure to allow more developer friendly value access patterns.

#### **Live Activities**

* `PushSDK.LiveActivities.start(activityId: String, handler: String, contentState: ContentState)`
  * Locally starts a Live Activity notification and registers the current subscriber to receive updates for the provided `activityId` and `handler` combination.
* `PushSDK.LiveActivities.register(handler: PNLiveActivityHandler)`
  * Registers the provided `handler` for remote start capability and automatically handles update registrations when an activity is started via push.
* `PushSDK.LiveActivities.remove(activityId: String)`
  * Ends the Live Activity notification and removes it from view.
* `PushSDK.LiveActivities.removeAll()`
  * Ends all active Live Activity notifications and removes them from view.
    {% endupdate %}

{% update date="2024-12-11" %}

## 1.2.8

#### Added

* Added support for `PNNotification.meta` fields.
  {% endupdate %}

{% update date="2024-11-25" %}

## 1.2.7

#### Updated

* Updated permissions background worker to better handle Android pre 33.
* Updated internal tracked event categorizations.

#### Fixed

* Fixed tracked event priority header value encoding.
  {% endupdate %}

{% update date="2024-07-17" %}

## 1.2.6

#### Added

* Added Support for App Message animations.

#### Updated

* Updated internal optimizations on tracked events.
  {% endupdate %}

{% update date="2024-05-13" %}

## 1.2.5

#### Fixed

* Fixed a threading issue with sending large batches of events simultaneously.
  {% endupdate %}

{% update date="2024-04-23" %}

## 1.2.4

#### **Added**

* Added session heartbeat support.
* Added application version tracking.

#### **Updated**

* Updated internal event meta structure.
* Updated PushNotification pause and resume event tracking priority.
  {% endupdate %}

{% update date="2024-03-15" %}

## 1.2.3

#### Fixed

* Fixed issue with App Message configuration JSON deserialization.
  {% endupdate %}

{% update date="2024-03-11" %}

## 1.2.2

#### Fixed

* Fixed issue with App Message orientation change handler.
  {% endupdate %}

{% update date="2024-03-07" %}

## 1.2.1

#### Fixed

* Fixed issue with App Message orientation change handlers in Flutter and ReactNative.
  {% endupdate %}

{% update date="2024-03-04" %}

## 1.2.0

#### **Added**

* Added support for App Messages.
  {% endupdate %}

{% update date="2024-02-16" %}

## 1.1.17

#### **Added**

* Added support for pausing and resuming subscriber push notifications.

#### **New Properties and Methods**

* `PushSDK.PushNotifications.isPaused` - A boolean property indicating the subscriber's notifications are currently paused or not.
* `PushSDK.PushNotifications.pause()` - Will pause a subscriber's ability to receive notifications.
* `PushSDK.PushNotifications.resume()` - Will resume a subscriber's ability to receive notifications.

#### **Moved / Deprecated Properties and Methods**

* `PushSDK.UserProfile.isSubscribed` has been moved to `PushSDK.PushNotifications.isSubscribed` and will now display a deprecation warning.
* `PushSDK.UserProfile.isEligibleToPrompt` has been moved to `PushSDK.PushNotifications.isEligibleToPrompt` and will now display a deprecation warning.
* `PushSDK.showNativeNotificationPermissionPrompt()` has been aliased to `PushSDK.PushNotifications.showPermissionPrompt()`.
* `PushSDK.UserProfile.revertUserDeletion` will now warn and will be removed in a future release.
  {% endupdate %}

{% update date="2023-10-19" %}

## 1.1.16

#### **Updated**

* Updated internal event tracking metadata.
  {% endupdate %}

{% update date="2023-10-18" %}

## 1.1.15

#### **Added**

* Added support for [managed integrations](/integration/implementation-steps/android/advanced/self-managed-integration.md).
  {% endupdate %}

{% update date="2023-09-18" %}

## 1.1.14

#### Fixed

* Fixed an issue with the debug service that miscounted trigger interactions.
  {% endupdate %}

{% update date="2023-08-29" %}

## 1.1.13

#### **Updated**

* Updated internal resource caching policies.
  {% endupdate %}

{% update date="2023-08-16" %}

## 1.1.12

#### Updated

* Expanded proguard rules.
  {% endupdate %}

{% update date="2023-08-08" %}

## 1.1.11

#### Updated

* Updated proguard rules.
  {% endupdate %}

{% update date="2023-07-26" %}

## 1.1.10

#### **Added**

* Added a convenience service for copying the PushSDK Anonymous ID based on specific user interaction.
* Added package name to tracked events for better user segmentation capabilities.
  {% endupdate %}

{% update date="2023-05-26" %}

## 1.1.9

#### Updated

* Moved check for subscription required check on tracked events to action enum.
  {% endupdate %}

{% update date="2023-05-18" %}

## 1.1.8

#### Updated

* Updated `PNSubscriberStatus` enum instantiation.
* Updated subscriber dismissed state internal validation.
  {% endupdate %}

{% update date="2023-05-01" %}

## 1.1.7

#### Fixed

* Fixed an issue that allowed tracked events to attempt to send before SDK initialization completed.
  {% endupdate %}

{% update date="2023-04-19" %}

## 1.1.6

#### Updated

* Updated PushSDK internal singleton references.
  {% endupdate %}

{% update date="2023-04-17" %}

## 1.1.5

#### Fixed

* Fixed a critical issue that caused a crash when notification interaction occurred while app was running in background and activity intent was no longer in context.
  {% endupdate %}

{% update date="2023-03-16" %}

## 1.1.4

#### Fixed

* Fixed an issue with reverting user deletion.
  {% endupdate %}

{% update date="2023-03-14" %}

## 1.1.3

#### Fixed

* Fixed an issue with permission dialog animation.
  {% endupdate %}

{% update date="2023-03-13" %}

## 1.1.2

#### Added

* Added wrapper library (ReactNative, Flutter) convenience methods for tracked events.
  {% endupdate %}

{% update date="2023-09-18" %}

## 1.1.1

#### Updated

* Updated proguard rules.
  {% endupdate %}

{% update date="2023-03-06" %}

## 1.1.0

#### Added

* Added custom notification permission dialog flow.

#### Updated

* Optimized internal post SDK configuration flow.
* Updated Java method interop coverage.
  {% endupdate %}
  {% endupdates %}

### Closed Beta Releases

{% updates format="full" %}
{% update date="2023-02-10" %}

## 1.0.2

#### Updated

* Updated internal CDN references.
  {% endupdate %}

{% update date="2023-01-24" %}

## 1.0.1

#### Added

* Added default notification small icon for use when not provided via the notification request.

#### Updated

* Expanded automatic badge clearing capability for more Android versions.
* Optimized HTTP request handling and network availability checks.

#### Fixed

* Fixed an issue with notification small icon transparency handling.
* Fixed an issue that could cause multiple invocations of permission request.
  {% endupdate %}

{% update date="2022-12-21" %}

## 1.0.0

#### Initial SDK Release

{% endupdate %}
{% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.pushly.com/integration/implementation-steps/android/android-sdk-changelog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.