Android Changelog

Patch release that fixes a crash in PushManager.onTokenChanged, introduced in release 19.6.0. Apps should skip release 19.6.0 and 19.6.1 and update directly to this version, or later.

Changes

• Fixed nullability of oldToken in PushManager.onTokenChanged.

Patch release that fixes a crash with NPS scores within a Scene that uses branching. Apps planning on using the upcoming branching feature should update.

Changes

• Fixed crash with a branching Scene with an NPS widget.

Minor release adding branching and SMS support for Scenes.

Changes

• Added support for branching in Scenes.
• Added support for phone number collection and registration in Scenes.
• Added support for setting JSON attributes for Channels and Contacts.
• Added a new mutationsFlow to AddTagsAction and RemoveTagsAction to expose tag mutations when applied.
• Updated Message Center Inbox to refresh messages on app foreground.

Patch release with fix for regression in Contacts that could cause a failure to resolve a Contact ID when Contacts are disabled.

Changes

• Fixed Contact ID resolution when contacts are disabled.

Minor release that adds a public method Inbox.deleteAllMessages() and remove restrictions for subclassing MessageWebView and MessageWebViewClient.

Changes

• Added a new public method Inbox.deleteAllMessages() to delete all messages from Message Center.
• Removed library group restrictions on MessageWebView and MessageWebViewClient.

Minor release that adds support for Custom View in Scenes and fixes Privacy Manager issues when disabling all features.

Changes

• Added Custom View support to enable showing App managed views within a Scene.
• Fixed an issue where the Privacy Manager sent multiple opt-out requests after features were disabled following being enabled.

Minor release that fixes an issue with modal Scenes and adds support for hoisting AirshipEmbeddedViewGroup composable state. Apps that make use of Scenes should update to this version or greater.

Changes

• Fix a potential crash when displaying a modal Scene
• Added support for hoisting AirshipEmbeddedViewGroup composable state

Patch release to fix a casting exception with Embedded Content.

Changes

• Fixed exception due to a bad cast when using Embedded Content.

Patch release to fix a casting exception with Embedded Content.

Changes

• Fixed exception due to a bad cast when using Embedded Content.

Minor release that includes improvements for Scenes and Feature Flags.

Changes

• Added a fade transition for Scenes
• Added support for email registration in Scenes
• Fixed issues with autoplay videos in Scenes
• Improved image download and scaling logic
• Fixed an issue with image pre-caching when unable to successfully download an image
• Expose rule refresh status for Feature Flags

Minor release that updates AndroidX libraries. A compileSdk of 35+ is required.

Changes

• Updated several AndroidX dependencies
• Updated to Kotlin 2.x

Minor release that fixes an issue with embedded view sizing in scrolling views, improves Message Center accessibility, and replaces usages of Random with SecureRandom. Apps that make use of Embedded Content or Message Center should update.

Changes

• Fixed an issue with embedded sizing in scrolling views
• Improved Message Center Accessibility
• Replaced usage of Random with SecureRandom
• Made MessageWebView and MessageWebViewClient both public and open for subclassing
• Exposed Message Center ViewModel state via LiveData, in addition to Kotlin Flows
• Added PendingResult based methods to Inbox, for getting read and unread message counts and listing all message IDs

Major release that adds support for Android 15 (API 35) and updates Message Center and Preference Center to use Material 3. Breaking changes in Message Center are included in this release. See the Migration Guides  for more info.

Changes

• The Airship SDK now requires compileSdk version 35 (Android 15) or higher, and minSdk version 23 (Android 6) or higher.
• Migrated Message Center APIs to Kotlin, using asynchronous access patterns. New suspend functions and Flows have been added for Kotlin, and Java APIs have been updated to use PendingResult or callbacks.
• Rewrote the provided Message Center UI to follow modern Android UI conventions, use Material 3 theming, and support edge-to-edge mode for Android 15.
• Updated Preference Center to use Material 3 theming and support edge-to-edge mode for Android 15.
• Added Feature.FEATURE_FLAGS to PrivacyManager to control enablement of feature flags.
• Added support for wrapping score views in Scenes.
• Added support for Feature Flag experimentation.

Minor release that updates how Feature Flags are resolved, improves Scene rendering on Android 15, and fixes potential exceptions related to PermissionsManager and PermissionDelegates.

Changes

• Added resultCache to FeatureFlagManager. This cache is managed by the app and can be optionally used when resolving a flag as a fallback if the flag fails to resolve or if the flag rule set does not exist.
• FeatureFlag resolution will now resolve a rule set even if the listing is out of date.
• Improved Scene rendering on Android 15, for scenes that do not ignore safe areas.
• Prevent potential “Already resumed” exceptions that could be caused by a permission delegate calling the callback multiple times.
• Improved constraint version matching

