Android SDK release notes

更新时间:
复制 MD 格式

This topic describes the release history and version dependencies of the Android SDK. It also provides examples of the latest Maven dependencies and SDK package files.

SDK information

SDK name

Mobile Push

Developer

Hangzhou Alibaba Cloud Intelligence Technology Co., Ltd.

SDK package name

com.alibaba.sdk.android.push

SDK version

3.10.1

SDK update time

2025-09-12

SDK size

140 KB

SDK MD5 hash

6a67981851fa01888736bb567949c051

Privacy policy

EMAS Privacy Policy

Important

To fulfill your privacy compliance obligations and reduce the risk of violations when integrating third-party SDKs, use the latest product version from the official Alibaba Cloud documentation website. Before using Mobile Push, read the rules for processing personal information and integrate the SDK as described in Android SDK configuration (V3.0.0 and later).

SDK version dependencies

Important
  • If you use Mobile Push Android SDK 3.2.0 or later, you must also upgrade the auxiliary channel SDK to version 3.2.0 or later.

  • Starting from version 3.7.7, the Google auxiliary channel SDK requires applications to enable AndroidX and compile with Java 1.8. If you cannot enable these features, consider using version 3.7.6.

Mobile Push SDK versions

SDK version number

Update time

Update description

3.10.1

2025-09-12

  • Adapted for 16 KB memory page sizes.

  • Changed the minimum supported Android version to Android 5.0.

  • Upgraded the OPPO channel to 3.7.1.

  • Upgraded the vivo channel to 4.1.0.0.

  • Upgraded the FCM channel to 24.1.2.

  • To integrate the Honor and FCM channels, you must configure the vendor's Maven repository. For more information, see Honor channel integration and Google push channel integration.

3.9.5

2025-06-11

  • Optimized the registration logic.

  • Adapted for AndroidX.

  • Optimized the badge strategy for Xiaomi models.

  • Upgraded the Huawei channel to 6.13.0.300.

  • Upgraded the Meizu channel to 5.0.3.

  • Upgraded the OPPO channel to 3.5.3.

3.9.3

2024-12-24

  • Optimized the message deduplication policy.

  • Optimized the display policy for large icons.

3.9.2

2024-11-08

  • Added support for grouping notification messages.

  • Upgraded the Honor channel to 8.0.12.307.

  • Upgraded the vivo channel to 4.0.6.0.

  • Upgraded the Meizu channel to 5.0.2.

3.9.1

2024-08-07

  • Added support for badges on notification messages.

3.9.0

2024-05-27

  • Renamed the GCM channel to FCM.

  • Upgraded the Meizu channel to 4.3.0.

  • Upgraded the Xiaomi channel to 6.0.1.

  • Upgraded the OPPO channel to 3.5.2.

  • Upgraded the Honor channel to 7.0.61.303.

  • Upgraded the vivo channel to 4.0.0.0.

  • Upgraded the FCM channel to 23.1.2.

  • Updated the vendor channel version to 3.9.0.

3.8.8.1

2023-11-23

  • Upgraded targetSdkVersion to 30.

  • Upgraded the Meizu channel to 4.2.7.

  • Upgraded the Xiaomi channel to 5.9.9.

  • Upgraded the Huawei channel to 6.12.0.300.

  • Upgraded the OPPO channel to 3.4.0.

  • Updated the vendor channel version to 3.8.8.

3.8.7

2023-08-30

  • Upgraded the Honor channel to 7.0.61.302.

  • Upgraded the vivo channel to 3.0.0.7.

  • Upgraded the Huawei channel to 6.11.0.300.

  • Upgraded the Xiaomi channel to 5.7.8.

  • Adapted local notification categories for the Huawei channel.

3.8.6.1

2023-07-27

  • Improved stability.

3.8.6

2023-07-27

  • Upgraded the Honor channel to 7.0.41.301.

  • Upgraded the Xiaomi domestic channel to 5.6.2.

  • Added the Xiaomi international channel.

  • Disabled the internal SDK crash protection mechanism.

  • Note

    • Xiaomi domestic channel (3.8.6.1)

    • Xiaomi international channel (3.8.6.1-intl)

    • Other vendor channels (3.8.6)

