华为HMS生态与应用开发实战

●@华为开发者联盟：HMS课程学习考证推荐书目；

●华为开发者联盟与HMSCore专家团队倾力打造，众多知名互联网公司高管及领域专家推荐；

●基于华为终端云服务多年积累的经验与技术；

●透彻理解移动生态与HMS平台与开发技术；

●掌握HMS开放能力，快速完成移动应用开发、上架与变现；

●海量配套视频免费学习、示例代码提供下载。微信关注“华章计算机”回复“HMS”免费获取。

PS：鸿蒙是一个操作系统，就是在OS层；HMS Core作为能力组件，连接App和OS。所以HMS Core就是未来连接鸿蒙和app的中间能力。没有HMS Core，鸿蒙无法支持顶层的无数App。对于鸿蒙而言，HMS Core的重要性不言而喻。

本书基于华为终端云服务多年的技术积累和对移动应用生态发展的理解，以开发者应用的“D（开发）/G（成长）/E（变现）模型”为切入点，结合HMS典型的开放能力和实际的业务场景，通过实战方式详述如何使用HMS开放能力快速完成移动应用的开发和测试上架。

同时，本书对广大开发者关心的华为HMS发展历程、HMS生态架构与开放机制以及HMS的隐私合规等话题，也一并予以阐述。

【本书内容共分12章】

第1～2章，介绍HMS生态发展历程与HMS Core生态整体架构及接入机制，帮助开发者了解移动应用生态、HMS蓝图与架构，适合所有人员阅读。

第3～11章，介绍Kit快速集成，搭建实战环境，深入讲解每个Kit的功能原理，并通过一个支撑所有Kit集成业务的场景，详解每个Kit的实战环节，包括Account Kit、IAP Kit、Push Kit、Location Kit、Map Kit、Site Kit、Safety Detect、FIDO Kit等，以帮助开发者了解如何快速接入HMS开放的各项能力。

第12章，介绍华为提供的App测试服务及华为应用市场上架过程，协助开发者快速进行应用多机型测试和上架到华为应用市场。

附录部分主要介绍客服支持、论坛、代码实验室、开发者学院以及开发者扶持计划等常见开发者服务。

★王希海：

华为终端云服务开发者联盟产品部部长，具有15年以上丰富的软件领域从业经验，华为终端HDD、HSD、HDG、HDE等生态项目创始人，消费者云服务DigiX系列赛首席评委，曾获深圳市科技进步奖。目前专注华为终端HMS开放能力的推广与布道，与全球开发者共同打造全场景智慧化终端生态。

★望岳：

华为终端云服务HMS Core平台部部长，快应用联盟的发起和倡导者之一，20余年电信领域大型管理软件、分布式中间件与平台的研发和全球交付经验。曾发表多篇电信领域专利文章并取得国际专利。目前专注于华为终端HMS Core开放能力构建，助力全球开发者的商业成功。

★吴海亮：

华为终端云服务开发者联盟首席技术专家，华为HDD和HMS开放能力首席课程讲师，10余年软件开发与架构设计经验，曾主导多个开放能力的开发项目。目前致力于HMS开放能力推广与全球开发者技术支持工作，亦作为布道师活跃于全球HMS生态发展项目。

★利益相关者是谁？创新发生在哪里？新的商业趋势是什么？华为HMS是如何做到的？我相信每一个读者通过这本书会了解到华为HMS生态的价值，也会有更好的视角去审视这些问题。

华为通过HMS Core全面开放“芯-端-云”的能力，帮助开发者实现开发、成长、变现；每一位程序员，都可以通过本书了解华为HMS生态的历程，以及HMS Core详细的开放接口和能力，从而高效地构建应用程序。我相信每一位阅读者都会非常兴奋地看到，一个真正独立自主的生态远景图被渐渐地描绘出来并实现。

—陈湘宇，深圳创梦天地科技有限公司联合创始人兼CEO

★华为作为终端和5G技术的领导者，在手机硬件领域获得了全球用户的肯定。在5G崛起的当下，华为开发者联盟和HMS Core专家团队秉承一贯的数字化创新精神，将多年积累的终端与云服务方面的技术实战经验集结成书。

