尊敬的开发者，您好：
华为推出了全新的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开发者接入文档
| 服务 | HMS SDK 2.0开发者文档入口 |
帐号 | |
支付 | |
Push | |
游戏 |
注意：
2019年11月30日，Push Kit 1.0版本将全网正式下线，请您及时检测并更新到3.0版本。详细下线通知请参考Push Kit 1.0版本下线通知。
苏公安网备 32011402010933号