Developer Console

ADM Release Notes

Release notes

The following updates have been made to Amazon Device Messaging (ADM).

Date Description
January 4, 2023 Release of Topic Based Messaging and Group Based Messaging. Details: TBM | GBM.
June 6, 2022 Official release of push notification feature. For details, see ADM Message Types.
March 18, 2022 Beta release of push notification feature. Details.
October 26, 2021 Test notification console added. Details.
September 25, 2020 Support to send high priority messages on Fire OS 7. Details.
December 13, 2019 Fix to handle crashes on Fire OS 7. Details.

Release details

This section contains details for ADM releases.

January 4, 2023 - Topic Based and Group Based Messaging

Group Based Messaging (GBM) and Topic Based Messaging (TBM) support is added to ADM. You can now use GBM API's to send messages to a group of devices in a single API call and TBM API's to send a message to multiple devices where customers choose to receive notifications for a particular topic.

March 18, 2022 - Push notifications

Amazon Device Messaging (ADM) offers push notifications (messages) that you can use to display messages about your app on a user's device. Make sure you have integrated your app with ADM before you get started with ADM messages. See ADM Message Types for more information.

October 26, 2021 - Test notifications

You can now create test notifications and send them to targeted devices. See Integrate Your App for more details.

September 25, 2020 - High priority messages on Fire OS 7

ADM has been updated to support the sending of high priority messages. ADM will attempt to deliver high priority messages even when the device is in doze mode. No changes are required on the device side. Devices that have the updated version of ADM will support ‘normal’ and ‘high’ priority messages. Changes need to be made to the service to add the priority parameter to the body of the message request. By default, the priority of messages is set to ‘normal.’ The number of 'high' priority messages an app can receive per day is limited by the app's standby bucket. Once the limit is reached, 'high' priority messages will be converted to 'normal' priority messages.

App Standby Bucket High Priority Messages
Active No limit
Working Set No limit
Frequent 10/day
Rare 5/day

December 13, 2019 - Handle crashes on Fire OS 7

The ADM SDK has been updated to version 1.1.0. You can download the ADM SDK here. This update fixes an issue that was causing apps on Fire OS 7 (such as the 2019 Fire HD 10) to crash in the background when push notifications were sent.

In previous releases, ADM used IntentService to send messages to client applications running in the background. In Fire OS 7, IntentService is subject to all the background execution limits imposed with Android 8.0 (API level 26). For example, according to Background Service Limitations in the Android documentation:

IntentService is a service, and is therefore subject to the new restrictions on background services. As a result, many apps that rely on IntentService do not work properly when targeting Android 8.0 or higher. For this reason, Android Support Library 26.0.0 introduces a new JobIntentService class, which provides the same functionality as IntentService but uses jobs instead of services when running on Android 8.0 or higher.

In order for apps to receive ADM messages while running in the background, they must use a JobIntentService. This newer class uses jobs instead of services when running on Android 8.0 or higher.

ADMMessageHandlerJobBase is a new class that will use JobIntentService to deliver messages in the background. You should use this class in place of the old ADMMessageHandlerBase. When creating an app which interacts with ADM, you should extend ADMMessageHandlerJobBase in your handler. To follow along with an example, see Implement Handling for Registration and Messages. Additionally, see also Set Up Amazon Device Messaging and Update your App Manifest, which were also updated as part of the release.

Last updated: Jan 04, 2023