3.8.5

2023-04-23

  • Performed code refactoring and improvements.

3.8.4.1

2023-03-27

  • Adapted for Android 13 notification permissions.

  • Code optimization

3.8.3

2023-02-21

  • Changed the persistent connection domain name.

  • Fixed an issue that caused occasional decryption failures.

  • Upgraded the Meizu auxiliary channel SDK to version 4.2.3.

  • Upgraded the Honor auxiliary channel SDK to version 7.0.39.303.

3.8.2

2023-01-30

  • Added a monitoring callback for large icon downloads.

  • Added support for notification collapsing for online pushes. After configuration, multiple notifications can be collapsed in the notification bar.

  • Added support for message grouping for online pushes. After you set a message group, only the latest message in that group is displayed on the device.

  • Code optimization

3.8.1

2022-12-14

  • Upgraded the Huawei SDK to 6.7.0.300.

  • Added logic to verify the correctness of OPPO tokens.

  • Fixed an issue that caused occasional crashes when registering Huawei tokens.

3.8.0

2022-10-13

  • Upgraded the OPPO SDK to version 3.1.0.

  • Integrated the Honor push channel.

  • Allowed initialization in child processes.

  • Made compliance modifications.

  • Optimized logging.

3.7.7

2022-05-07

  • Upgraded the Huawei SDK to 6.3.0.304.

  • Upgraded the Google SDK to 23.0.3. Some parameters changed during the upgrade. For more information, see Google push channel integration to reintegrate the SDK.

  • Code optimization

3.7.6

2022-04-15

  • Adjusted error codes.

  • Adjusted key logs.

  • Fixed an issue where notifications could not be opened on Xiaomi devices running Android 12.

  • Code optimization

3.7.5

2022-03-15

  • Added permission restrictions for some broadcast components.

3.7.4

2022-03-03

  • Upgraded the Huawei SDK to 6.3.0.302.

  • Upgraded the Xiaomi SDK to 4.9.1.

  • Upgraded the OPPO SDK to 3.0.0.

  • Upgraded the vivo SDK to 3.0.0.4.

  • Added listener APIs to get the status of, reconnect, and reset the push channel.

  • Added a switch for the auto-start logic of the channel process.

  • Improved the exception handling logic for the push channel.

3.7.3

2021-12-29

  • Upgraded the vivo SDK to version 3.0.0.3.

  • Added support for custom notification styles.

3.7.2

2021-12-16

  • Adapted for Android 12.

  • Upgraded the Xiaomi SDK to 4.8.2.

3.7.1

2021-11-15

  • Reduced calls to sensitive APIs.

  • Fixed an error in the _ALIYUN_NOTIFICATION_MSG_ID_ field for the proprietary channel.

  • Reduced the probability of parsing failures for vendor channels.

3.7.0

2021-11-02

  • Fixed an issue where the large icon was displayed abnormally in big picture mode.

  • Refined error codes to provide more specific error messages.

  • Fixed an issue where the connection callback was normal, but the actual connection might have failed.

  • Added the vendor channel SDK version to reports from vendor channels.

  • Pushed Data Increase_ALIYUN_NOTIFICATION_MSG_ID_

3.6.0

2021-09-27

  • Added support for server-side configuration of big text, big picture, and inbox modes for the proprietary channel.

  • Added support for server-side configuration of notifyId for the proprietary channel.

  • Exposed the push msgId on the SDK side.

  • Upgraded the Huawei Push SDK to 5.3.0.304.

  • Upgraded the Xiaomi Push SDK to 4.8.1.

  • Upgraded the Meizu Push SDK to 4.1.4.

3.5.0

2021-09-07

  • Added support for configuring the right-side icon for notifications sent from the server.

3.4.0

2021-05-25

  • Modified some log outputs.

  • Fixed crashes on some device models.

  • Adapted for Android 12.

3.3.0

2021-03-20

  • Adjusted some calls to sensitive APIs.

  • Added support for some special scenarios.

3.2.5

2021-01-13

  • Fixed an issue where the channel feature was disabled on earlier Android versions.

  • Fixed an exception that occurred when the Meizu auxiliary channel was initialized first.

  • Added an API for dynamic registration of AppKey and AppSecret.

