ADM Release Notes
Release notes
The following is a list of updates for 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 added to ADM.
- With Group-Based Messaging, you can send messages to a group of devices in a single API call.
- With Topic-Based Messaging, you can 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 now supports sending high priority messages. ADM attempts 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 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. After the limit is reached, 'high' priority messages are 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 caused apps on Fire OS 7 (such as the 2019 Fire HD 10) to crash in the background when sending push notifications.
In previous releases, ADM used IntentService to send messages to client apps 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.
For apps to receive ADM messages when 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 uses JobIntentService to deliver messages in the background. Use this class in place of the old ADMMessageHandlerBase. When creating an app that 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 Set Up Amazon Device Messaging and Update your App Manifest, which were also updated as part of the release.
Last updated: Jan 04, 2023
