Android Changelog

The latest updates to the Airship Android SDK

12.2.3 March 30, 2020

Patch release to fix missing whitelist entries for EUCS cloud site and to fix a crash in event manager.

Changes

  • Fixed ArithmeticException in EventManager due to a race condition of disabling analytics at the same time as an event upload.
  • Added Airship EUCS URLs to whitelist.

12.2.2 March 10, 2020

Patch release to fix a whitelisting issue that prevented youtube and video URLs from working properly in In-App Automation.

12.2.1 March 6, 2020

Patch release improving SDK stability.

Changes

  • Fixed NullPointerException crash in AlarmOperationScheduler
  • Fixed ClassCastException crash in JobScheduler
  • Fixed SQLExceptions crashes in In-App Automation
  • Apps with any of these issues, and apps using In-App automation are encouraged to update.

12.2.0 January 30, 2020

Minor release that adds support for number attributes, new data collection flags, and an Accengage transition module to facilitate Accengage customers upgrading to Airship.

Changes

  • Added support for number attributes.
  • Added AirshipConfigOptions#dataCollectionOptInEnabled and UAirship#setDataCollectionEnabled(boolean) to make it easier to control Airship data collection.
  • Added urbanairship-accengage module. This module migrates a device’s attributes and ID to Airship, and allows devices to receive push notifications from Accengage during the upgrade period.
  • Added option to automatically install Google’s secure network provider before any Airship request by adding metadata to the manifest with key com.urbanairship.INSTALL_NETWORK_SECURITY_PROVIDER. The network installer is required for KitKat and older devices to work with the EUCS cloud site.

12.1.1 January 16, 2020

Patch release to fix an issue with the same In-App Automation banner displaying multiple times on an activity if the activity goes through a resume/pause/resume lifecycle state without a stop. This could occur when starting an activity with NEW_TASK and CLEAR_TOP flags if the banner is already displaying. Apps that are experiencing this issue with In-App Automation should update.

Changes

  • Fixed In-App Automation banner from displaying multiple times on a single activity in certain situations.

12.1.0 December 18, 2019

Minor release that adds an accessor the In-App Automation name.

Changes

  • Added name accessor for In-App Automations.
  • Fixed a crash when specifying duplicate locale audience conditions for an In-App Automation.
  • Fixed application starting a new activity instead of resuming the current activity when launching from a notification.

10.1.4 December 13, 2019

Fixes stability issues with in-app automation.

Changes

  • Fixed a crash when specifying duplicate locale audience conditions for an In-App Automation.

9.7.3 December 13, 2019

Fixes stability issues with in-app automation.

Changes

  • Fixed a crash when specifying duplicate locale audience conditions for an In-App Automation.

12.0.0 November 15, 2019

Major release decoupling Airship channel registration from push functionality, and adding support for channel attributes, which allow key value pairs to be associated with the application’s Airship channel for segmentation purposes.

Custom channel attributes are currently a beta feature. If you wish to participate in the beta program, please complete our signup form.

Changes

  • Added a new AirshipChannel class
  • Channel related functionality in PushManager is now deprecated
  • Added a new AirshipChannel.AttributeEditor class
  • Added a new editAttributes method to AirshipChannel
  • Android compile and target SDK versions are now 29

11.0.5 September 16, 2019

Patch release to fix an issue with custom event attribution when adding a custom event through a Message Center message. Apps that add events in a Message Center message should update.

10.1.3 September 16, 2019

Patch release to fix an issue with custom event attribution when adding a custom event through a Message Center message. Apps that add events in a Message Center message should update.

11.0.4 August 30, 2019

Patch release to fix an issue with reporting the wrong push ID in the NotificationListener. Applications that rely on the notification ID should update.

9.7.2 August 30, 2019

Fixes an issue where push message could result in duplicate push notifications. Applications that are running 9.4.0 - 9.7.1 should update.

Changes

  • Fixes issue with double processing messages on older devices.

10.1.2 August 30, 2019

Patch release to fix an issue with reporting the wrong push ID in the NotificationListener. Applications that rely on the notification ID should update.

11.0.3 August 9, 2019

Patch release to fix direct open reporting for notifications when an activity is resumed from the background. Applications running 11.x should update.

Changes

  • Fixed direct open attributions for push notifications.

10.1.1 August 9, 2019

Patch release to fix direct open reporting for notifications when an activity is resumed from the background. Applications running 10.x should update.

Changes

  • Fixed direct open attributions for push notifications.

11.0.2 August 1, 2019

Patch release to fix an issue with not starting a custom activity with the intent filter action com.urbanairship.VIEW_RICH_PUSH_MESSAGE for custom MessageCenter implementations and a fix for a minor fullscreen In-App Automation style issue. Apps that have custom message center implementations should update.

