华为sdk升级指南
背景:从2020年9月16日起不推荐使用HMS Core 2.x版本SDK,华为将在2021年9月30日下架HMS Core 2.x版本的SDK,届时您的应用如果还集成2.x版本的SDK将无法上架华为应用市场。官方文档解释
1. push sdk升级说明
此次升级将华为sdk从2.x升级到5.x,2.x与5.x详细对比可以参考官方文档
1、兼容性如下
服务端2.x api --> 客户端2.x sdk(可以正常收push)
服务端2.x api --> 客户端5.x sdk(不支持)
服务端5.x api --> 客户端2.x sdk(可以正常收push)
服务端5.x api --> 客户端5.x sdk(可以正常收push)
2、建议升级步骤
1、服务端api升级到5.x
2、升级客户端sdk到5.x
3、服务端api升级到5.x说明
1、2.x升级到5.x之后,华为服务端不再接受http协议的小图片(push接口picture字段),需全部替换为https,请业务方自行检查当前业务是否在使用http协议图片,并升级到https协议
2、两种方式升级到v5版本api(2021年07月20日之后注册的app默认接口为5.x接口,无需再操作)
2.1 方式一:push接口参数控制,vendorExtra.huawei.apiVersion=5来控制,老app不传默认为2.x版本
2.2 方式二:直接联系我们将指定app直接切换到v5
3、建议观察数据是否正常,如有异常联系切回2.x,或自行切回2.x
4、升级客户端sdk到5.x
2. push sdk 5.x新特性支持
1、支持指定channelId
通过参数channelId字段控制,参考文档 服务端接入文档
2、支持华为新推出的消息自分类功能
功能介绍 官方文档
说明:分类功能并非新功能,华为智能分类早已上线很久,此次新增加自分类功能,如果华为分类正确,不建议使用,保持当前线上逻辑即可(可以通过是否有图片,声音等判断华为智能分类是否正确)push服务支持:接口见文档服务端接入文档,
通过以下字段支持自分类功能:vendorExtra.huawei.importance
另push服务支持单独对华为通道指定不同push标题和内容,通过以下字段支持
vendorExtra.huawei.huaweiTitle
vendorExtra.huawei.huaweiContent
3、其他特性见 官方文档
如有特殊需求,可以联系push服务进行支持