3.2.4

2020-12-15

  • Optimized the SDK startup method.

  • Provided the ability to disable the silence channel.

  • Optimized permission declarations.

  • Optimized component declarations.

  • Upgraded the Huawei channel SDK to 5.0.2.

  • Upgraded the Xiaomi channel SDK to 3.8.5.

  • Upgraded the Meizu channel SDK to 4.0.2.

3.2.3

2020-11-13

  • Split the auxiliary channel SDKs.

  • The auxiliary channel does not need to inherit from the activity.

  • Upgraded the Xiaomi channel SDK to version 3.8.2.

3.2.2

2020-09-28

  • Removed unnecessary permission declarations.

  • Upgraded the Xiaomi channel SDK to version 3.7.9.

  • Upgraded the Meizu channel SDK to version 3.9.7.

  • Upgraded the OPPO channel SDK to version 2.1.0-fix.

3.2.1

2020-08-26

  • Fixed a bug in data reception for the local service.

3.2.0

2020-08-22

  • Set a default display time for notifications.

  • Notifications are not merged by default.

  • Provided custom notifications.

  • Performed code refactoring and improvements.

Note

For a more detailed record of updates, log on to the EMAS console and click a version number on the SDK Download page.

Auxiliary channel SDK version dependencies:

Each row lists compatible versions. Use the latest versions. Do not mix versions from different rows.

Mobile Push

Auxiliary channel

Xiaomi

channel

Huawei

channel

vivo

channel

OPPO

channel

Meizu

channel

Google

Honor

channel

3.10.1

3.10.1

3.10.1(6.0.1)

3.10.1(6.13.0.300)

3.10.1(4.1.0.0)

3.10.1(3.7.1)

3.10.1(5.0.3)

3.10.1(24.1.2)

3.10.1(8.0.12.307)

3.9.5

3.9.4.1

3.9.4.1(6.0.1)

3.9.4.1(6.13.0.300)

3.9.4.1(4.0.6.0)

3.9.4.1(3.5.3)

3.9.4.1(5.0.3)

3.9.4.1(23.1.2)

3.9.4.1(8.0.12.307)

3.9.3

3.9.2

3.9.2(6.0.1)

3.9.2(6.12.0.300)

3.9.2(4.0.6.0)

3.9.2(3.5.2)

3.9.2(5.0.2)

3.9.2(23.1.2)

3.9.2(8.0.12.307)

3.9.2

3.9.2

3.9.2(6.0.1)

3.9.2(6.12.0.300)

3.9.2(4.0.6.0)

3.9.2(3.5.2)

3.9.2(5.0.2)

3.9.2(23.1.2)

3.9.2(8.0.12.307)

3.9.1

3.9.0

3.9.0(6.0.1)

3.9.0(6.12.0.300)

3.9.0(4.0.0.0)

3.9.0(3.5.2)

3.9.0(4.3.0)

3.9.0(23.1.2)

3.9.0(7.0.61.303)

3.9.0

3.9.0

3.9.0(6.0.1)

3.9.0(6.12.0.300)

3.9.0(4.0.0.0)

3.9.0(3.5.2)

3.9.0(4.3.0)

3.9.0(23.1.2)

3.9.0(7.0.61.303)

3.8.8.1

3.8.8

3.8.8(5.9.9)

3.8.8(6.12.0.300)

3.8.8(3.0.0.7)

3.8.8(3.4.0)

3.8.8(4.2.7)

3.8.8(23.0.3)

3.8.8(7.0.61.302)

3.8.7

3.8.7

3.8.7(5.7.8)

3.8.7(6.11.0.300)

3.8.7(3.0.0.7)

3.8.7(3.1.0)

3.8.7(4.2.3)

3.8.7(23.0.3)

3.8.7(7.0.61.302)

3.8.6.1

3.8.6.1

3.8.6.1(5.6.2)

3.8.6.1(6.7.0.300)

3.8.6.1(3.0.0.4)

3.8.6.1(3.1.0)

3.8.6.1(4.2.3)

3.8.6.1(23.0.3)

