For the complete documentation index, see llms.txt. This page is also available as Markdown.

Android SDK Changelog

List of updates to the Android SDK.

1.9.0

Added

  • Adds session_id on all tracked events.

Updated

  • App messages are more reliably scaled across devices and rotations

  • Tracked events now survive process death.

Fixed

  • Fixed a ConcurrentModificationException.

  • Fixed app-config cache expiry and app message run-date offset parsing.

1.8.2 & 1.7.5

  • Notification images are now decoded at the size the notification displays them, rather than at full source size.

1.8.1

Fixed

  • Notification destination routing now behaves the same whether the app was foregrounded, backgrounded, or terminated.

  • Improved delivery reliability for subscription and analytics events during network or server disruptions. Token rotations are now sent immediately.

Deprecated

  • For self-managed FirebaseMessagingService integrations, handleOnMessageReceived(message) and handleOnNewToken(token) are deprecated in favor of the Context overloads handleOnMessageReceived(context, message) and handleOnNewToken(context, token). The Context overloads are required to deliver pushes to a terminated app; the older forms cannot re-initialize a cold-started process.

1.7.4

  • Layout improvements for app messages

1.7.3

  • Added comprehensive on-device debug logging for app messages.

  • Improved reliability for recording app message impressions.

1.7.2

  • More reliably detect foregrounding/backgrounding when a user performs the Pushly ID debug sequence.

1.7.0

  • Adds support for Catalog RATE_ITEM and COMPLETE_ITEM actions. See the Catalog Documentation for more information.

1.6.1

  • Fixes sorting issue with multiple immediate app messages.

1.6.0

  • Adds support for E-Commerce VIEW_ITEM and SAVE_ITEM actions.

1.5.0

Added

  • Added support for the immediate display condition to App Messages.

1.4.3

Fixed

  • Fixed potential crashes on Android 15+ by replacing deprecated Kotlin methods with safe alternatives.

1.4.2

Fixed

  • Fixed an issue that could result in notifications not displaying when the meta field is null.

1.4.1

Fixed

  • Fixes an issue with references to the LiveActivities interface.

1.4.0

Updated

  • Updates Firebase BOM dependency to version 34.1.0.

  • Removed dependency on Firebase Messaging KTX library.

1.3.6

Fixed

  • Fix edge case where old FCM token is persisted after a new token is generated.

1.3.5

Fixed

  • Ensure the proper app icon is used.

1.3.4

Fixed

  • Additional guards against action button concurrent access; Fixes a race condition related to showing notification action buttons.

1.3.3

Fixed

  • Fixed an issue with the network detection module resulting in possible failed host checks during network requests.

1.3.2

Updated

  • Updated background permissions check frequency to better account for manual integrations and quicker subscription change response times.

1.3.1

Updated

  • Updated Live Activity ContentState with expanded Java interoperability support.

1.3.0

Added

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.

1.2.8

Added

  • Added support for PNNotification.meta fields.

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.

1.2.6

Added

  • Added Support for App Message animations.

Updated

  • Updated internal optimizations on tracked events.

1.2.5

Fixed

  • Fixed a threading issue with sending large batches of events simultaneously.

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.

1.2.3

Fixed

  • Fixed issue with App Message configuration JSON deserialization.

1.2.2

Fixed

  • Fixed issue with App Message orientation change handler.

1.2.1

Fixed

  • Fixed issue with App Message orientation change handlers in Flutter and ReactNative.

1.2.0

Added

  • Added support for App Messages.

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.

1.1.16

Updated

  • Updated internal event tracking metadata.

1.1.15

Added

1.1.14

Fixed

  • Fixed an issue with the debug service that miscounted trigger interactions.

1.1.13

Updated

  • Updated internal resource caching policies.

1.1.12

Updated

  • Expanded proguard rules.

1.1.11

Updated

  • Updated proguard rules.

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.

1.1.9

Updated

  • Moved check for subscription required check on tracked events to action enum.

1.1.8

Updated

  • Updated PNSubscriberStatus enum instantiation.

  • Updated subscriber dismissed state internal validation.

1.1.7

Fixed

  • Fixed an issue that allowed tracked events to attempt to send before SDK initialization completed.

1.1.6

Updated

  • Updated PushSDK internal singleton references.

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.

1.1.4

Fixed

  • Fixed an issue with reverting user deletion.

1.1.3

Fixed

  • Fixed an issue with permission dialog animation.

1.1.2

Added

  • Added wrapper library (ReactNative, Flutter) convenience methods for tracked events.

1.1.1

Updated

  • Updated proguard rules.

1.1.0

Added

  • Added custom notification permission dialog flow.

Updated

  • Optimized internal post SDK configuration flow.

  • Updated Java method interop coverage.

Closed Beta Releases

1.0.2

Updated

  • Updated internal CDN references.

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.

1.0.0

Initial SDK Release

Last updated