Minor release that includes various improvements to scenes, data management and some minor bug fixes.

Changes

• Added support to mark a label as a heading in Scenes.
• Improved live update database handling to mitigate rare filesystem crashes.
• Improved automation store to avoid query limits.

Patch release that fixes an issue with Embedded Views being impacted by certain App theme customizations, avoids a potential NPE related to network failures, and adds more useful logging around Feature Flag evaluation.

Changes

• Prevent App-level theme customizations from impacting Embedded Views
• Avoid a potential NPE related to network failures, when no error body is present
• Improved logging around Feature Flag evaluation

Patch release that fixes an issue with pausing and resuming In-App Automations and avoids a potential crash in the Automation database.

Changes

• Fixed an issue with AutomationEngine.setEnginePaused(...) that could prevent message displays when paused an then un-paused
• Fixed a potential crash in Automation DB if 1000+ rows are present in the schedules table

Minor release with several enhancements to Scenes and In-App Automations.

Changes

• Added shadow support for modal Scenes
• Added new Scene layout to allow adding actions to anything within a Scene
• Added new AirshipEmbeddedViewGroup composable to make it possible to show a carousel of embedded views for the same embedded ID
• Improved accessibility of scene story indicator. Indicator has been updated to make it obvious which page is active by reducing the height of the inactive pages. Previously this was conveyed only through color
• improved accessibility for In-App Automation views
• Fixed issue with FCM registration if the FCM application is not configured before Airship starts, causing launch notifications to be ignored

Patch release that fixes a potential crash when displaying In-App Automation messages, improves WebView security, and improves accessibility in Scenes and Stories. Apps that make use of In-App Automation, Landing Pages, or Message Center should update.

Changes

• Fix a potential crash when displaying In-App messages
• Explicitly disallow file and content access in all WebViews
• Accessibility improvements for Scenes and Stories

Patch release that improves markdown support in Scenes and fixes for automation display interval and frequency limit handling. Apps that make use of markdown in Scenes, or automations with display intervals or frequency limits should update.

Changes

• Improve markdown support in Scenes, including better handling of newlines in the input text.
• Fixed automation display interval and frequency limit handling.

Patch release that fixes modal IAA border radius and fixes scenes with wide images.

Changes

• Fixed modal IAA border radius.
• Fixed scenes with wide images.

Minor release that adds a new method enableUserNotifications(PermissionPromptFallback) on PushManager.

Changes

• Added a enableUserNotifications(PermissionPromptFallback) method on PushManager that will attempt to enable notifications and use the fallback if the permission is denied.

Minor release with several enhancements to In-App Automation, Scenes, and Surveys. This version also contains a fix for applications that are targeting API 35.

Changes

• Updated compose bom to 2024.06.00.
• Replaced the usage of removeFirst to avoid crashes when targeting API 35.
• Added ability to customize the content per In-App Automation with the new InAppMessageContentExtender.
• Added plain markdown support for text markup in Scenes.
• Added execution window support to In-App Automation, Scenes, and Surveys.
• Updated handling of priority for In-App Automation, Scenes, and Surveys. Priority is now taken into consideration at each step of displaying a message instead of just sorting messages that are triggered at the same time.
• Updated handling of long delays for In-App Automation, Scenes, and Surveys. Delays will now be preprocessed up to 30 seconds before it ends before the message is prepared.

Patch release that fixes in-app experience displays when resuming from a paused state. Apps that use in-app experiences are encouraged to update.

Changes

• Fixed Automation Engine updates when pause state changes.

Patch release that fixes test devices audience check and holdout group experiments displays.

Changes

• Fixed test devices audience check.
• Fixed holdout group experiment displays.

Patch release that includes bug fixes for Embedded Content.

Changes

• Fixed an issue with dismissing Embedded Content after pausing and resuming the app.
• Updated the default PreferenceCenterFragment to scope the PreferenceCenterViewModel to the fragment’s view lifecycle.

Patch release that includes bug fixes for Embedded Content and Preference Center, and accessibility improvements for Message Center.

Changes

• Fixed an issue with container child item measurement in Scenes, when margins were set on the container items.
• Fixed a Preference Center bug that could lead to subscription channel chips not being visible when initially displaying a Preference Center.
• Fixed dismissing multiple embedded views in the same session.
• Fixed an issue with automation trigger state not correctly persisting across sessions.
• Message Center accessibility improvements.
• Updated the default style for the pull to dismiss view in In-App Message Banners to better match iOS.

Patch release that includes fixes for Preference Center.

Changes

• Fixed warning message on preference center email entry field.
• Fixed country code listing.

Patch release that includes fixes for Preference Center, Privacy Manager, and Embedded Content.

