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:
IntentServiceis a service, and is therefore subject to the new restrictions on background services. As a result, many apps that rely onIntentServicedo not work properly when targeting Android 8.0 or higher. For this reason, Android Support Library 26.0.0 introduces a newJobIntentServiceclass, which provides the same functionality asIntentServicebut 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