本书旨在帮助全球的开发者快速完成移动应用开发，并期待广大开发者持续与HMS生态共同为全球用户创造更大的社会价值，共建生态，共享繁荣。因此，把本书推荐给广大开发者朋友，相信本书能帮助大家与用户建立更高效、细致的交互。

—王洪浩，58集团CMO

★作为华为的紧密合作伙伴，去哪儿网是最早一批集成华为HMS Core的使用者之一。旅游是一个履约链条较长的行业，涉及较多的服务环节，覆盖行前攻略搜索、产品预订、行中交通履约、酒店住宿、景点玩乐、行后游记分享等环节，整个过程中与华为HMS系统能力有非常多的结合点。通过情景智能套件的接入让用户在整个旅行过程中获得智能和周到的服务通过账户套件和消息推送套件的接入，有效地提升了用户的终端使用体验，降低了公司运营成本。相信随着HMS生态的不断发展，每一个创新都将更易于落地实现，越来越多的开发者会加入到这个队伍中，给用户提供更高效、更智能的产品和服务。

—黄小杰，去哪儿旅行CMO

★在全球化的今天，让每一个创新都能获得激励支持成为可能，因为开发者不再是一个单一的个体，而是与彼此、与平台紧密地联系在一起。华为HMS的推出，更是将几十年的技术积累开放给广大的开发者，实现了技术赋能，科技普及天下的宏伟理想。本书从生态发展、技术架构、支持体系等多个维度立体化地介绍了HMS的生态和技术，可极大地帮助开发者了解并加入华为HMS生态建设这一历史进程中。

—占雪亮，小红书增长技术负责人

●第1章　HMS生态概述 1

1.1　移动应用生态分析 1

1.1.1　移动互联网发展简介 1

1.1.2　移动应用生态发展历程 2

1.1.3 移动应用生态的价值分配 5

1.2　华为HMS生态发展历程 9

1.2.1　华为终端与云服务 9

1.2.2　HMS生态发展历程 10

1.2.3　HMS生态发展现状 13

1.3　HMS生态架构 15

1.3.1　HMS能力开放架构 15

1.3.2　HMS隐私合规架构 17

1.4　小结 19

●第2章　HMS Core整体介绍 20

2.1　HMS Core能力开放视图 20

2.1.1 开发：低成本快速构建优质应用 21

2.1.2 增长：持续提升用户量和活跃度 23

2.1.3 盈利：利用多渠道实现开发者变现 24

2.2　能力开放机制 26

2.2.1　HMS Core SDK开放模式 26

2.2.2　RESTful接口开放模式 26

2.3　能力接入授权机制 27

2.3.1　API Key使用 27

2.3.2　OAuth Client使用 29

2.3.3　Service Account使用 30

2.4　小结 33

●第3章　集成快速入手 34

3.1　注册与实名认证 34

3.1.1　注册账号 34

3.1.2　实名认证 36

3.2　开发环境搭建 40

3.3　创建宠物商城App项目 41

3.3.1　功能需求分析 42

3.3.2　创建Android项目 42

3.3.3　创建签名文件 43

3.3.4　配置签名 45

3.4　宠物商城App开发 46

3.4.1　首页开发 47

3.4.2　宠物视频功能模块开发 48

3.4.3　登录功能模块开发 49

3.4.4　账号注册功能模块开发 49

3.4.5　个人中心功能模块开发 51

3.4.6　设置功能模块开发 52

3.5　小结 53

●第4章　Account Kit开发详解 54

4.1　原理和功能分析 54

4.2　开发准备 55

4.2.1　账号注册、实名认证 56

4.2.2　创建应用 56

4.2.3　生成签名证书指纹 58

4.2.4　配置签名证书指纹 58

4.2.5　开通账号服务 60

4.2.6　集成Account SDK 60

4.3　华为账号登录 63

4.3.1　华为账号登录图标设计 63

4.3.2　ID Token模式登录 65

4.3.3　Authorization Code模式登录 73

4.3.4　静默登录 78

4.4　华为账号登出 80

4.4.1　登出业务流程 80

4.4.2　实战编码 81

4.5　华为账号取消授权 82

4.5.1　取消授权业务流程 83

4.5.2　实战编码 83

4.6　自动读取短信验证码 84

