Upgrade to MobilePush Android SDK 9.0.0 and Later

MobilePush Android SDK version 9.x brings significant improvements over previous versions, including new interactive notification features, better delivery tracking, and enhanced inbox messaging options.

If you’re upgrading from version 7.x or 8.x to 9.x, it’s recommended to follow the sequential upgrade path: 7.x → 8.x → 8.2.x → 9.x. Skipping any of these steps can sometimes lead to compatibility issues.

SDK VersionUpgrade ToHow to Upgrade
7.x8.xUpgrade Path
8.x8.2xUpgrade Path

To upgrade to MobilePush Android SDK version 9.0.0 and later, adjust your existing implementation.

To upgrade to Android SDK version 9.0.0 and later, add the SDK as a dependency to your build.gradle file, as shown in this example.

To use the latest SDK version, replace 9.x with the latest version number available on the Change Log.

Starting from SDK version 9.0.0, we use RemoteViews to render Carousel notifications and Standard notifications with buttons defined in Content Builder. To ensure these notifications render correctly, avoid overriding the SDK’s RemoteViews implementation. Do not use NotificationCompat.Builder.setContentView, as it sometimes interferes with the SDK’s rendering.

Keep the SDK’s default mechanism of rendering the Carousel notifications and Standard notifications with buttons defined in Content Builder for optimal user experience. Additionally, to configure the action when an end user taps a button or a carousel image in a push notification, see Configure Button and Carousel Actions.

From SDK 9.0.0, url field does not always contain a url to a CloudPage for Inbox 2.0. The url field in the InboxMessage object is now Nullable. Make sure that your code handles this possibility appropriately by checking for null values before using the url field.

For more information, see Implement Inbox Messaging on Android.