文档

Android SDK发布说明

更新时间:

本文介绍Android SDK的发布记录和版本关系,并提供最新版本Maven依赖示例和最新版本SDK包文件示例供您参考。

SDK隐私权政策及合规使用

为了帮助您落实针对您的产品集成第三方SDK产品情况所应履行的隐私合规义务、降低隐私违规风险进而实现您的产品合规运营的业务目标,请您务必确保选用阿里云文档中心官网发布的最新版本产品。在使用移动推送前,请您务必仔细了解个人信息处理规则《EMAS隐私政策》,并按照《Android SDK配置(V3.0.0及以上版本)》接入。

SDK信息

SDK名称

移动推送

开发者

阿里云计算有限公司

SDK包名

com.alibaba.sdk.android.push

SDK版本

3.9.1

SDK更新时间

2024-08-07

SDK大小

139KB

SDK MD5值

6e3699f0f1116f57eb25cf32e3e9b641

隐私政策

《EMAS隐私政策》

SDK版本关系

重要
  • 使用移动推送Android SDK 3.2.0或以上版本,需同时将辅助通道SDK版本升级到3.2.0或以上版本。

  • 移动推送Android SDK 3.2.2版本开始,移动推送SDK下载包中会包含配置使用的辅助通道SDK离线包,请在EMAS控制台下载SDK。从3.2.4版本开始,辅助通道SDK的离线包不再包含华为SDK,华为SDK仅能通过华为仓库获取。从3.6.0版本开始,辅助通道SDK的离线包不再包含魅族SDK,魅族的SDK可以从魅族官网获取。

  • 谷歌辅助通道SDK 3.7.7版本开始需要应用开启AndroidX和Java 1.8编译,如果不能开启,可以考虑使用3.7.6版本。

移动推送SDK版本说明

SDK版本号

更新时间

更新说明

3.9.1

2024-08-07

  • 推送通知消息支持角标功能

3.9.0

2024-05-27

  • gcm通道名称改成fcm

  • 魅族通道升级到4.3.0

  • 小米通道升级到6.0.1

  • oppo通道升级到3.5.2

  • 荣耀通道升级到7.0.61.303

  • vivo通道升级到4.0.0.0

  • fcm通道升级到23.1.2

  • 厂商通道版本更新到3.9.0

3.8.8.1

2023-11-23

  • targetSdkVersion升级到30

  • 魅族通道升级到4.2.7

  • 小米通道升级到5.9.9

  • 华为通道升级到6.12.0.300

  • oppo通道升级到3.4.0

  • 厂商通道版本更新到3.8.8

3.8.7

2023-08-30

  • 荣耀通道升级至7.0.61.302

  • vivo通道升级至3.0.0.7

  • 华为通道升级至6.11.0.300

  • 小米通道升级至5.7.8

  • 华为通道本地通知分类适配

3.8.6.1

2023-07-27

  • 提升稳定性

3.8.6

2023-07-27

  • 荣耀通道升级至7.0.41.301

  • 小米国内通道升级至5.6.2

  • 增加小米国际通道

  • 关闭SDK内部崩溃保护机制

  • 备注

    • 小米通道国内版(3.8.6.1)

    • 小米通道国际版(3.8.6.1-intl)

    • 其他厂商通道用(3.8.6)

3.8.5

2023-04-23

  • 代码优化

3.8.4.1

2023-03-27

  • 适配Android 13通知权限

  • 代码优化

3.8.3

2023-02-21

  • 更换长连接域名

  • 修复偶发的解密失败问题

  • 升级魅族辅助通道SDK至4.2.3版本

  • 升级荣耀辅助通道SDK至7.0.39.303版本

3.8.2

2023-01-30

  • 增加大图标下载监控回调

  • 在线推送支持通知折叠,配置通折叠后,多条通知可以在通知栏折叠起来

  • 在线推送支持消息分组,设置消息分组后,手机上只会展示该组消息中的最新一条,不会展示全部消息

  • 代码优化

3.8.1

2022-12-14

  • 升级华为SDK至6.7.0.300

  • 增加校验OPPO token正确性的逻辑

  • 修复华为注册token偶发崩溃的问题

3.8.0

2022-10-13

  • 升级OPPO SDK至3.1.0版本

  • 接入荣耀推送通道

  • 允许子进程初始化

  • 合规修改

  • 日志优化

3.7.7

2022-05-07

  • 升级华为SDK至6.3.0.304

  • 升级谷歌SDK至23.0.3,升级过程中部分参数有变化,请参考Google推送通道集成重新接入SDK

  • 代码优化

3.7.6

2022-04-15

  • 调整错误码

  • 调整关键日志

  • 修复小米Android12通知无法打开问题

  • 代码优化

3.7.5

2022-03-15

  • 增加部分广播组件权限限制

3.7.4

2022-03-03

  • 升级华为SDK至6.3.0.302

  • 升级小米SDK至4.9.1

  • 升级OPPO SDK至3.0.0

  • 升级vivo SDK至3.0.0.4

  • 新增推送通道重连、重置、状态获取监听API

  • 新增channel进程自启动逻辑的开关

  • 完善推送通道异常处理逻辑

3.7.3

2021-12-29

  • 升级vivo SDK版本至3.0.0.3

  • 支持通知样式定制

3.7.2

2021-12-16

  • 适配Android 12

  • 升级小米SDK至4.8.2

3.7.1

2021-11-15

  • 减少敏感API调用

  • 修复自有通道_ALIYUN_NOTIFICATION_MSG_ID_字段错误

  • 降低厂商通道解析失败概率

