楼主

21958发表于 2019-11-26 14:16:57
只看该作者楼主

最新HMS SDK3.0版本业务变更说明 [复制链接]

本帖最后由 胡椒2019-12-11 16:47:31 编辑

尊敬的开发者,您好:

     华为推出了全新的HMS SDK 3.0版本,此次的版本新增加了Map Kit、Location Kit、Ads Kit、Huawei Analytics Kit、Drive Kit,并且对于已有的Account Kit、In-App Purchases、Push Kit、Game Service做了特性变更,欢迎广大开发者接入。
     对于已经接入过Account Kit、In-App Purchases、Push Kit、Game Service的开发者,切换使用HMS SDK 3.0的版本涉及到一些接口兼容性的修改,请参考表1-1

    

表1-1 3.0版本变更说明:

变化点特性变更接口兼容
整体兼容性说明
变更特性:
不再提供HMSAgent接口封装,所有业务均提供原生接口调用
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
变更特性:
去掉显式调用的HMSAgent.init方法和HMSAgent.connect方法,connect由每个服务去实现,开发者无感知
1、新增/变更特性需要HMS Core 3.0及以上版本
帐号服务变化点
新增特性:
1、新增授权接口类HuaweiIdSignInClient。并提供接口:
授权:public Intent getSignInIntent()
静默授权:public Task<SignInHuaweiId> silentSignIn()
登出:public Task<Void> signOut()
取消授权:public Task<Void> revokeAccess()
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
4、新增/变更特性需要HMS Core 3.0及以上版本
变更特性:
开放HuaweiIdSignInOptions.Builder()授权参数
新增:
获取华为帐号的email: requestEmail()
获取华为帐号的openid 和 unionid: requestId()
获取华为帐号的profile: requestProfile()
获取idtoken: requestIdToken(String clientId)
废弃:
requestOpenId() 使用 requestId()替代
requestUnionId() 使用 requestId()替代
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
4、新增/变更特性需要HMS Core 3.0及以上版本
PUSH服务变化点
新增特性:
1、主题订阅/退订功能
2、发送上行消息功能
3、发送设备组消息功能
4、大文本消息样式
5、自定义通知栏图标功能
6、自定义通知栏消息铃声功能
7、通知栏消息分级功能
8、支持tag标签功能,相同的tag标签只展示最新的通知栏消息
9、HmsMessageService类处理透传消息接收,token刷新,send接口结果回调
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、EMUI10.0系统新增功能,低于EMUI10.0的设备上不支持
4、新增/变更特性需要HMS Core 3.0及以上版本
新增特性AAID:
1、HmsInstanceId--AAID体系
2、AAID申请,删除等相关接口
3、基于AAID的push token接口管理
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、新增/变更特性需要HMS Core 3.0及以上版本
变更特性:
废弃HuaweiPushApi接口
1、HuaweiPushApi.getToken废弃, 使用HmsInstanceId.getToken(String appId, String scope)接口替换
2、HuaweiPushApi.deleteToken 废弃,使用 HmsInstanceId.deleteToken(String appId, String scope)接口替换
3、HuaweiPushApi.enableReceiveNotifyMsg废弃,使用HmsMessaging.turnOnPush()/turnOffPush()接口替换
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
变更特性:
废弃PushReceiver广播
1.PushReceiver.onToken接收token方法废弃,
1)在EMUI10.0的手机上申请token调用HmsInstanceId.getToken时直接返回token结果,不再通过广播返回
2)低于EMUI10.0的手机上,调用HmsInstanceId.getToken申请时,返回值为空, token通过HmsMessageService.onNewToken(String token)返回,同时服务端token过期时也会通过onNewToken回调
2. PushReceiver.onPushMsg废弃,使用HmsMessageService.onMessageReceived(RemoteMessage message)接口替换
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
4、新增/变更特性需要HMS Core 3.0及以上版本
废弃特性:
以下接口在HMS SDK 3.0里废弃,不再提供:
HuaweiPushApi.enableReceiveNormalMsg, 透传消息由接收消息的应用自己维护开关是否处理
HuaweiPushApi.getPushState(废弃)
HuaweiPushApi.deleteTags(废弃)
HuaweiPushApi.getTags(废弃)
HuaweiPushApi.setTags(废弃)
HuaweiPushApi.queryAgreement(废弃)
PushReceiver.onPushStat(废弃)
PushReceiver.onEvent(废弃)
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、HMS SDK 2.0接口不再提供后续功能扩展。
支付服务变化点
新增特性:
1、订单服务
支持多支付渠道,同时支持PMS全球定价以及国内自定义价格商品购买方式。订单服务系统引入消耗概念,可将商品划分为可消耗的和不可消耗的,应用可以查询到用户所有未消耗商品并进行发货,同时执行消耗操作来标记商品的发货状态,有效解决掉单问题。
2、订阅服务
通过接入订阅服务,可让用户能不间断地访问应用中的内容、服务和增值功能。应用可在PMS系统上定义多组订阅商品,同时向用户开放发起订阅能力并通过相关的查询能力为用户提供对应服务,轻松维护订阅模块的功能。
3、支持沙箱调测
允许应用在接入IAP联调过程中无需真实支付就能完成端到端的测试,方便应用快速接入。
1、HMS SDK 3.0不再兼容HMS SDK 2.0,开发者如需使用3.0版本需做适配修改;
2、HMS Core 3.0兼容HMS SDK 2.0的接口调用;
3、新增/变更特性需要HMS Core 3.0及以上版本
游戏服务变化点
新增特性:
游戏内成就
1、新增/变更特性需要HMS Core 3.0及以上版本
2、如果游戏不需要接入成就,则不需要升级HMS SDK 3.0,HMS SDK 2.0还会长期可用。
变更特性:
1、HMS SDK3.0替换了原有的初始化接口init
2、游戏登录由login接口升级为帐号的SignIn/SlientSignIn接口
3、游戏应用升级接口替换为AppUpdateClient。
1、新增/变更特性需要HMS Core 3.0及以上版本