4.6.1 自动读取短信验证码业务流程 84

4.6.2　实战编码 84

4.7　小结 87

●第5章　IAP Kit开发详解 88

5.1　功能原理分析 88

5.2　开发准备 89

5.2.1　开通支付服务 90

5.2.2　集成IAP SDK 91

5.3　使用PMS创建商品 92

5.3.1　PMS功能原理 92

5.3.2　配置商品 93

5.4　购买商品 98

5.4.1　确认是否支持IAP 99

5.4.2　获取商品信息 100

5.4.3　发起支付 102

5.4.4　确认交易 104

5.4.5　帮助开发者实现补单机制 107

5.4.6　查询已购商品和订单 109

5.5　使用商品 113

5.5.1　理解订阅型商品 113

5.5.2　提供商品服务 116

5.5.3　订阅管理 120

5.6　沙盒测试 122

5.6.1　功能原理 122

5.6.2　实战操作 123

5.7　IAP Server侧功能开放 125

5.7.1　功能原理 126

5.7.2　功能实现 127

5.8　小结 143

●第6章　Push Kit开发详解 144

6.1　功能原理分析 145

6.2　开发准备 146

6.2.1　开通推送服务 146

6.2.2　集成Push SDK 147

6.3　获取Push Token 148

6.3.1　请求Push Token流程 149

6.3.2　接收Push Token流程 149

6.3.3　实战编码 150

6.3.4　快速测试 152

6.4　订阅主题 154

6.4.1　订阅主题流程 154

6.4.2　实战编码 155

6.5　AppGallery Connect推送 158

6.5.1　推送到通知栏 158

6.5.2　推送到应用 161

6.6　App Server推送 166

6.6.1　功能原理 166

6.6.2　实战编码 167

6.7　消息回执 174

6.7.1　功能原理 174

6.7.2　实战编码 175

6.8　小结 177

●第7章　Location Kit开发详解 178

7.1　功能与架构 178

7.1.1　融合定位 179

7.1.2　活动识别 180

7.1.3　地理围栏 180

7.1.4　地理编码 181

7.2　开发准备 181

7.2.1　开通定位服务 181

7.2.2　集成Location SDK 182

7.3　融合定位功能开发 182

7.3.1　配置定位权限 182

7.3.2　实战编码 183

7.4　位置模拟功能开发 186

7.4.1　选择位置模拟应用 186

7.4.2　实战编码 187

7.5　活动识别功能开发 188

7.5.1　配置活动识别权限 188

7.5.2　实战编码 189

7.6　地理围栏功能开发 192

7.6.1　创建地理围栏 192

7.6.2　实战编码 193

7.7　小结 196

●第8章　Site Kit 开发详解 197

8.1　功能原理分析 197

8.2　开发准备 198

8.3　位置搜索 201

8.3.1　关键字搜索 202

8.3.2　地点搜索建议 204

8.3.3　地点详情 206

8.3.4　周边搜索 207

8.4　地理编码 209

8.4.1　正地理编码 210

8.4.2　逆地理编码 211

8.5　获取时区 212

8.6　小结 213

●第9章　Map Kit开发详解 214

9.1　功能原理分析 214

9.2　开发准备 215

9.3　创建地图 217

9.3.1　创建地图实例 217

9.3.2　设置地图类型 221

9.3.3　设置内边距 222

9.3.4　实战编码 223

9.4　地图交互 224

9.4.1　地图相机 224

9.4.2　UI控件与手势 226

9.4.3　地图事件 229

9.5　地图绘制 232

9.5.1　标记 232

9.5.2　覆盖物 239

9.5.3　形状 240

9.5.4　瓦片图层 246

9.6　自定义地图样式 249

9.6.1　使用样例 249

9.6.2　样式参考 250

9.6.3　实战编码 251

9.7　路径规划 252

9.7.1　功能介绍 252

9.7.2　实战编码 253

9.8　小结 259

●第10章　Safety Detect开发详解 260

10.1　功能原理 260

10.2　开发准备 261

10.3　系统完整性检测 263

10.3.1　功能原理 263

10.3.2　实战编码 264

10.4　应用安全检测 270

10.4.1　功能原理 270

10.4.2　实战编码 271