Changes

• Fixed a Preference Center issue that caused contact subscription toggles to show the incorrect state after being toggled
• Fixed test dependency being included in the automation module
• Fixed Embedded Content impression event interval
• Fixed privacy manager crash when enabling, disabling, or setting an empty set of features
• Contact channel listing is now refreshed on foreground and from a background push

Minor SDK release that fixes a potential crash related to analytics during app init and adds public builders for modifying InAppMessage and AutomationSchedule objects via extenders set onLegacyInAppMessaging.

Changes

• Fixed a potential crash related to analytics during app init
• Added builders for modifying InAppMessage and AutomationSchedule objects via extenders set on LegacyInAppMessaging

Major SDK release with several breaking changes. See the Migration Guides  for more info.

Changes

• The Airship SDK now requires compileSdk version 34 (Android 14) or higher.
• New Automation module
  • Check schedule’s start date before executing, to better handle updates to the scheduled start date
  • Improved image loading for In-App messages, Scenes, and Surveys
  • Reset GIF animations on visibility change in Scenes and Surveys
  • Pause Story progress while videos are loading
  • Concurrent automation processing to reduce latency if more than one automation is triggered at the same time
  • Embedded Scenes & Survey support
  • New module urbanairship-automation-compose to support embedding a Scene & Survey in compose
  • Added new compound triggers and IAX event triggers
  • Ban lists support
• Added new PrivacyManager.Feature.FEATURE_FLAGS to control access to feature flags
• Added support for multiple deferred feature flag resolution
• Added contact management support in preference centers
• Migrated to non-transitive R classes
• Removed urbanairship-ads-identifier and urbanairship-preference modules

Initial alpha release of SDK 18.0.0. This version is not suitable for a production app, but we encourage testing out the new APIs and providing us feedback so we can make changes before the final SDK 18 release.

The Airship SDK now requires compileSdk version 34 (Android 14) or higher.

Changes

• Improved image loading for In-App messages, Scenes, and Surveys
• Reset GIF animations on visibility change in Scenes and Surveys
• Pause Story progress while videos are loading
• Migrated to non-transitive R classes
• Check schedule’s start date before executing, to better handle updates to the scheduled start date
• Removed urbanairship-ads-identifier and urbanairship-preference modules

See the Migration Guide  for further details.

Patch release that improves first run display times for Scenes, Surveys, and In-App Automations.

Changes

• Fixed checking for channel ID being created when preparing a IAX to display causing messages to be delayed late on first run.
• Experiments and IAX that use either personalization or server side segmentation will now block and wait for the channel to become available instead of retrying after 30 seconds.
• Fixed server side segmentation & personalization for the device property app version to use the version name instead of the version code for IAX and Feature Flags. This was a regression introduced in 17.0.0. The local audience app version selector will continue to use version code.

Initial alpha release of SDK 18.0.0. This version is not suitable for a production app, but we encourage testing out the new APIs and providing us feedback so we can make changes before the final SDK 18 release.

The Airship SDK now requires compileSdk version 34 (Android 14) or higher.

Changes

• Improved image loading for In-App messages, Scenes, and Surveys
• Reset GIF animations on visibility change in Scenes and Surveys
• Pause Story progress while videos are loading
• Migrated to non-transitive R classes
• Check schedule’s start date before executing, to better handle updates to the scheduled start date
• Removed urbanairship-ads-identifier and urbanairship-preference modules

See the Migration Guide  for further details.

Minor release that fixes potential crashes when evaluating experiments before a Channel ID has been created. Apps that make use of experiments or holdout groups should update to this version or later.

Changes

• Avoid NPE in ExperimentManager when evaluating experiments before a Channel ID has been created.

Patch release that fixes a potential crash on Android 13 (API 33) channel ID creation delay after enabling a feature when none was enabled. The SDK will new create the channel ID without having to relaunch the app. Apps that have no features enabled at launch should update to this version or later.

Changes

• Fixed channel ID creation delay after enabling a feature when none was enabled.
• Fixed a potential NPE when reading from intent extras on API 33.

Patch release that adjusts locale targeting behavior for In-App Automation and messaging. The SDK will now check the device’s primary language against the target locale, instead of checking whether any user selected languages match the target locale.

Changes

• Adjust locale targeting behavior to only consider the primary locale selection.

Patch release that fixes an issue with message limits not being respected in certain cases. Apps that make use of limits should update to this version or later.

Changes

• Fixed message limits not being respected in certain cases.
• Improvements for images and GIFs in Surveys and Scenes.

Patch release that fixes an issue with message limits not being respected in certain cases. Apps on SDK v16 that make use of limits should update to this version or the latest 17.x release.

Changes

• Fixed message limits not being respected in certain cases.