3.8.6.1(7.0.41.301)

3.8.6

3.8.6

3.8.6.1(5.6.2)

3.8.6(6.7.0.300)

3.8.6(3.0.0.4)

3.8.6(3.1.0)

3.8.6(4.2.3)

3.8.6(23.0.3)

3.8.6(7.0.41.301)

3.8.5

3.8.5

3.8.5(4.9.1)

3.8.5(6.7.0.300)

3.8.5(3.0.0.4)

3.8.5(3.1.0)

3.8.5(4.2.3)

3.8.5(23.0.3)

3.8.5(7.0.39.303)

3.8.4.1

3.8.4

3.8.4(4.9.1)

3.8.4(6.7.0.300)

3.8.4(3.0.0.4)

3.8.4(3.1.0)

3.8.4(4.2.3)

3.8.4(23.0.3)

3.8.4(7.0.39.303)

3.8.4

3.8.4

3.8.4(4.9.1)

3.8.4(6.7.0.300)

3.8.4(3.0.0.4)

3.8.4(3.1.0)

3.8.4(4.2.3)

3.8.4(23.0.3)

3.8.4(7.0.39.303)

3.8.3

3.8.3

3.8.3(4.9.1)

3.8.3(6.7.0.300)

3.8.3(3.0.0.4)

3.8.3(3.1.0)

3.8.3(4.2.3)

3.8.3(23.0.3)

3.8.3(7.0.39.303)

3.8.2

3.8.2

3.8.2(4.9.1)

3.8.2(6.7.0.300)

3.8.2(3.0.0.4)

3.8.2(3.1.0)

3.8.2(4.1.4)

3.8.2(23.0.3)

3.8.2(7.0.1.103)

3.8.1

3.8.1

3.8.1(4.9.1)

3.8.1(6.7.0.300)

3.8.1(3.0.0.4)

3.8.1(3.1.0)

3.8.1(4.1.4)

3.8.1(23.0.3)

3.8.1(7.0.1.103)

3.8.0

3.8.0

3.8.0(4.9.1)

3.8.0(6.3.0.304)

3.8.0(3.0.0.4)

3.8.0(3.1.0)

3.8.0(4.1.4)

3.8.0(23.0.3)

3.8.0(7.0.1.103)

3.7.7

3.7.7

3.7.7(4.9.1)

3.7.7(6.3.0.304)

3.7.7(3.0.0.4)

3.7.7(3.0.0)

3.7.7(4.1.4)

3.7.7(23.0.3)

-

3.7.6

3.7.6

3.7.6(4.9.1)

3.7.6(6.3.0.302)

3.7.6(3.0.0.4)

3.7.6(3.0.0)

3.7.6(4.1.4)

3.7.6(17.6.0)

3.7.5

3.7.4

3.7.4(4.9.1)

3.7.4(6.3.0.302)

3.7.4(3.0.0.4)

3.7.4(3.0.0)

3.7.4(4.1.4)

3.7.4(17.6.0)

3.7.4

3.7.4

3.7.4(4.9.1)

3.7.4(6.3.0.302)

3.7.4(3.0.0.4)

3.7.4(3.0.0)

3.7.4(4.1.4)

3.7.4(17.6.0)

3.7.3

3.7.3

3.7.3(4.8.2)

3.7.3(5.3.0.304)

3.7.3(3.0.0.3)

3.7.3(2.1.0-fix)

3.7.3(4.1.4)

3.7.3(17.6.0)

3.7.2

3.7.2

3.7.2(4.8.2)

3.7.2(5.3.0.304)

3.7.2(2.9.0.1)

3.7.2(2.1.0-fix)

3.7.2(4.1.4)

3.7.2(17.6.0)

3.7.1

3.7.0

3.7.0(4.8.1)

3.7.0(5.3.0.304)

3.7.0(2.9.0.1)

3.7.0(2.1.0-fix)

3.7.0(4.1.4)

3.7.0(17.6.0)

3.7.0

3.7.0

3.7.0(4.8.1)

3.7.0(5.3.0.304)

3.7.0(2.9.0.1)

3.7.0(2.1.0-fix)

3.7.0(4.1.4)