10.5　恶意网址检测 272

10.5.1　功能原理 272

10.5.2　实战编码 273

10.6　虚假用户检测 275

10.6.1　功能原理 275

10.6.2　实战编码 276

10.7　小结 281

●第11章　FIDO Kit开发详解 282

11.1　功能原理分析 282

11.1.1 线上快速身份验证原理 283

11.1.2 本地生物特征认证原理 285

11.2　开发准备 285

11.3　线上快速身份认证 287

11.3.1　初始化FIDO2客户端 288

11.3.2　发起注册流程 288

11.3.3　接收注册处理结果 291

11.3.4　发起认证流程 291

11.3.5　接收认证处理结果 294

11.4　本地生物特征认证 295

11.4.1　指纹认证示例 295

11.4.2　3D面容认证示例 296

11.5　小结 297

●第12章　测试及上架 299

12.1　华为云测试服务 299

12.1.1　云测试 301

12.1.2　云调试 308

12.2　提交应用上架 315

12.2.1　登录并发布应用 315

12.2.2　应用基础信息设置 315

12.2.3　分发信息设置 317

12.2.4　提交上架确认 320

12.3　小结 320

附录　HMS生态相关概念 321　

【为什么要写这本书】

2020年6月，时值移动互联网诞生20周年，华为HMS 5.0正式面向全球发布，距4.0版本发布仅5个月时间。伴随着移动网络从2G发展到4G，20年间移动互联网发生了翻天覆地的变化，吸引了无数移动应用开发从业人员，造就了今天移动应用的“浩瀚星海”，带动移动互联网整体产业和生态圈的飞速发展。5G时代即将全面到来，未来的移动世界是什么样的，如何连接海量的终端设备，如何快速向用户提供高品质、全场景的智慧服务与体验，是每个生态建设参与者关心的问题。

华为开发者联盟2020年6月运营报表显示：华为全球注册开发者已达160万，全球集成HMS的应用数量超过8.1万。快速增长的数据背后，是华为自建HMS生态，为开发者应用成功提供完整商业模式的信心和决心。最初的HMS只具备几项基础服务能力，而今天的HMS 5.0版本已拥有50多项开放能力；为了提升开发者使用体验，HMS的架构也几经优化。越来越多的开发者已经不满足于从技术文档中学习HMS知识，迫切希望有相关书籍能够系统、深入地介绍华为生态理念，以了解HMS相关知识。因此，华为开发者联盟联合HMS研发团队及消费者云服务部分专家，倾力打造了HMS生态系列图书，《华为HMS生态与应用开发实战》是该系列图书中的一本。

本书基于作者多年在华为终端云服务方面的技术积累和对生态发展的理解，以开发者应用的“D（开发）/G（成长）/E（变现）模型”为切入点，通过实战方式向读者详细介绍如何使用HMS开放能力快速打造一款优质App，同时有效获客和快速变现。对于广大开发者关心的华为HMS发展历程、移动应用生态商业逻辑与价值分配，以及隐私合规框架等问题，书中也做了阐述。今天，华为HMS生态犹如一轮初升的红日，向全球终端用户和开发者展现出蓬勃生机与活力。我们期待更多的读者了解、熟悉并加入HMS生态，与HMS一起不断前进和成长，与我们一起共建开放、安全、共赢的生态大厦。

【本书特色】

本书是第一本系统介绍华为HMS生态的书籍，可以让开发者了解华为生态全貌，了解Kit能力及关键工具的使用，为打造优质应用奠定基础。

本书作者为华为HMS生态研发人员，内容深入浅出、系统全面，代码示例翔实。

【读者对象】

●移动应用设计、开发、测试工程师；

●移动应用生态产品、运营、营销等环节的从业者；

●移动应用生态理念传播的布道师；

●对移动应用生态未来发展趋势感兴趣的推动者、从业者和潜在的生态建设参与者；

●开设相关课程的院校师生。

【如何阅读本书】

本书内容共分12章。

●第1～2章，介绍HMS生态发展历程与HMS Core生态整体架构及接入机制，帮助开发者了解移动应用生态、HMS蓝图与架构，适合所有人员阅读。