目前所有的文档入口均已切换3.0版本的开发者文档,未来HMS SDK 2.0版本还会存在较长时间,开发者访问2.0版本的接入文档请参考表1-2

表1-2 HMS SDK 2.0开发者接入文档


注意

2019年11月30日,Push Kit 1.0版本将全网正式下线,请您及时检测并更新到3.0版本。详细下线通知请参考Push Kit 1.0版本下线通知


点评
举报
楼主发表于 2019-11-28 14:56:48
只看该作者沙发

本帖最后由 胡椒2019-11-29 01:54:00 编辑

在升级3.0版本的HMS Core过程中,请仔细阅读最新指导文档,如有疑问,欢迎到本论坛发帖提问,我们将随时为您解答~

举报
发表于 2019-12-09 16:24:13
只看该作者板凳
胡椒 发表于 2019-11-28 14:56:48
在升级3.0版本的HMS Core过程中,请仔细阅读最新指导文档,如有疑问,欢迎...

请问一下华为it云绿区内网, java调Push的相关接口一直是504怎么解决?

找了it的,it说这个接口是内网,为什么会调不通呢 :  login.cloud.huawei.com/oauth2/v2/token

举报
发表于 2019-12-10 15:40:24
只看该作者地板

支付2.0文档的链接有没有问题

举报
发表于 2019-12-10 16:30:51
只看该作者5 #

举报
发表于 2019-12-11 16:28:24
只看该作者6 #

举报
发表于 2019-12-25 11:30:18
只看该作者7 #
接入推送订阅服务过程中出现错误,如何排查?
HmsMessaging.().subscribe(a).

com.huawei.hms.common.ApiException: 907122047: push server  error

举报
发表于 2019-12-26 09:48:52
只看该作者8 #

3.0接口,通过官网提供的java版SDK,推送中文的消息后,手机上收到的是乱码的,如何解决?

举报
发表于 2019-12-26 11:05:46
只看该作者9 #
thunder 发表于 2019-12-26 09:48:52
3.0接口,通过官网提供的java版SDK,推送中文的消息后,手机上收到的是乱码...

查看SDK的源码如图,如果需要传中文,需要在此行增加utf-8编码,源码中是没有加的,默认是ISO-8859-1的编码,所以不能使用中文

举报

您需要登录后才可以回帖

登录注册
发表回复