3.7.0(17.6.0)

3.6.0

3.6.0

3.6.0(4.8.1)

3.6.0(5.3.0.304)

3.4.0(2.9.0.1)

3.6.0(2.1.0-fix)

3.6.0(4.1.4)

3.6.0(17.6.0)

3.5.0

3.4.0

3.4.0(3.8.5)

3.4.0(5.0.4.302)

3.4.0(2.9.0.1)

3.4.0(2.1.0-fix)

3.4.0(4.0.2)

3.4.0(17.6.0)

3.4.0

3.4.0

3.4.0(3.8.5)

3.4.0(5.0.4.302)

3.4.0(2.9.0.1)

3.4.0(2.1.0-fix)

3.4.0(4.0.2)

3.4.0(17.6.0)

3.3.0

3.3.0

3.3.0(3.8.5)

3.3.0(5.0.4.302)

3.3.0(2.9.0.1)

3.3.0(2.1.0-fix)

3.3.0(4.0.2)

3.3.0(17.6.0)

3.2.5

3.2.5

3.2.5(3.8.5)

3.2.5(5.0.2)

3.2.5(2.9.0.1)

3.2.5(2.1.0-fix)

3.2.5(4.0.2)

3.2.5(17.6.0)

3.2.4

3.2.4

3.2.4(3.8.5)

3.2.4(5.0.2)

3.2.4(2.9.0.1)

3.2.4(2.1.0-fix)

3.2.4(4.0.2)

3.2.4(17.6.0)

3.2.3

3.2.3

3.2.3(3.8.2)

3.2.3(2.6.3.305)

3.2.3(2.9.0.1)

3.2.3(2.1.0-fix)

3.2.3(3.9.7)

3.2.3(17.6.0)

3.2.2

3.2.2

3.7.9

2.6.3.305

2.9.0.1

2.1.0-fix

3.9.7

17.6.0

3.2.0~3.2.1

3.2.0Download

Built into the auxiliary channel

2.6.3.305

2.9.0.1

Built into the auxiliary channel

3.8.7.1

17.6.0

3.1.0~3.1.12

3.1.0Download

Built into the auxiliary channel

2.6.3.305

2.9.0.1

Built into the auxiliary channel

3.8.7.1

17.6.0

Note

Starting from version 3.2.3, the Mobile Push SDK is split into an auxiliary channel SDK (for example, com.aliyun.ams:alicloud-android-third-push:3.2.3) and vendor extension packages (for example, com.aliyun.ams:alicloud-android-third-push-huawei:3.2.3). In the table, an entry such as "3.2.3 (3.8.2)" indicates that the extension package is version 3.2.3 and depends on version 3.8.2 of the vendor channel SDK.

Latest Maven dependency examples

Mobile Push SDK Maven dependency:

implementation 'com.aliyun.ams:alicloud-android-push:3.10.1' 

Auxiliary channel SDK Maven dependencies:

// Auxiliary channel
implementation 'com.aliyun.ams:alicloud-android-third-push:3.10.1'
// Huawei dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-huawei:3.10.1'
// Xiaomi domestic channel dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-xiaomi:3.10.1'
// OPPO dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-oppo:3.10.1'
// vivo dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-vivo:3.10.1'
// Meizu dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-meizu:3.10.1'
// Google dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-fcm:3.10.1'
// Honor dependency
implementation 'com.aliyun.ams:alicloud-android-third-push-honor:3.10.1'

Latest SDK package file example

When you download the Mobile Push SDK package from the console, it contains the following files:

├── alicloud-android-push-3.10.1.aar
├── accs_sdk_taobao-4.9.1-emas.aar
├── alicloud-android-agoo-4.9.1-emas.aar
├── alicloud-android-crashdefend-0.0.6.jar
├── alicloud-android-error-1.1.0.aar
├── alicloud-android-logger-1.2.0.aar
├── alicloud-android-tool-1.0.3.aar
├── alicloud-android-utdid-2.6.0.jar
├── networksdk-3.6.0-open.jar
└── tnet4android-3.1.14.10-open-emas1.aar
Note

The auxiliary channel SDK can only be added as a Maven dependency.