●第3～11章，介绍Kit快速集成，搭建实战环境，深入讲解每个Kit的功能原理，并通过一个支撑所有Kit集成业务的场景，详解每个Kit的实战环节，包括Account Kit、IAP Kit、Push Kit、Location Kit、Map Kit、Site Kit、Safety Detect、FIDO Kit等，以帮助开发者了解如何快速接入HMS开放的各项能力。

●第12章，介绍华为提供的App测试服务及华为应用市场上架过程，协助开发者快速进行应用多机型测试和上架到华为应用市场。

●附录部分主要介绍客服支持、论坛、代码实验室、开发者学院以及开发者扶持计划等常见开发者服务。

如果你是一位有着一定经验的资深移动开发人员，可把本书当作案头参考书。然而，如果你是一名初学者，请在开始本书阅读之前，先学习一些Android基础开发知识。

华为地图、位置服务仅面向海外应用的开发者开放，因此本书中涉及的地图、位置功能讲解均以海外的数据进行展示。

华为HMS为移动应用的开发提供了HUAWEI DevEco Studio，但是考虑到广大开发者的使用习惯，本书以Android Studio为例进行实战讲解。读者也可以通过HUAWEI DevEco Studio来完成本书的实战演练。

需要说明的是，因为HMS软件版本的不断更新，本书中的部分配图可能与最新的软件界面有不一致的情况，敬请读者谅解。

【序一】

自2019年5月16日以来，在大量产业技术不可获得的情况下，华为处境艰难，但仍努力向前发展。美国对华为的打压，影响的不仅仅是华为，还有华为的客户和消费者。我们在尽最大努力消除不利影响。华为像一架千疮百孔的飞机，过去一年，“补洞”是我们的主旋律，其中也包括补生态的洞，这也让我们变得“皮糙肉厚”了。

我们深知，生态构建是一件极其艰难的事情，非一朝一夕之功。我们做好了“长征”的准备，坚定不移地打造全球化HMS（Huawei Mobile Services）生态，重建赛道，重启长征。过去的一年里，面对前所未有的大变局，我们无所畏惧，迎难而上，夙夜奋斗，HMS Core在短短10个月时间里实现了从能力补齐到创新领先、全面开放的跨越。截至2020年6月，华为HMS生态服务了全球超过7亿华为终端用户，华为全球注册开发者已达160万，全球集成HMS Core的应用数量超过8.1万。我们努力将各个本地化服务接入HMS生态中，为全球不同区域的消费者提供更好的服务。HMS生态逐渐繁荣，并将更加繁荣！

今天，随着万物互联的数字化智能时代扑面而来，互联网产业正在诞生新的万亿级市场，也将催生层出不穷的新业务、新应用。生态需要多样性，世界上不应该只有一种、两种生态，不应该只由一个国家来主导。我们将更加坚定地打造全球第三个智能终端生态，打造全新的、源自中国的、面向全球的HMS生态，把不可能变成可能。

我们相信未来30年人类社会必将进入万物感知、万物互联、万物智能的新世界。面向未来，华为消费者业务以全场景智慧生活战略作为长期战略，携手全球开发者和合作伙伴持续构筑开放共赢的HMS生态，让数字创新在HMS生态的黑土地上生根发芽、枝繁叶茂，共建、共筑、共享生态，共赢未来。我们将致力于实现以下几个方面。

让每一个创新都更易于落地实现。万物互联时代需要更多的创新，尤其需要大量中小企业创新来加速物理世界的数字化。我们深知，创新者比任何时候都更加迫切地呼唤全面能力开放的生态平台支撑，通过平台能力的开放，让创新者可以专注于创新本身，专注于核心能力的构建。华为是全世界唯一一家把“云-管-端-芯”全面打通的公司，同时拥有网络、终端、应用和生态能力，通过HMS Core全面、持续地开放华为的能力，让每一个创新的星光闪耀，共筑万物互联未来。

让每一个创新都能快速触达用户。面向未来的创新，最终都是为了实现数字服务智慧地服务于人，而生态平台的价值之一将体现为持续缩短数字创新与全球用户之间的链路。华为终端在全球拥有数亿用户，也在服务全球运营商渠道的数亿终端用户，以手机为中心的全场景终端覆盖了用户的衣食住行等方方面面，全球化HMS生态的各个连接平台让任何伙伴、开发者的创新数字服务，都可以在很短的时间里快速触达全球范围内的数亿乃至十几亿用户。