Changes

  • Fixed not starting an activity for the intent action com.urbanairship.VIEW_RICH_PUSH_MESSAGE.
  • Fixed top padding on the fullscreen In-App Automation when the header is the top most element.

10.1.0 August 1, 2019

Minor release that backports changes and fixes from 11.0.2 release.

Changes

  • Updated banner in-app message adapter to make it easier to customize the banner view.
  • Fixed not starting an activity for the intent action com.urbanairship.VIEW_RICH_PUSH_MESSAGE.
  • Fixed top padding on the fullscreen In-App Automation when the header is the top most element.
  • Synchronize use of SimpleDateFormat instance across threads.

11.0.1 July 17, 2019

Patch release to fix a rare crash caused by accessing a SimpleDateFormat across multiple threads.

Changes

  • Synchronize use of SimpleDateFormat instance across threads.

11.0.0 July 11, 2019

Major release that migrates from the Android Support Libraries to the Jetpack (AndroidX) Libraries. Applications are required to migrate to Android X before using this version. For more info, see Migrating to AndroidX

Changes

  • Migrated to AndroidX.
  • Updated banner in-app message adapter to make it easier to customize the banner view.
  • Allow defining notification channel sound with a raw resource ID through XML instead of a URL.

10.0.2 June 26, 2019

Patch release to fix issues with the banner in-app message type and background location updates on Android O+.

Changes

  • Fixed banner in-app messages not dismissing when clicking the banner body.
  • Fixed banner in-app messages not auto dismissing.
  • Fixed background location updates on Android O+.

10.0.1 June 4, 2019

Patch release fixing a minor regression in AirshipNotifiationProvider when overriding small icon resources via the push API.

Changes

  • AirshipNotificationProvider defaults to the small icon specified in the PushMessage, if available.
  • AirshipNotificationProvider uses getters instead of instance variables when building its default NotificationArguments.

10.0.0 May 22, 2019

Major release that addresses new background restrictions with Android Q, includes enhancements to In-App Automation, and adds notification channel compatibility to simplify notification channel settings across Android versions.

9.x to 10.x Migration Guide

Changes

Packages

  • Removed urbanairship-sdk and urbanairship-gcm. Apps should use urbanairship-fcm and/or urbanairship-adm instead.
  • Preferences (com.urbanairhsip.preferences) have been moved into their own module urbanairship-preferences. The new preferences use the preference support library instead of the deprecated system preferences.
  • Advertising ID tracking has been moved into its own module urbanairship-ads-identifier.
  • Updated to Firebase Messaging 18.0.

Notifications

  • NotificationFactory has been deprecated and replaced with a more flexible NotificationProvider interface.
  • AirshipReceiver has been removed and replaced with 3 new listeners on the PushManager class: NotificationListener, PushListener, and RegistrationListener.
  • The notification’s push message is now available in the launched activity intent.
  • Added notification channel compat that works on Android 16 (Jellybean) and newer devices.

In-App Automation

  • Added support for localized messages.
  • Button resolution events can be generated from HTML messages via the native bridge.
  • Display coordinator architecture for more flexible custom display management.
  • There is a new, app-extendable, mechanism for caching the message’s assets.
  • Banner messages now use a view group rather than a fragment, as system fragments were deprecated in Android P.
  • Landing Pages are now scheduled as an HTML IAA.

Other

  • Updated APIs for better kotlin interop support.
  • Apps can now provide their own image loader.
  • Added DeepLinkListener to make it easier to customize deep link handling.
  • Removed styleable attribute urbanAirshipFontPath. Applications should use the Android xml font support instead.
  • Builder factory methods and from JSON methods have been normalized throughout the SDK.
  • Added OnShowMessageCenterListener that can be set on the Message Center to make it easier to perform custom message center actions.

Bug fixes

  • Fixed incorrect font in Message Center Listing.
  • Fixed an error when loading the favicon in Message Center.
  • Fixed potential ANR if notifications actions take longer than 10 seconds to complete.
  • Fixed potential resource-not-found exception on app update for legacy in-app messages when using messages with button drawables.

9.7.1 March 14, 2019

Fixed a security issue within Urban Airship SDK, that could allow trusted URL redirects in certain edge cases. All applications that are using Urban Airship SDK 9.0.0 - 9.7.0 should update as soon as possible. For more details, please email security@urbanairship.com.

9.7.0 January 22, 2019

Minor release that allows listing for Urban Airship log messages.

Changes

  • Added ability to listen for logs using a LoggerListener on the Logger class.
  • Modal, HTML in-app automation window animations are now defined in the style sheets to make them easier to override.

9.6.1 January 10, 2019

Changes

  • SDK will now catch any exceptions when attempting to post a notification. None of the notification factories provided by the SDK exhibit this behavior, but it’s possible that a custom notification factory could produce an exception.
  • Fix potential crash when attempting to register with FCM if proguard is not configured properly.
  • Fix modal In-App Automation message animations.
  • The UAWebViewClient will no longer attempt to fetch favicons.