3.7.0

2021-11-02

  • 修复大图模式下,LargeIcon显示异常

  • 细化错误码,提供更具体的错误信息

  • 修复连接回调正常,实际连接有可能失败的问题

  • 厂商通道上报,增加厂商通道SDK版本

  • 推送数据增加_ALIYUN_NOTIFICATION_MSG_ID_

3.6.0

2021-09-27

  • 自有通道支持服务侧大文本、大图和inbox模式配置

  • 自有通道支持服务侧notifyId配置

  • SDK侧透出推送msgId

  • 升级华为推送SDK至5.3.0.304

  • 升级小米推送SDK至4.8.1

  • 升级魅族推送SDK至4.1.4

3.5.0

2021-09-07

  • 支持服务下发通知右侧icon配置

3.4.0

2021-05-25

  • 修改部分日志输出

  • 修复个别机型崩溃

  • 适配Android12

3.3.0

2021-03-20

  • 调整部分敏感API调用

  • 支持一些特殊场景

3.2.5

2021-01-13

  • 修复低版本Android禁用Channel功能

  • 修复魅族辅助通道先初始化时的异常

  • 增加动态注册的AppKey AppSecret的接口

3.2.4

2020-12-15

  • 优化SDK启动方式

  • 提供禁用静默通道的能力

  • 优化权限声明

  • 优化组件声明

  • 升级华为通道SDK到5.0.2

  • 升级小米通道SDK到3.8.5

  • 升级魅族通道SDK到4.0.2

3.2.3

2020-11-13

  • 拆分各辅助通道SDK

  • 辅助通道不强制继承activity

  • 升级小米通道SDK版本到3.8.2

3.2.2

2020-09-28

  • 删除不需要的权限声明

  • 升级小米通道SDK版本到3.7.9

  • 升级魅族通道SDK版本到3.9.7

  • 升级OPPO通道SDK版本到2.1.0-fix

3.2.1

2020-08-26

  • 修复本地服务接收数据Bug

3.2.0

2020-08-22

  • 通知默认展示时间

  • 通知默认不会合并展示

  • 提供自定义通知

  • 代码优化

说明

更多更新记录,请登录EMAS控制台,在SDK下载页面单击版本号查看。

辅助通道SDK版本关系说明:

每一行是匹配的版本,一般情况下请使用最新的版本。不同行的版本不能混用。

移动推送

辅助通道

小米通道国内版

小米通道国际版

华为

通道

vivo

通道

OPPO

通道

魅族

通道

Google

荣耀通道

3.9.1

3.9.0

3.9.0(6.0.1)

3.8.8(5.1.8)

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.8.8(5.1.8)

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(5.1.8)

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(5.1.5)

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-intl(5.1.1)

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.1-intl(5.1.1)

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.0下载

辅助通道内置

2.6.3.305

2.9.0.1

辅助通道内置

3.8.7.1

17.6.0

3.1.0~3.1.12

3.1.0下载

辅助通道内置

2.6.3.305

2.9.0.1

辅助通道内置

3.8.7.1

17.6.0

说明

移动推送 SDK从3.2.3版本开始,我们拆分了辅助通道SDK,分为辅助通道(比如 com.aliyun.ams:alicloud-android-third-push:3.2.3)和厂商扩展包(比如 com.aliyun.ams:alicloud-android-third-push-huawei:3.2.3),上表中“3.2.3(3.8.2)”表示扩展包的版本号是3.2.3,它所依赖的厂商通道SDK为3.8.2。

最新版本Maven依赖示例

移动推送SDK Maven依赖:

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

辅助通道SDK Maven依赖:

//华为依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-huawei:3.9.0'
//小米国内通道依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-xiaomi:3.9.0'
//小米国际通道依赖,建议使用多渠道形式,分别依赖小米国内版和小米国际版
//implementation 'com.aliyun.ams:alicloud-android-third-push-xiaomi:3.8.8-intl'
//OPPO依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-oppo:3.9.0'
//vivo依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-vivo:3.9.0'
//魅族依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-meizu:3.9.0'
//谷歌依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-fcm:3.9.0'
//荣耀依赖
implementation 'com.aliyun.ams:alicloud-android-third-push-honor:3.9.0'

最新版本SDK包文件示例

在控制台上下载移动推送SDK包,将包含以下文件:

├── alicloud-android-push-3.9.1.aar
├── alicloud-android-accs-4.8.0-emas.aar
├── alicloud-android-agoo-4.8.0-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.5.8.6-open.jar
├── tnet4android-3.1.14.10-open-fix1.aar
//以下为辅助通道需要的SDK,jar/aar方式引入时使用,具体参考辅助通道配置说明。
//注意华为SDK从5.0.2版本开始不提供离线版本,只能从华为官方仓库获取。
//魅族从4.1.4开始提供maven仓库,不再单独提供。
├── alicloud-android-third-push-3.9.0.aar
├── alicloud-android-third-push-fcm-3.9.0.aar
├── alicloud-android-third-push-huawei-3.9.0.aar
├── alicloud-android-third-push-meizu-3.9.0.aar
├── alicloud-android-third-push-oppo-3.9.0.aar
├── alicloud-android-third-push-vivo-3.9.0.aar
├── alicloud-android-third-push-xiaomi-3.9.0.aar
├── alicloud-android-third-push-honor-3.9.0.aar
├── xiaomi-push-6.0.1.aar
├── opush-3.5.2.aar
└── vivo-push-3.0.0.7.aar
└── honor-push-7.0.61.303.aar