让每一个创新都能获得激励支持。全球范围内移动互联网的发展非常不均衡，面向未来，华为提出了TECH4ALL数字包容计划，让科技普济天下，不让任何一个人在数字世界中掉队，激励支持全世界每个角落的数字创新。通过HMS生态的共建，以及10亿美元耀星计划、大量本地化的开发者活动，我们希望促进不同区域的产业发展和促进中小企业创新，支持当地经济发展，支持当地数字主权构建，持续为全球消费者带来创新数字服务，创造更大的社会价值。

为了让更多开发者和用户认识、了解华为HMS生态并加入其建设进程，华为策划了“HMS生态系列”系列图书，旨在分享华为HMS的技术积累、知识、经验、实践以及对未来的思考，并衷心希望对开发者、技术爱好者和生态建设参与者有所帮助。欢迎大家提出宝贵的改进建议，让我们不断完善这套书。

★张平安，华为消费者云服务总裁

【序二】

作为一名曾经的开发从业者，看到这本书的出版很开心。正因为自己做过开发者，深知一款产品的产出过程中需要历经的“艰难时刻”。除去开发环节，产品上线后的获客和变现更是开发者需要探索的未知领域。本书为开发者提供了教科书式的参考，适合作为一本案头书。

华为HMS 5.0已经正式面向全球发布，为提升开发者使用体验做了很多优化，相信会有越来越多的开发者加入到华为开发者联盟中。通过本书，开发者不仅可以了解华为生态全貌，也可以通过书中翔实的代码示例，系统了解如何快速集成华为提供的各种Kit能力。本书基于作者对华为终端云服务的多年技术积累，以实战方式向开发者详细介绍如何使用HMS的开放能力。

华为终端在全球拥有数亿用户，以手机为中心的全场景终端覆盖了用户衣食住行等生活的各个方面。华为HMS让每一个创新都能快速触达用户，开发者在这本书的帮助下，能够利用好HMS的开放能力和工具，提高开发效率，更有效地获客和变现。

移动互联网发展20年以来，吸引了无数的移动应用开发者加入。到2020年上半年，华为全球注册开发者已达160万，全球集成HMS的应用数量已超过8.1万。华为HMS向全球开发者展现出蓬勃的生机和活力。

让每一个创新都能快速触达用户是华为HMS的目标。本书是华为HMS赋能开发者的教材，希望开发者能够从中受益，在未来的移动世界中构建出更多的创新应用，向用户提供高品质、全场景的智能服务与体验。

快手也是华为生态中众多移动应用中的一个。最初的设想是把快手做成一个连接器，连接的不是名人，也不是明星，而是普通人，是容易被忽略的大多数。今天的快手已经连接了数亿用户，通过有温度的科技提升着每个用户独特的幸福感。

期待更多开发者加入华为HMS生态中，期待华为移动生态中出现更多的创新应用。

★程一笑，快手创始人

【序三】

在线化和智能化是时代的大趋势，我们正处在通往在线化的中间节点。在移动互联时代，我们已经看到无数的服务在线化，无数的人和网络相连，人们的生活获得了极大的便利。移动互联时代，每一个充满生命力的个体都离不开平台的赋能，而成就平台生态的核心在于提供好的土壤和养分，本书的出版意味着华为已经为开发者们准备了充足的土壤和养分，为数字服务的百花齐放做好了准备。

喜马拉雅有幸作为HMS生态的受益者之一，通过华为累计服务了3500多万用户。从人们生活的多个场景切入，从手机预装到智能终端，甚至从国内到国外，华为从各个角度为喜马拉雅在全世界的普及提供了加速器。

国际局势瞬息万变，但全球化的大势不会变，我们相信在华为HMS的赋能下，中国的开发者在出海时能够少走很多弯路，对不同国家和地区的人群实现更有效的触达，更快实现用户发展闭环和商业闭环。相信在HMS生态的赋能下，会有一个又一个改变世界的灵感从想象变成现实，让越来越多的人享受数字时代的服务。

★余建军，喜马拉雅CEO