9.6.0 December 5, 2018

Minor release that targets Android P and updates dependencies.

Changes

  • Updated compile and target SDK version 28 (Android P)
  • Updated urbanairship-core dependencies:
    • Support library version to 28.0.0
    • Optional play-services-location to 16.0.0
    • Optional play-services-ads-identifier to 16.0.0
  • Updated urbanairship-fcm dependencies:
    • firebase-messaging to 17.3.4
    • play-services-base to 16.0.1
  • Updated urbanairship-gcm dependencies:
    • play-services-gcm to 16.0.0

9.5.6 November 20, 2018

Patch release that fixes a race condition when a named user ID changes at the same time as a named user tag group update is being POSTed. Any apps that are using named user tag groups should update.

9.5.5 November 14, 2018

Patch release that fixes an issue with Autopilot. If early take off was disabled it would prevent the display of push notifications. Apps that disable early take off should update.

Changes

  • Fixed PersistableBundle NPE.
  • Fixed ChannelCapture tool sometimes throwing an exception.
  • Attempt automatic take off when receiving a new push or token from FCM.
  • Marked RichPushUser#update(boolean) as library only. Applications should not call this method. It is handled internally by the SDK.

9.5.4 October 25, 2018

Patch to fix an issue where if two in-app messages have an audience condition for the same tag group, only the newest tag group will be requested properly. Apps that use in-app automation should update.

9.5.3 October 15, 2018

Patch release that fixes displaying HTML in-app messages as full screen on smaller screen (w480dp) devices.

9.5.2 September 20, 2018

Patch release to fix build errors when building with code shrinking enabled while proguard is disabled.

9.5.1 September 11, 2018

Patch release to fix a rare NPE with banner messages in In-App Automation. Apps supporting banner messages should update to this version.

9.5.0 September 4, 2018

Minor release that adds support for tag group audiences, miss behaviors and resizable HTML messages in In-App Automation. HTML in-app messages are now displayed as dialogs by default, with an option to display fullscreen on smaller devices.

Changes

  • Added support for tag group audience conditions for in-app messages.
  • Added isReady method to InAppMessageAdapter so that adapters can wait for custom app conditions to be fulfilled before displaying
  • Fixed media layout in the modal in-app messages when using template HEADER_MEDIA_BODY.
  • Fixed videos autoplaying in an in-app message.

9.4.2 August 7, 2018

Patch release to fix proguard warnings with ADM.

Changes

  • Update proguard rules.

9.4.1 July 26, 2018

Patch release that fixes a bug in the json matcher that caused app version equality checks to malfunction. Apps that use in-app automation with version triggers or audience conditions should update.

Changes

  • Fixed JsonMatcher scope parsing.

9.4.0 July 19, 2018

Minor release that adds new NotificationFactory APIs to better handle limited background time when building notifications. This release also addresses ANRs from the GCM and ADM Broadcast Receiver that occur when notification building takes longer than 10 seconds when using a custom notification factory. To avoid the ANR, the braodcast will wait a max of 10 seconds before finishing received broadcast instead of waiting for the notification to finish. This will prevent the ANR from occurring, but the OS might kill the app before it has time to display the notification and it will be lost. To avoid this issue, either use NotificationFactory#createNotificationResult(PushMessage, int, boolean) to retry later if the notification is taking too long, or use NotificationFactory#requiresLongRunningTask(PushMessage) if the notification requires more than 10 seconds.

Changes

  • Deprecated NotificationFactory#createNotificationResult(PushMessage, int) in favor of NotificationFactory#createNotificationResult(PushMessage, int, boolean) that also tells the factory if it has longer than 10 seconds to build the notification.
  • Added listener to the Whitelist class to reject URLs.
  • Added method to generate AirshipConfigOptions from a Properties instance.
  • Fixed ANRs caused by slow notification builds in custom factories when using GCM or ADM modules.
  • Fixed issue where HTML in-app automation messages were cancelled instead being displayed.

9.3.2 June 28, 2018

Fixed an issue where if you define an end time on a automation schedule (action or in-app messages), it would mark it as expired during the next app init, even if the schedule was not still current. Any app using either action automation or in-app messages should update.

Changes

  • Fixed marking current schedules with an end time as expired.

9.3.1 June 16, 2018

Fixed issues with in-app automation not displaying due to the display being paused by default. Apps that use in-app automation should update.

Changes

  • Fixed In-app automation display being paused by default.
  • Fixed CoreActivity having a visible theme.

9.3.0 June 7, 2018

Changes

  • Added support to add custom notification action buttons from xml.
  • Added missing play-services-base dependency to urbanairship-fcm.
  • Added method to InAppMessageManager to pause display of in-app messages.
  • Locale and Timezone info is now sent up with the channel registration even if analytics are disabled.
  • Removed use of custom permissions in the manifest.

