Android SDK发布说明_移动研发平台-阿里云帮助中心

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

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版本说明

版本	更新说明
3.8.3	更换长连接域名修复偶发的解密失败问题升级魅族辅助通道SDK至4.2.3版本升级荣耀辅助通道SDK至7.0.39.303版本
3.8.2	增加大图标下载监控回调。在线推送支持通知折叠，配置通折叠后，多条通知可以在通知栏折叠起来。在线推送支持消息分组，设置消息分组后，手机上只会展示该组消息中的最新一条，不会展示全部消息。代码优化/修复一些偶发性Bug
3.8.1	升级华为SDK至6.7.0.300。增加校验OPPO token正确性的逻辑。修复华为注册token偶发崩溃的问题。
3.8.0	升级OPPO SDK至3.1.0版本。接入荣耀推送通道。允许子进程初始化。合规修改。日志优化。
3.7.7	升级华为SDK至6.3.0.304。升级谷歌SDK至23.0.3，升级过程中部分参数有变化，请参考Google推送通道集成重新接入SDK。代码优化。
3.7.6	调整错误码。调整关键日志。修复小米Android12通知无法打开问题。升级基础库，代码优化。
3.7.5	增加部分广播组件权限限制。
3.7.4	升级华为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	升级vivo SDK版本至3.0.0.3。支持通知样式定制。
3.7.2	适配Android 12。升级小米SDK至4.8.2。
3.7.1	减少敏感API调用。修复自有通道_ALIYUN_NOTIFICATION_MSG_ID_字段错误。降低厂商通道解析失败概率。
3.7.0	修复大图模式下，LargeIcon显示异常。细化错误码，提供更具体的错误信息。修复连接回调正常，实际连接有可能失败的问题。厂商通道上报，增加厂商通道SDK版本。推送数据增加_ALIYUN_NOTIFICATION_MSG_ID_。
3.6.0	自有通道支持服务侧大文本、大图和inbox模式配置。自有通道支持服务侧notifyId配置。 SDK侧透出推送msgId。升级华为推送SDK至5.3.0.304。升级小米推送SDK至4.8.1。升级魅族推送SDK至4.1.4。
3.5.0	支持服务下发通知右侧icon配置。
3.4.0	修改部分日志输出。修复个别机型崩溃。适配Android12。
3.3.0	调整部分敏感API调用。支持一些特殊场景。
3.2.5	修复低版本Android禁用Channel功能。修复魅族辅助通道先初始化时的异常。增加动态注册的AppKey AppSecret的接口。
3.2.4	优化SDK启动方式。提供禁用静默通道的能力。优化权限声明。优化组件声明。升级华为通道SDK到5.0.2。升级小米通道SDK到3.8.5。升级魅族通道SDK到4.0.2。
3.2.3	拆分各辅助通道SDK。辅助通道不强制继承activity。升级小米通道SDK版本到3.8.2。
3.2.2	删除不需要的权限声明。升级小米通道SDK版本到3.7.9。升级魅族通道SDK版本到3.9.7。升级OPPO通道SDK版本到2.1.0-fix。
3.2.1	修复本地服务接收数据Bug。
3.2.0	通知默认展示时间。通知默认不会合并展示。提供自定义通知。代码优化。
3.1.12	代码优化。
3.1.11	代码优化，提供设备的唯一性。
3.1.10	代码优化。

说明

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

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

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

移动推送	辅助通道	小米通道	华为通道	vivo 通道	OPPO 通道	魅族通道	Google	荣耀通道
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.2(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。