9.2.0 May 16, 2018

Minor release that includes new APIs to allow extending in-app messages before they are displayed to the user, exposes information on the ResolutionInfo, and adds a new NotificationFactory create method that allows retrying a failed notification at a later time. This release also includes fixes to the Rate App Action crashing on Marshmallow and older devices. Applications that use the rate app action should update.

Changes

  • Added message extenders to the InAppMessageManager.
  • Added a new optional createNotification method that returns status.
  • Expose type, duration, and button info on the ResolutionInfo class.
  • Fixed BuildConfig conflicts with the urbanairship-sdk module.
  • Fixed Rate App Action crashes.

9.1.1 May 14, 2018

Patch release to fix issues with proguard as well as enables fullscreen video for landing pages and message center.

Changes

  • Enable fullscreen video for landing pages and message center.
  • Added new error message when trying to display a message center message that is no longer available.
  • Fixed proguard issue.

9.1.0 April 20, 2018

Minor release that introduces support for FCM apis, modular packages, and in-app message design updates. For FCM migration, please follow the FCM Migration Guide.

Changes

  • Added support for FCM Google Play Services dependency.
  • When using urbanairship-fcm, setting the FCM sender ID in the airship config options is now optional.
  • Moved push providers into own packages - urbanairship-fcm, urbanairship-gcm, urbanairship-adm, and urbanairship-core. The package urbanairship-sdk still exists and is now just a wrapper package that depends on gcm, adm, and core to prevent breaking apps.
  • Deprecated urbanairship-sdk and urbanairship-gcm packages. They will be dropped in SDK release 10.0.
  • Updated in-app message designs.
  • Added support to display an in-app modal message as fullscreen on smaller screen devices.
  • Normalized the custom event builder APIs.
  • Added metadata option to enable local storage in Urban Airship webviews.
  • Updated to Play Services version 15.0.0 and Support Library 27.1.1. Tracking Advertising IDs now require the play-services-ads-identifier dependency.

Bug Fixes

  • Added calls to takeOff autopilot when in-app message activities are being restored when the app is suspended.
  • Fixed packages not declaring the proper dependencies in the pom file.

9.0.6 April 5, 2018

Patch release to fix an issue with delaying takeOff. Applications that make use of the isReady method may want to update.

Changes

  • Remove wait for takeOff in the PushService
  • Allow autopilot creation to be retried if the app info is unavailable

9.0.5 March 28, 2018

Patch release to fix a BadParcelableException when accessing the PushMessage from an intent’s bundle on some devices.

Changes

  • Fixed BadParcelableException when handling push messages from intents.
  • Fixed lint warnings/errors.

9.0.4 March 21, 2018

Patch release to fix a NPE due to a race condition in the in-app messaging manager and fixes an issue with cancelling in-app automation messages. Applications running older versions of SDK 9.0 should update.

Changes

  • Added proguard rule to keep Autopilot class
  • Fixed crash in the in-app automation manager.
  • Fixed issue with cancelling in-app automation messages.

9.0.3 March 14, 2018

Patch release to fix a NPE introduced in 9.0.2 when sending a notification with a button without any actions.

Changes

  • Fixed NPE in core receiver.
  • Allow custom schemes when whitelisting urls.

9.0.2 March 6, 2018

Patch release to fix an issue with background services in Android O and a background ANR when delaying takeOff. Applications that are targeting Android O and take advantage of push notification actions should update.

Changes

  • Fixed ANR when takeOff is delayed.
  • Fixed IllegalStateException when opening a push notification with actions.

9.0.1 February 13, 2018

Patch release to fix a minor display issue and data validation for in-app messaging.

Changes

  • Fixed in-app message displays when using the EXCLUDE_FROM_AUTO_SHOW flag in the manifest.
  • Added missing checks for identifier lengths for both in-app messages and message buttons.

9.0.0 February 2, 2018

Major release required for new in-app messaging capabilities.

New features

  • In-app messaging v2. The new in-app messaging module includes several different view types that are fully configurable, including modal, banner, and fullscreen. An in-app message is able to be triggered using the same rules as the Action automation module.
  • A rate app action to prompt the user to rate the application.
  • Automation schedule priority: Used to determine the execution order of schedules if multiple schedules are triggered by the same event.
  • Support for editing automation schedules.
  • New active session automation trigger. The trigger will increment its count if it has been scheduled during an active session instead of waiting for the next foreground.
  • New app version automation trigger.
  • Extended whitelist URL checking for URL loading instead of just JS bridge injection. By default these checks are disabled, but you can enable them with the AirshipConfigOptions field enableUrlWhitelisting.
  • Updated localizations.
  • Updated to Google Play Services 11.8.0 and Support Library 27.0.2.