30天App开发从0到1：APICloud移动开发实战.pdf
http://www.100md.com
2020年4月1日
 |
| 第1页 |
 |
| 第6页 |
 |
| 第18页 |
 |
| 第26页 |
 |
| 第40页 |
 |
| 第134页 |
参见附件(13418KB，326页)。
30天App开发从0到1：APICloud移动开发实战，这是一本针对App开发相关的教程书籍，书中围绕着APICould来进行讲述，为开发人员更全面了解到一APICould移动开发技术。
介绍
本书围绕APICloud平台，全面、系统、细致地讲述了App开发的相关内容，涉及平台工作原理、内部实现机制和应用开发技巧。本书涵盖了APICloud应用开发的知识，包括基础知识、关键技术、开发技巧和行业方案，并从实践角度出发，通过大量的实例代码、详细的操作步骤和丰富的开发截图，帮助开发人员迅速掌握APICloud应用开发，有能力制作出好的App。本书是APICloud开发人员的入门指南，并配有的讲解视频，适合各种层次的APICloud学习者和开发人员阅读。
图书作者信息
邹达，APICloud联合创始人兼CTO
APICloud云端一体平台的技术架构设计者及核心引擎的实现者，对大规模、高并发的云端服务开发有着丰富的经验。杰出的JavaScript全栈工程师，有十多年浏览器引擎及移动应用引擎开发经验，先后参与过国内外多款浏览器引擎、JavaScript引擎和移动应用引擎的开发工作。同时也是混合模式开发技术的倡导者，是国内较早一批将Web与Native技术融合的实践者。
李德兴，APICloud技术负责人
一直从事浏览器、JavaScript引擎及相关中间件技术的工作，参与过多个基于浏览器的移动中间件引擎的开发工作。精通Android操作系统，有丰富的App架构及开发经验。热爱新技术，熟悉HTML5和W3C规范，对HTML5和浏览器技术的实际应用有深入研究并付诸过大量实践。
书籍目录预览
第一部分 基础教程：如何从零起步开发一款App
第1章 APICloudApp开发流程
第2章 搭建App整体框架，完成App静态页面开发
第3章 联调前后端数据接口，实现App数据从服务端动态获取
第4章 加载更新服务端数据，实现本地的数据存储
第5章 使用扩展模块API，完成App所需功能实现
第6章 使用第三方开放服务模块，完善App功能和业务逻辑
第7章 使用APICloud应用管理服务，实现App发布和运营
第二部分 实战技巧：如何开发一款优质的App
第8章 如何与众不同
第9章 挖掘API潜力
第10章 超级实用技巧
第11章 性能优化探索
第12章 调试技巧
第三部分 行业应用：如何快速开发主流行业App
第13章 如何快速开发一款IoTApp
第14章 如何快速开发一款教育App
第15章 如何快速开发一款直播App
第16章 如何快速开发一款电商App
30天App开发从0到1：APICloud移动开发实战截图
更多免费电子书搜索「雅书」 https:yabook.org
内 容 提 要
本书围绕 APICloud 平台，全面、系统、细致地讲述了 App 开发的相关内容，涉及平台工作原理、内部实现机制和应用开发技巧。本书涵盖了 APICloud 应用开发的必备知识，包括基础知识、关键技术、开发技巧和行业方案，并从实践角度出发，通过大量的实例代码、详细的操作步骤和丰富的开发截图，帮助开发者迅速掌握 APICloud 应用开发，有能力制作出好的 App。本书是 APICloud 开发者的最佳入
门指南，并配有免费的讲解视频，适合各种层次的 APICloud 学习者和开发者阅读。
著 邹 达 李德兴
责任编辑 杨大可
责任印制 马振武
人民邮电出版社出版发行 北京市丰台区成寿寺路11号
邮编 100164 电子邮件 315@ptpress.com.cn
网址 http:www.ptpress.com.cn
大厂聚鑫印刷有限责任公司印刷
开本：800?1000 116
印张：20.25
字数：431千字 2018年6月第1 版
印数：1 – 4 000册 2018年6月河北第1 次印刷
定价：69.00 元
读者服务热线：(010)81055410 印装质量热线：(010)81055316
反盗版热线：(010)81055315
广告经营许可证：京东工商广登字 20170147号
对本书赞誉
一项技术价值的高低在于其能帮助客户弥补多大的技术差距。移动 App 已逐渐成为企业业
务的基础设施，但移动开发人员的稀缺，导致大量的企业无法组建自身的研发队伍。雪上加霜
的是，移动App距离客户更近了，还需要更快速地迭代。APICloud正是为弥补这个缺口而诞生的。
尽管APICloud采用HTML5和JavaScript技术降低了开发难度，但仍需要开发者慢慢摸索。本书的
出版解决了困扰开发者的问题，进一步弥补了传统企业与优秀互联网公司之间的技术差距。
——林路，北极光创投合伙人
本书是程序员写给程序员的，其中充满了程序员的风格——平实、纯粹，还有理性的乐观。
我与本书的作者从各自创业开始，就持有一个共同的理念：App 开发平台(乃至操作系统)应
该高效、开放、跨平台、功能丰富。本书是这一理念最为具体的说明，而APICloud和中科创达
这两家公司，也是该理念的见证者。我会将本书推荐给我的同事、朋友、合作伙伴和客户阅读。
事实上，我已经在这么做了。
——邹鹏程，中科创达 CTO
和 APICloud 的小伙伴们相识好几年了，一直在用他们的平台做各种智能硬件相关的 App，也和他们一起举办过面向开发者的社区活动。APICloud CEO刘鑫在用户体验和服务上对细节的
无限追求，APICloud CTO邹达在技术上精湛的造诣，让大家用上了一款优秀的产品。早就觉得
他们应该出一本书了，所以这次收到样书一点也不意外，更是几乎一气呵成地读完，感觉这本
书应该叫“30天App开发从0到100”。本书的内容丰富翔实，包含了 App的规划、开发、调试、性能优化、上架等方方面面，还有数个不同行业的应用范例。无论是App开发的新手，还是“老
鸟”，本书都会给你带来全新的知识和视角。在智能设备端，跨平台App已经成为一个不可逆的
趋势，而APICloud则是我们的首选!
——刘琰，机智云 CTO
更多免费电子书搜索「精品下
载」https:yabook.org2 对本书赞誉
这是一本面向初学者但同时又会让有经验的开发者快速晋级的书。我在大学里接触最多的
就是新入学的“初级码农”，通过本书可以让他们迅速成长为可以交付 App 产品的开发者。这
种学习体验，对他们重新理解开发的含义以及建立对IT 学习的自信心都有极大帮助。另外，以
App实现为导向的面向 API的编程方法也是我个人非常推崇的一种开发趋势。
——梁震鲁，齐鲁工业大学网络信息中心副主任，国家高级职业指导师，APICloud社区优
秀讲师
我一向认为一本计算机类图书的作者，如果能够务实地站在App设计者的角度去思考问题，深入理解问题之间的相互关系，并且会针对程序员经常遇到的关键知识做通俗易懂的阐述和丰
富的实例验证，那么他给读者带来的不仅是知识，还有良好的程序员思维。希望本书的读者能
够从中领会作者的良苦用心。
——孙增斌，英特尔在线业务平台总监
本书是一本很好的开发入门教程，通俗易懂、由浅入深，并提供了丰富的实际案例，详细
介绍了如何使用前端开发语言和丰富的APICloud 平台扩展模块来跨平台开发移动App。相信每
位读者都能从本书中汲取相应的知识，它也将帮助我们的开发团队更好地开发移动App !
——丁美玲，泛亚汽车技术中心高级主任工程师
APICloud 平台以独有的快速 App 开发方式，将移动开发中的软件复用提升到一个新的高
度，可以帮助企业在短期内打造出满足业务需求的App，这一点我在实际使用中有切身的体会。
本书语言平实流畅、实例内容丰富，是对 APICloud 生态的又一巨大贡献，也是我们移动开发人
员的福音。读读本书，相信你一定会喜欢的!
——刘殿兴博士，中信证券信息技术中心高级副总裁
移动互联改变了人们的生活，更给企业带来经营模式的转变和新的商机。在这一过程中移
动 App 发挥了重要的作用。但是，对一般的非 IT 企业而言，高效建立 App 并不断地更新、维
持运行，会使企业担负很高的成本。直到有一天，我偶然发现 APICloud，它让我非常欣喜。
APICloud 是中国领先的“云端一体”移动应用云服务开发平台，能够满足移动创新者和传统企
业移动化这两个市场的 App 开发需求，并可以为开发者提供高效 App 开发和平台管理的一站式
服务，包括开发、API 集成、测试、渠道打包、运营管理的 App 全生命周期等。它已有数以万
计的成熟开发接口、多个行业的应用模板以及一些优秀开发者提供的快捷功能组件。APICloud
已经服务于很多行业的企业客户，并为客户带来省心、安心的 App 定制开发服务。如果你还在
为企业的App 开发而烦恼，那就试试APICloud吧，一定会让你取得事半功倍的效果。
——周伊丽，光大银行电子银行部副总经理 对本书赞誉 3
APICloud 平台是目前开发 App 最高效的平台之一，本书详尽地讲述了如何通过 APICloud
平台快速开发一款优质的 App，里面有大量的图文案例并配合实战讲解，通俗易懂，容易上手，非常适合初学者学习。
——朱亮，春秋航空运营总监
作为最早一批 APICloud 的使用者，还记得当初相识的关键字“30 天从 0 到 1”，这句话并
没有吹牛，我们用 APICloud 很快就完成了“战旗”的开发，并且经受住了百万日活用户的挑
战。我已经好久不写代码了，翻阅本书发现许多当初期望的功能都被逐一实现，只能感慨现在
的APICloud用户太幸福了。请记住，当你有想法时，一定要用APICloud启航。
——潘长煌，全民直播 CEO
更多免费电子书搜索「精品下载」 http:序
可能很多人不知道，规模大的企业和 IT 预算多的企业的移动 App 大部分都是基于混合模
式开发实现的。
很多做App开发的技术人员会存在一种偏见，觉得“采用混合模式，基于HTML5技术开发
出来的App，体验以及功能会和原生模式开发的存在差距”，所以更愿意使用原生模式开发App。
其实市场上主流的 App，绝大部分是基于混合模式开发的。最典型的就是微信，除了聊天
功能以外，包括公众号、小程序等都是由混合模式开发技术实现的。再比如电商领域的淘宝、京东等，旅游领域的携程，教育领域的 VipKid，信息分类的 58 等不同应用范围的 App，混合
模式开发技术使其商品展示及线上市场活动的运营管理都变得非常灵活。此外，在航空、保险、银行等行业中，无论是服务客户的toC 模式 App，还是对员工进行管理的toE和toB 的App，多
是使用混合模式开发的，混合模式开发技术成为了绝对主力。
人们不禁要问“为什么这些公司和企事业单位，有着足够的预算和开发资源，还要选择
混合模式 App 开发技术作为企业互联网化的支撑？”答案其实和企业的互联网化及数字化的
需求有着直接的联系。以下 4 个方面，决定了越有实力的企业越需要混合模式 App 开发技术；
同时，也是混合模式App开发技术形成不同行业解决方案的根本优势和企业选择的必要性所在。
速度的要求
“试错”这个词不但在互联网公司中广为流传，在传统公司的互联网化过程中也被广泛接受。
越来越多的CIO在谈各自企业移动战略的时候，都会提到“能否根据业务部门的一个想法，先在一周之内做个原型，快速实现，拿出去让大家看看，然后基于这个原型再修改”。这种快速发起、快速验证、快速调整的方法，已经非常流行。之所以要在短时间内先把业务从想法落到
现实，哪怕 App 粗糙些，也要先实现出来，原因在于具有鲜明企业个性的业务的创新想法可能
没有先例可循，很难考虑得特别完整。与其花费三五个月不停地思考业务需求，还不如用一两
个星期先把基础的想法落实。哪怕短时间内做出的 App 并不能真正满足业务的需要，但是可以
让业务人员的想法在这个过程中变得有据可依、有的放矢，从而为实现更完整且更切实可行的
业务方案先行探索。
“业务部门的一个想法，IT 部门一两周就做出来了!”这对于企业的信息化负责人而言，是很重要的褒奖。这种对速度的要求，恰恰是混合模式开发技术最明显的特长和优势，一套代
码可同步生成iOS与Android两个平台的App，甚至还能部分兼容微信公众号和小程序。一套代
码，并不代表偷懒或工程技术的简化，而更多的是因其不仅节省了代码编写的时间，还避免了
多个技术团队之间跨知识结构的协同问题，不再需要 iOS 与 Android 工程师们开会讨论差异性
问题，更是大幅节省了 App 与服务器端联机调试的时间成本。但如果同样的功能，同样从零开
始，使用传统的原生开发技术基本没有办法在一两个星期内完成有价值业务需求的实现，因为
这个时间可能连不同终端碎片化和差异化的问题都不足以解决。所以，CIO 为了满足业务发展
的需求和数字化速度的要求，在移动战略中往往都会规划使用跨平台的混合模式App开发技术。
业务灵活性的要求
在 PC 时代的 BS 架构中，想要实现 IT 系统的更新并不需要过多地考虑用户端的影响。因
为作为用户入口的浏览器一直处于访问网络的状态，只要网络连通，用户随时访问网站都会获
得最新的功能和业务。对用户而言，并不真正地存在版本的概念。只要访问服务器，服务器的
任何更新都可以随时展示到用户界面上，出现使用问题时，往往只需要清空一次浏览器 Cookie
基本就可以解决。
但是在移动时代，用户对版本的概念变得越发敏感。而对 App 的版本管理也成了 CIO 头
痛的问题。通常因为软件开发商能力的制约，或者一些无法避免的 bug，让一些已发布的 App
变得难用甚至会崩溃。此外，一些临时的市场活动、很少但重要的功能、一些不在规划内的
产品需求调整等情况，都会直接引出同一个问题“用户必须更新一个版本，重新下载安装，才
能满足上述需求”。这种看似日常的版本发布和用户更新，恰恰是传统企业信息化过程中面临
的全新问题。
“能否像传统浏览器那样，用户打开的永远是最新的服务和功能？”很多企业的 CIO 问出
了相同的问题，于是大量的、不合规的软件服务商和IT 程序员想出了一个“偷懒”的模式。在
App 中嵌入一些 WebView，将一些功能采用传统网页的模式，访问服务器，动态获取。虽然表
序 2
更多免费电子书搜索「精品下载」 http:3 序
面上解决了版本更新的问题，实则产生了大量体验很差的App。
企业对业务灵活性的要求，本质是希望像微信小程序一样，可以随时发布一些新的功能，随时动态增改一些功能的入口，让用户任意使用，同时让用户的体验更好。这种对业务灵活性
的需求其实需要像小程序一样有强大的混合模式App开发技术来支撑。从而达成“增量更新”“静
默更新”“打开获得新功能和新体验”，而不是嵌套WebView，用网页模拟 App 的方法，以较差
的用户体验的代价换取业务灵活的可行性。
当然，目前传统模式开发的 App，特别是用 Android 开发的 App 也开始部分支持动态更新。
这也恰恰说明，业务灵活性是企业互联网化、数字化进程的刚需。只是由于传统技术的制约以
及软件开发团队或者服务商能力的限制，真正的原生动态更新始终没有办法大规模进入企业，实现商用。这也让企业对混合模式 App开发技术的需求更为迫切，成为每个CIO 的必备选项。
集中管理的要求
业务部门的互联网化意识是因为互联网的广泛普及被带动起来的。所以，传统的由IT部门
主导企业信息化的态势发生了微妙的变化。过去，都是由 IT部门发起信息化需求，但现在的 IT
部门越来越像“服务部门”。因为业务团队在不停地发起各种各样“业务 + 互联网”的信息化
需求。这个时候，很多传统企业的 IT 部门领导，没认识到自己角色的转变，如果还存有拖延、不管不问、你们自己搞不定等类似的想法，就会导致当下很多企业的信息化面临的“各种移动
App 的彻底碎片化”“各个业务部门自己找软件开发商实现各自的需求”等问题。这不但架空了
IT 部门的信息化主导地位，更麻烦的是，让后续的集中管理变得艰难无比。几十家甚至上百家
不同标准的服务掺杂在企业的核心系统中，甚至有些业务部门为了快速满足自己的需求而脱离
了 IT部门主导的传统 PC核心系统，这些操作都是非常危险的。
IT 部门在被业务部门要求满足业务的互联网化需求时，往往发现心有余而力不足。IT部门
人手有限，实在没办法逐一满足所有业务部门的移动化需求。如果不管，就会产生前面所提到
的“技术栈、开发商”碎片化的问题。这个时候，基于混合模式App 开发技术的移动应用平台，就很好地解决了这二者之间的矛盾。
定标准，从而实现“集中管理”。如果企业能够制订一套统一的混合模式 App 开发技术和
移动平台标准，各个业务部门就可以独立寻找自己的软件开发商，用各种方法满足自己的移动
业务需求。平台的一致性可以带来标准化的统一。这其中包括技术标准化、开发流程标准化、代码管理标准化、项目管理标准化、验收标准化、管理和运营标准化等。
既要放，也要抓。这就是互联网时代企业信息化的要求，更是 IT 部门的职责。混合模式 序 4
App开发技术，有望成为实现企业移动战略的利器之一。
信息化安全的要求
企业互联网化带来的最根本转变就是，内网的信息化变成了外网的互联网化。
传统信息化一般包括内网、固定场所、固定网络环境和固定的设备等关键词。而移动战略
背景下的企业互联网化，则同时包括外网、随时、随地、员工个人设备、4G 和 Wi-Fi 等关键
词。这些不起眼的变化，给企业的业务带来的却是天翻地覆的调整。
移动设备管理软件(Mobile Devices Management，MDM)曾风靡一时，但是购买了 MDM
的企业几乎无一例外地发现其很难推进。因为 MDM 伴随着员工自带设备(Bring Your Own
Device，BYOD)。如果用企业的管理软件来管理员工个人设备，肯定会有很多人反对。所以，大部分的MDM 最终草草收场，只是管理了企业自己购买的一些移动设备。
企业移动化、互联网化的安全怎么保障？ 这要满足 3 个层面的安全，即设备安全、传统安
全和云端安全。
混合模式 App 开发技术可以实现类似于企业应用商店(如微信公众号)的动态权限绑定和
授权模式，能够支持特定设备、特定的人，也可以选择不同的子应用。此外，还可以实现随着
用户工作内容的调整，根据设备编码和用户权限来实时分配全新子应用的功能。
这种基于企业移动应用商店的“子应用”模式，也是混合模式App 开发技术成为企业移动
战略支撑的关键。因为做得好的企业应用商店，不仅能够满足传统原生模式开发的App 所不能
赋予企业的、对各种安全性的需求，还实现了对业务灵活性的管理目的。
APICloud作为中国主流的混合模式 App 开发技术服务提供商，一直在以布道者的身份推进
混合技术在国内的发展和应用。我们不仅提供技术，也提供商业服务，因此会更多地深入到大量
的商业用户中去，如海尔、春秋航空、英特尔、中信证券、上汽等。我们的团队结合不同的商业
场景和实际的商业客户需求，编写了本书，希望能够为不同规模的企业在移动信息化和互联网化
进程中提供有价值的参考，同时也能够让从事App开发的技术人员有更多可借鉴的实战经验。
刘鑫
APICloud创始人兼 CEO
2018 年3月于美国硅谷
更多免费电子书搜索「精品下载」 http:前言
时光荏苒，转眼间APICloud上线已经有3年多的时间了，在这3年多的时间里，APICloud
凭借自身的技术优势和坚持做好开发者生态的信念已经聚集了众多的 APICloud开发者。多年开
发者的经历让我们理解开发者，也深刻认识到任何一个平台或技术都不是三言两语能说清楚的，要想让开发者快速掌握APICloud 应用开发、少走弯路，我们需要编写出一套全面、系统、细致
的开发指南。这个想法一直都有，但是随着平台完善、引擎优化、API扩展和生态产品研发等工
作的开展，开发指南的编写工作迟迟未能完成。这里也向广大开发者表达歉意。
自从 2014 年 9 月 15 日 APICloud 平台上线以来，APICloud 开发团队一直坚持每周更新一
个版本，快速迭代，3 年多时间从未间断。现在 APICloud 平台稳定，功能齐全，生态繁荣，社
区活跃，开发者越来越多，要写出好 App 的需求也越来越迫切，这些让我们感到兴奋的同时，也备感压力。我们必须把自己的设计思想、意图和经验写出来，以满足开发者对技术的热情和
渴望，节省开发者宝贵的学习时间，同时也能指导开发者制作出优秀的App。
APICloud 是一个功能强大的开发平台，涉及的技术范围很广，虽然是自己亲手设计的产
品，也非常清楚开发者需要获知的核心知识，但是，想要把书写好也并非易事。作为官方出品
的第一本介绍APICloud的书，如何合理安排内容，如何能够由浅入深、循序渐进地展开，如何
才能最快地帮到开发者，这些都让我们反复思考，一遍遍地梳理各个知识点之间的关联。章节
的编排确实让我们很费脑筋，这也许就是理想与现实之间的差距吧。本书的作者都是 APICloud
一线开发工程师，均为纯粹的程序员出身，编码水平稍有自信，但是文学情调基本为零。在本
书中，我们力求用通俗的语言来讲述原理和机制，用简洁平实的语言来描述使用流程。但是，本书内容编排上可能还存在不足，用词可能还不够准确，文笔可能还不那么优雅和流畅，这些
还请广大读者谅解。
APICloud 以新的思想、新的技术、新的模式和新的工具来加速移动应用开发，并且让广大
的Web开发人员能够快速成为App开发专家。在本书中，我们会尽可能地通过详细的操作步骤、平实的语言、大量的实例代码和丰富的插图来讲清楚每一个知识点，并且给出大量的开发技巧
以适应不同的场景，迅速提高开发者水平。除了介绍应用层开发外，我们还通过增加对原理的
剖析，让开发者了解平台的内部工作机制，理解APICloud App设计的原理，从而掌握APICloud
的App开发方式和设计原则。
APICloud 团队是国内较早进行 Web 与 Native 技术融合的实践者，10 多年来见证了混合开
发技术在国内“悄悄地、慢慢地”火起来的全过程。APICloud 拥有行业领先的高性能App 混合
渲染引擎，APICloud 模块 Store 汇集了目前 App 开发需要使用的几乎所有主流 API，并一直在
持续更新。我们希望能把一切好的功能加入到 APICloud平台，目的就是能真正帮助开发者提高
效率，降低成本，解决问题。
访问APICloud平台官网，注册成为APICloud开发者，开始APICloud的开发之旅吧!
如何阅读本书
本书分3 个部分，一共包括16 章和 2个附录。
第一部分是基础教程，适合 APICloud 初学者。通过第一部分的学习初学者可以了解
APICloud 平台，熟悉 APICloud 云控制台操作和开发工具的使用，掌握开发一款 App 必须具备
的核心知识点、常用 API 和基础开发技巧，可以有能力独自完成一款简单App 的开发。读者在
学习过程中可以跟随示例代码一步步自己练习，再结合视频讲解学习 APICloud 应用的设计思
想，理解 APICloud 开发模式，从而找到理解 APICloud App 开发的正确方法和学习模式，为以
后有能力开发大型的复杂App 打下基础。
这一部分以一款实际案例的开发过程为例，所涉及的核心知识和编码技巧是开发一款优
APICloud App 的必备技能，初学者一定要深刻掌握。有一定 APICloud 开发经验的读者也可以
通过这一部分的学习，加深对 APICloud 应用设计思想和开发模式的理解，对 APICloud 知识体
系有一个更全面的认识，巩固APICloud核心知识点的使用。
这一部分共7章。第1章是一个非常全面的初学者入门教程，对APICloud平台、APICloud
App 开发流程、学习方法、学习资源做了全面的介绍。第 2 ～ 7 章详细讲解如何从零起点开发
一款App，以一个电商O2O App 为例，从创建 App 开始，一步步为其丰富功能，直到开发出一
款完整的App。在这个过程中演示了一个APICloud App开发的标准流程，贯穿讲解了 APICloud
App 开发过程中需要使用的所有核心知识点，包括界面布局、网络通信、数据存储、模块扩展
和开放服务调用等。
前言 2
更多免费电子书搜索「精品下载」 http:3 前言
虽然这一部分的内容是根据“APICloud 7 天培训课”的课程讲义和视频讲解整理而成的，但是本书对讲义和视频的内容进行了重新梳理和结构优化，确保知识体系的组织更加系统清晰、技术点的阐述更加全面细致、语言描述更加准确。
第二部分的实战技巧是 App 开发的进阶内容，适合已经具备一定 APICloud App 开发能力
的开发者。这一部分讲述的实战技巧是由诸多一线资深 APICloud 开发工程师从实战角度出发，总结多个项目经验，由浅入深精心提炼而成。这一部分的主要用意是抛砖引玉，让读者多角度、深层次地发掘 APICloud 所蕴含的技术能力和技术潜力，从而能够开发出更优质的 App 产品。
这一部分共5章。第8～11章的每一个实战技巧都可以作为一个独立的APICloud App运行，完整的示例代码和工程配置说明可以在本书的 GitHub 仓库中下载。读者既可以将其当作一个学
习参考的 Demo，也可以直接将其应用到具体 App 项目中，以实现具体的功能需求。第 12 章主
要介绍开发APICloud App的调试技巧，以及常用调试工具的使用。
第三部分是行业应用，向读者介绍 APICloud针对不同行业提供的解决方案，阐述为什么越
是有实力的企业越需要使用混合模式 App 开发技术，以及混合模式形成的不同行业解决方案的
根本优势和企业选择的必要性，并且列举了主流行业应用中被高频使用的几种模块和API。这一
部分共4 章(第13 ～ 16 章)，分别介绍IoT、教育、直播和电商这4 个领域。
附录A为APICloud App客户端开发规范(Version 1.0)，主要总结提升程序质量、App性能及
用户体验的开发规范。
附录 B 为开发工具 APICloud Studio 2 使用详解，是对这款云端一体的全功能集成开发工具
的详细使用说明。
配套视频
本书配套免费的“APICloud 7 天培训课”的完整视频教程(共约 70 讲 )。“APICloud 7 天
培训课”第 1 ～ 7 天的视频讲解与本书第一部分第 1 ～ 7 章的内容是相互关联的，读者可以通
过扫描二维码来观看这一视频教程。 前言 4
示例代码
本书的项目源码和资源都放在GitHub仓库a 里。我们后续也会通过这个开源分支来更新代
码和教程，解决读者所提出的问题，并进行后续版本的适配和代码的优化。
开发环境
APICloud 一直坚持支持多开发工具的策略，开发者可以使用任意一款自己喜欢的主流编
码工具来开发 APICloud App，只需要在这些工具中安装相应的 APICloud 插件就可以了。目前
APICloud 支持的开发工具包括 Atom、Sublime Text、Eclipse、WebStorm、VSCode 等。本书通
篇使用 APICloud Studio 2 作为开发工具，APICloud Studio 2 是一款基于 Atom 进行扩展的全功
能集成开发工具。读者可以阅读附录B 来了解这款工具的详细使用方法。
联系我们
由于编写时间仓促，书中难免会出现一些错误或者不准确的地方，恳请读者批评指正。如
果您有更多的宝贵意见，欢迎到APICloud开发者社区b 和我们进行互动和讨论。
邹达
APICloud联合创始人兼 CTO
2018 年 3 月21 日
a GitHub 搜索框内输入“apicloud 30-APP-0-1”即可。
b 在 APICloud官方网站点击“开发者社区”即可。
更多免费电子书搜索「精品下载」 http:
要获得以上配套资源，请在异步社区本书页面中点击 ，跳转到下载界面，按提
示进行操作即可(本书视频为扫码观看)。注意：为保证购书读者的权益，该操作会给出相
关提示，要求输入提取码进行验证。
提交勘误
作者和编辑尽最大努力来确保书中内容的准确性，但难免会存在疏漏。欢迎您将发现的
问题反馈给我们，帮助我们提升图书的质量。
当您发现错误时，请登录异步社区，按书名搜索，进入本书页面，点击“提交勘误” ，输入勘误信息，单击“提交”按钮即可。本书的作者和编辑会对您提交的勘误进行审核，确认并接受后，您将获赠异步社区的 100 积分。积分可用于在异步社区兑换优惠券、样书
或奖品。
z 配套视频。
z 本书源代码；
本书提供如下资源：
配套资源
本书由异步社区出品，社区(http:www.epubit.com)为您提供相关资源和后续服务。
资源与支持
扫码关注本书
扫描下方二维码，您将会在异步社区微信服务号中看到本书信息及相关的服务提示。
异步社区 微信服务号
更多免费电子书搜索「精品下载」 http:
的 LOGO。异步图书的出版领域包括软件开发、大数据、AI、测试、前端、网络技术等。
电出版社近 30 年的计算机图书出版积累和专业编辑团队，相关图书在封面上印有异步图书
“异步图书”是由异步社区编辑团队策划出版的精品 IT 专业图书的品牌，依托于人民邮
http:www.epubit.com。
IT 技术图书和电子书，以及高品质技术文章和视频课程。更多详情请访问异步社区官网
相关学习产品，为作译者提供优质出版服务。异步社区创办于 2015 年 8 月，提供大量精品
“异步社区”是人民邮电出版社旗下 IT 专业图书社区，致力于出版精品 IT 技术图书和
关于异步社区和异步图书
者权益的保护，也是我们持续为您提供有价值的内容的动力之源。
部分内容的非授权传播，请您将怀疑有侵权行为的链接发邮件给我们。您的这一举动是对作
如果您在网上发现有针对异步社区出品图书的各种形式的盗版行为，包括对图书全部或
发邮件给我们。
如果您是学校、培训机构或企业，想批量购买本书或异步社区出版的其他图书，也可以
www.epubit.comselfpublishsubmission 即可)。
发 邮 件 给 我 们 ； 有 意 出 版 图 书 的 作 者 也 可 以 到 异 步 社 区 在 线 提 交 投 稿 ( 直 接 访 问
如果您有兴趣出版图书、录制教学视频，或者参与图书翻译、技术审校等工作，可以
以便我们更高效地做出反馈。
如果您对本书有任何疑问或建议，请您发邮件给我们，并请在邮件标题中注明本书书名，我们的联系邮箱是 contact@epubit.com.cn。
与我们联系致谢
本书能够顺利完成，得到了很多同事和朋友的帮助。
感谢人民邮电出版社对APICloud平台的大力支持。
感谢人民邮电出版社信息技术分社社长、异步社区掌门人刘涛老师在2018 APICloud 开发
者大会上现场宣布本书预售。
感谢人民邮电出版社杨海玲老师对本书的支持。我们和海玲老师很早就认识，她有丰富的
图书策划和出版经验，这次能与她合作非常开心，合作过程也很愉快。感谢海玲老师在本书的
编写过程中(从内容组织到最终成稿)给予的悉心指导。
感谢我们的同事尚德聚、颉彬、王梦吉等参与了本书第二部分实战技巧的编写。
感谢广大的 APICloud 开发者，正是与你们的交流和互动造就了 APICloud 社区的繁荣，也
是你们的需求和应用推动着APICloud平台的不断完善和快速迭代。
感谢所有参与本书不同阶段书稿评审和代码验证的人。
感谢 Sean 和 May，我们相识多年，一起创业，没有你们的唠叨和压迫，我很难按时完成本
书的编写。目录
第一部分 基础教程：如何从零起步开发一款 App
第 1 章 APICloud App开发流程 3
1.1 APICloud平台介绍 4
1.1.1 查看APICloud平台能力 4
1.1.2 开发模式、技术语言和平台定位 6
1.1.3 技术、产品、生态、案例和商业模式 10
1.1.4 开发者服务体系 10
1.1.5 新手入门 APICloud应用开发 14
1.2 体验完整项目的开发流程 15
1.2.1 注册APICloud账号 15
1.2.2 创建一个App 项目 15
1.2.3 编辑项目 18
1.2.4 调试项目 18
1.2.5 编译项目 21
1.3 小结 22
第 2 章 搭建 App整体框架，完成 App静态页面开发 23
2.1 启动 25
2.1.1 APICloud App执行流程 25
更多免费电子书搜索「精品下载」 http:2 目录
2.1.2 Widget和Window 26
2.1.3 App config.xml配置文件使用 26
2.1.4 APICloud引擎的两个重要事件 27
2.2 APICloud应用设计思想 27
2.3 界面和导航 28
2.3.1 APICloud应用的 UI组成结构 28
2.3.2 APICloud界面布局 5大组件 29
2.3.3 APICloud混合渲染模式 30
2.3.4 查看 APICloud引擎 api对象功能 32
2.3.5 屏幕适配 33
2.3.6 前端框架 33
2.3.7 状态栏处理 34
2.3.8 iPhone X的状态栏处理 35
2.3.9 优化点击事件和 tapmode 37
2.3.10 静态页面中建议遵循的布局方法 37
2.4 搭建 App 整体框架，完成App静态页面开发 38
2.4.1 创建首页的标题栏和 Tab标签组 38
2.4.2 制作 Tab页面并添加点击事件和动画效果 43
2.4.3 制作悬浮购物车信息栏 48
2.4.4 跳转到登录页面 51
2.4.5 城市选择菜单和事件通信 52
2.5 小结 55
第 3 章 联调前后端数据接口，实现 App数据从服务端动态获取 56
3.1 APICloud提供的数据通信能力和相关 API 57
3.1.1 APICloud支持的通信协议 57
3.1.2 用于 HTTP通信的主要API 57
3.2 APICloud数据云 58
3.2.1 APICloud数据云的用途 58
3.2.2 APICloud数据云的特点 58
3.3 联调前后端数据接口，实现 App 数据从服务端动态获取 59 目录 3
3.3.1 实现用户注册功能 59
3.3.2 实现用户登录功能 60
3.3.3 获取商品列表数据 62
3.3.4 显示商品列表 63
3.4 小结 64
第 4 章 加载更新服务端数据，实现本地的数据存储 65
4.1 使用doT模板引擎 66
4.2 本地存储和图片缓存 67
4.2.1 uzStorage 67
4.2.2 偏好设置 67
4.2.3 文件 68
4.2.4 database 69
4.2.5 存储容量 69
4.2.6 沙箱机制 70
4.2.7 资源访问协议 70
4.2.8 图片缓存 71
4.3 下拉刷新、上拉加载的实现 71
4.3.1 下拉刷新 72
4.3.2 上拉加载 72
4.4 事件机制 72
4.4.1 统一事件管理 72
4.4.2 事件管理API 73
4.4.3 平台事件类型 74
4.5 常用对话框窗口 75
4.6 在指定的窗口中执行脚本 76
4.7 加载更新服务端数据，实现本地的数据存储 77
4.7.1 使用doT模板引擎显示商品列表 77
4.7.2 实现图片缓存 78
4.7.3 实现下拉刷新 79
4.7.4 实现上拉加载更多 81
更多免费电子书搜索「精品下载」 http:4 目录
4.7.5 实现保存登录信息 82
4.7.6 实现清除缓存 84
4.8 小结 85
第 5 章 使用扩展模块 API，完成 App所需功能实现 86
5.1 APICloud扩展模块 87
5.1.1 APICloud端引擎架构 87
5.1.2 APICloud模块调用过程 88
5.2 自定义模块 88
5.3 使用 UIScrollPicture 89
5.4 使用 UIInput 91
5.5 使用 UIActionSelector 92
5.6 多媒体相关模块使用 96
5.7 使用扩展模块 API，实现 App 所需功能 96
5.7.1 实现商品详情页轮播图 96
5.7.2 使用UIInput实现原生输入框 100
5.7.3 实现三级联动的城市选择器 101
5.7.4 实现头像上传 103
5.8 小结 105
第 6 章 使用第三方开放服务模块，完善 App功能和业务逻辑 106
6.1 集成第三方服务 107
6.2 目前 APICloud已经集成的第三方服务模块 107
6.3 自定义AppLoader 108
6.3.1 自定义 AppLoader与官方AppLoader的区别 108
6.3.2 为什么要使用自定义 AppLoader 109
6.3.3 编译生成自定义 AppLoader 109
6.4 第三方服务模块使用流程 110
6.5 百度地图模块的接入和使用 110
6.5.1 申请应用 ID 和 Key 110 目录 5
6.5.2 配置ID 和 Key 112
6.5.3 百度地图的常用API 112
6.6 微信分享与登录的接入和使用 114
6.6.1 申请ID 和 Key 114
6.6.2 配置ID 和 Key 114
6.6.3 微信分享模块的常用API 114
6.7 个推推送的接入和使用 117
6.7.1 申请ID 和 Key 117
6.7.2 配置ID 和 Key 117
6.7.3 个推模块的常用方法 117
6.8 支付宝支付模块的接入和使用 118
6.8.1 申请应用ID 和 Key 118
6.8.2 配置应用ID 和 Key 118
6.8.3 支付宝模块的常用API 119
6.9 使用第三方开放服务模块，完善App 功能和业务逻辑 119
6.9.1 获取当前城市 119
6.9.2 根据输入内容检索地址列表 121
6.9.3 使用个推进行消息推送 123
6.10 小结 124
第 7 章 使用 APICloud应用管理服务，实现 App发布和运营 125
7.1 编译生成 App 安装包 126
7.1.1 云编译 126
7.1.2 代码全包加密 127
7.1.3 扩展API调用安全配置 127
7.2 版本管理 128
7.2.1 在APICloud控制台管理版本 128
7.2.2 Config文件相关配置 129
7.2.3 mam 模块 129
7.3 云修复 130
7.3.1 Config文件相关配置和mam 模块 130
更多免费电子书搜索「精品下载」 http:6 目录
7.3.2 制作并发布云修复包 130
7.3.3 相关 API使用 131
7.4 闪屏广告 131
7.4.1 在 APICloud控制台使用闪屏广告 132
7.4.2 相关 API使用 132
7.5 优化策略 133
7.5.1 了解 HTML5 特性 133
7.5.2 窗口结构 133
7.5.3 页面加载速度 134
7.5.4 不用重型框架 134
7.5.5 屏幕适配 134
7.5.6 数据加载 134
7.5.7 图片处理 135
7.5.8 交互响应速度 135
7.5.9 尊重系统特性 135
7.6 编码规范 135
7.7 Widget管理 136
7.7.1 多 Widget架构 136
7.7.2 主 Widget 137
7.7.3 子 Widget 137
7.7.4 Widget管理相关API使用 137
7.8 SuperWebView 138
7.8.1 SuperWebView介绍 138
7.8.2 SuperWebView特点 138
7.9 使用 APICloud应用管理服务，实现 App 的发布和运营管理 138
7.9.1 编译 App 139
7.9.2 版本发布 139
7.9.3 使用云修复 139
7.9.4 闪屏广告 140
7.10 小结 140 目录 7
第二部分 实战技巧：如何开发一款优质的 App
第 8 章 如何与众不同 143
8.1 自定义样式的日期选择器 144
8.1.1 使用模块UICustomPicker 144
8.1.2 开发流程及要点概述 145
8.2 自动义样式的三级联动城市选择器 149
8.2.1 使用模块： UILinkedPicker 150
8.2.2 开发流程及要点概述 150
8.3 实现固定不动的下拉筛选菜单 152
8.4 滑动页面动态改变导航条颜色 155
8.4.1 实现思路 155
8.4.2 知识点说明 155
8.4.3 核心部分代码 155
8.5 实现高斯模糊的背景图片 156
8.6 精致0.5 px 细线的实现 158
8.7 小结 159
第 9 章 挖掘 API 潜力 160
9.1 深入挖掘Frame的各种应用场景 161
9.1.1 模拟页面按钮 161
9.1.2 模拟窗口组件 161
9.1.3 模拟侧滑窗口 163
9.2 使用 UIScrollPicture模块开发引导页 164
9.2.1 概述 165
9.2.2 实现思路 165
9.3 使用 photoBrowser模块实现自定义样式的图片浏览功能 167
9.3.1 概述 167
9.3.2 自定义样式图片浏览器功能实现步骤 168
9.4 使用 UIInput模块实现自定义搜索界面 170
更多免费电子书搜索「精品下载」 http:8 目录
9.4.1 概述 170
9.4.2 自定义搜索界面实现步骤 170
9.5 使用 UIChatBox模块实现聊天界面 172
9.5.1 概述 172
9.5.2 UIChatBox 模块实现聊天界面实现步骤 173
9.6 使用 api.ajax进行网络请求 176
9.7 小结 179
第 10 章 超级实用技巧 180
10.1 如何让页面动态适配有虚拟按键栏的 Android手机 181
10.2 获取手机验证码功能的实现 182
10.3 打开一个外部链接作为新的页面，并设置样式以及事件监听 184
10.4 实现更换皮肤功能 186
10.5 实现多语言切换功能 187
10.6 调用任意App 189
10.6.1 URL Scheme应用场景 189
10.6.2 URL Scheme在APICloud中的应用 189
10.7 数据表格的快速开发 191
10.7.1 使用 APICloud模块实现数据表格的开发 192
10.7.2 使用第三方 JavaScript框架实现数据表格的开发 193
10.8 apiready与 window.onload的平衡使用 194
10.8.1 apiready与window.onload区别 194
10.8.2 apiready与window.onload的使用时机 194
10.8.3 应用实例 195
10.9 地图模块的实用扩展：在地图上添加自定义按钮 196
10.10 地图搜索的高级应用：如何获取城市地铁线路列表 198
10.10.1 需求分解 198
10.10.2 功能实现 198
10.11 极光推送的快速实现 200
10.11.1 获取 App包名 200
10.11.2 获取极光推送AppKey 201 目录 9
更多免费电子书搜索「精品下载」 http:
12.3.4 把待调试代码同步到 AppLoader 227
12.3.3 开启 iOS 设备的 Web 检查器功能 226
12.3.2 显示桌面 Safari 浏览器的“开发”菜单 226
12.3.1 从 APICloud 官网编译安装自定义 AppLoader 226
12.3 调试技巧：使用 Safari 断点调试 iOS 应用 226
12.2.3 使用本地文件作为接口返回值 224
12.2.2 构建模拟数据 223
12.2.1 请求示例代码 222
12.2 调试技巧：使用 Charles 模拟网络请求 222
12.1.2 查看 http 请求 219
12.1.1 查看 HTTP 请求 217
12.1 调试技巧：使用 Charles 查看网络请求 217
第 12 章 调试技巧 216
11.5 小结 215
11.4.3 应用实例 214
11.4.2 异步的优势 213
11.4.1 JavaScript 的同步 异步机制 212
11.4 合理使用同步 异步接口 212
11.3.3 关键代码实现 211
11.3.2 正确的做法 211
11.3.1 程序员的思维习惯 210
11.3 流畅的用户登录体验 210
11.2 数据不要从 DOM 上获取 208
11.1 用 imageCache 缓存图片 206
第 11 章 性能优化探索 205
10.12 小结 204
10.11.5 开始推送 203
10.11.4 在代码中监听推送消息 202
10.11.3 配置极光推送模块 20210 目录
12.3.5 Safari断点调试iOS 应用 228
12.4 调试技巧：使用Chrome断点调试Android应用 229
12.4.1 从 APICloud官网安装AppLoader 230
12.4.2 在 Android手机上开启USB调试 231
12.4.3 把待调试代码同步到 AppLoader 231
12.4.4 在 Chrome中断点调试 232
12.5 小结 235
第三部分 行业应用：如何快速开发主流行业 App
第 13 章 如何快速开发一款 IoT App 239
13.1 IoT App的分类和功能 240
13.1.1 IoT App 的分类 240
13.1.2 IoT App 的主要功能 240
13.2 IoT App的技术架构 241
13.2.1 两方通信架构 241
13.2.2 三方通信架构 241
13.2.3 四方通信架构 242
13.3 IoT App中高频使用的 API 243
13.3.1 界面组件类模块 243
13.3.2 功能扩展类模块 244
13.3.3 开放服务类模块 245
13.4 如何使用 APICloud开发一款 IoT App 246
13.5 小结 246
第 14 章 如何快速开发一款教育 App 247
14.1 教育 App的分类和功能 248
14.1.1 教育 App的分类 248
14.1.2 教育 App 的主要功能 248
14.2 教育 App的产品架构 249
14.2.1 产品功能架构 249 目录 11
14.2.2 学习计划架构 250
14.3 教育 App中高频使用的API 250
14.3.1 UI 组件类模块 250
14.3.2 功能扩展类模块 251
14.3.3 开放服务类模块 252
14.4 如何使用 APICloud开发一款教育App 253
14.5 小结 253
第 15 章 如何快速开发一款直播 App 254
15.1 直播 App的分类和功能 255
15.1.1 直播 App 的分类 255
15.1.2 直播 App 的主要功能 255
15.2 直播 App技术架构 256
15.3 直播App 中高频使用的 API 256
15.3.1 UI 组件类模块 257
15.3.2 功能扩展类模块 258
15.3.3 开放服务类模块 258
15.4 如何使用 APICloud开发一款直播App 259
15.5 小结 260
第 16 章 如何快速开发一款电商 App 261
16.1 电商 App的分类和功能 262
16.1.1 电商 App 的分类 262
16.1.2 电商 App 的主要功能 263
16.2 电商 App的产品结构 263
16.2.1 前端产品结构 263
16.2.2 后台产品结构 264
16.3 电商 App中高频使用的API 265
16.3.1 UI 组件类模块 265
16.3.2 功能扩展类模块 266
更多免费电子书搜索「精品下载」 http:12 目录
16.3.3 开放服务类模块 267
16.4 如何使用 APICloud开发一款电商 App 267
16.5 小结 268
附录 A APICloud App客户端开发规范(Version 1.0) 269
附录 B 开发工具 APICloud Studio 2使用详解 282第一部分
基础教程：如何从零起步开发一款 App
更多免费电子书搜索「精品下载」 http:在这一部分中，第1章将对APICloud平台做一个整体的介绍，包括平台能力、开发模式、学
习资源和开发者社区等，之后会介绍如何使用APICloud完成一个最简单的App的完整开发流程。
第 2 ～ 7 章将带领读者从零起步去开发一款 O2O 类型的电商 App，其中会涉及 APICloud
开发的基础理论和常用技术，帮助读者快速入门。对于第一部分的整体内容，建议读者结合随
书附赠的视频教程去学习，理解课程当中讲到的每个技术细节，然后再亲手练习。学会这些内
容，就有能力去独立开发一款App了。
第一部分的项目源码和所有资源在GitHub库a 里。我们后续也会通过这个开源分支来更新
代码和教程，解决读者所提出的问题，并进行后续版本的适配和代码的优化。
a GitHub搜“apicloud30-APP-0-1”。第1章
APICloud App开发流程
主要内容
本章从总体上介绍 APICloud 平台，包括 APICloud 应用的开发模式、设计思想、控制台使
用流程等，并以一个HelloWorld App 为例让读者体验一个完整的APICloud App的开发流程。
学习目标
(1)了解 APICloud 平台，了解 APICloud 相关的学习资源、入门资料和常见的问题。让没
有接触过 APICloud 平台的读者，对平台有一个基础的了解；让学习过 APICloud 并且已掌握一
部分技能的读者，通过本章的学习，可以快速找到需要的资料和解决问题的方法。
(2)学习如何在 APICloud 平台上创建、修改、调试、编译和运行一个最简单的 APICloud
App。掌握APICloud App完整的开发流程。
要对 APICloud 平台做一个全面的介绍，需要花很长的时间和很多的篇幅来讲解每一个细
节，而本书作者希望能用更多的篇幅来讲解一个 App 的实际开发过程，讲解具体的代码实现。
所以，本章在介绍 APICloud平台的时候，是通过抛出一个个问题，然后告诉读者应该到哪儿去
找对应的学习资源，到哪儿能够找到解决问题的方案。
更多免费电子书搜索「精品下载」 http:4 第1 章 APICloud App开发流程
1.1 APICloud平台介绍
本章将从 APICloud 可以做什么，如何获取使用帮助，APICloud 的技术、产品和生态等多
个方面对APICloud平台加以介绍。
1.1.1 查看APICloud平台能力
开发者在接触一个开发平台的时候，通常第一个想法就是去查看这个平台的能力。特别是
那些想做 App 的、有着明确需求的开发者，他们会非常关心自己的需求在这个开发平台上是否
能够满足。所以，本书开篇就先来解决这个开发者普遍关心的问题，读者可以带着自己预先想
好的需求来了解APICloud平台，了解如何能够快速地在 APICloud平台上查找相关的能力。
1.通过官方文档快速搜索功能模块
查看APICloud平台提供的能力，一个最基础也是最有效的方法就是查看APICloud的API文档。
APICloud 官方网站中的文档页面如图 1-1 所示。如需要查看视频播放的功能，可以在文档
中搜索“视频播放”，搜索结果如图 1-2 所示，可以看到在 APICloud 平台上有多种提供视频播
放功能的模块，如 videoPlayer(播放本地视频)、moviePlayer(播放网络视频)、polyvPlayer(保
利威视播放器)、baiduPlayer(百度播放器)等。
图 1-11.1 APICloud平台介绍 5
图 1-2
点击其中一个搜索结果，查看模块的详细文档。比如点击“videoPlayer”之后可以看到这个
模块对于视频播放提供了很多 API，这些 API 基本覆盖了一个视频播放器所有常见的功能，如
图1-3 所示。
图 1-3
再比如要查找支付功能，可以在文档中搜索“支付”，通过搜索结果可以看到在 APICloud
更多免费电子书搜索「精品下载」 http:6 第1 章 APICloud App开发流程
平台上有很多个提供支付功能的模块，如 aliPay(支付宝)、wxPay(微信支付)、unionPay(银
联支付)、paypal(PayPal 支付)、iap(iOS 应用内支付)等；也有 ping++、beeCloud 等第三方
聚合类的支付模块。点击每个模块均可以查看具体的API详情。
读者想了解APICloud平台有哪些能力，最简单的方法就是到APICloud官方文档中去搜索相应
的功能，这样就可以一目了然地知道APICloud平台有没有相应的模块来支持自己想要的功能。
2. APICloud能力支撑体系
目前在 APICloud 平台上已经提供了 600 多个模块，上万个 API。这些 API 基本可以覆盖一
款 App所需的所有常用功能，为方便表述，它们被分为“平台使用”“基础功能”“界面布局”“设
备特性”“功能扩展”和“开放服务”六大类，其分类与具体包含内容如图1-4 所示。
图 1-4
1.1.2 开发模式、技术语言和平台定位
很多APICloud初学者会关心这些问题： APICloud App的开发模式是什么样的、使用什么技
术语言、目前自己的开发团队是否适合使用 APICloud 开发 App、整个 APICloud 的学习曲线是
什么样的、入门简不简单等。
1.开发模式和技术语言
APICloud 应用的开发模式是使用标准的 HTML、CSS 和 JavaScript+APICloud 扩展 API 来
进行 App 开发，如图 1-5 所示。APICloud的 App 开发使用的是标准的 HTML5 技术，针对标准
HTML5 所不具备的功能或是用 HTML5 实现体验不好的功能(这些功能也是开发者在 App 开
发过程中非常常用的功能)。APICloud 提供了 600 多个扩展模块和上万个 API，通过这些模块和1.1 APICloud平台介绍 7
API来扩展HTML5的功能，满足 App的开发需求。
图 1-5
2.扩展API调用方式
APICloud 扩展 API 的调用方式与调用标准的 JavaScript 方法是完全一样的。APICloud 引擎
的核心 API 是放在 window.api 这个对象下面的，这个对象是 APICloud 在 JavaScript 全局作用
域内扩展的唯一一个对象，可直接调用。如果想调用某个模块下面的方法，可以通过 require
的方式动态引入，通过在 api.require 方法的参数中指定某个模块的名称来引入相应的模块，然后调用模块下面的方法，具体演示如下。
核心API在window.api对象下，可以直接调用
api.methodName(param, callback);
扩展模块需要require引入，遵守CommonJS规范
var module = api.require('moduleName');
module.methodName(param, callback);
param: {} 参数，是一个JSON对象
callback: function(ret, err){} 回调函数，是一个Function对象，异步方法调用的结果通过此函数返回
所有 API 的调用方式都是相同的，第一个参数是一个JSON 对象，承载着要传递给模块的
信息；第二个参数是一个 callback 函数。APICloud 大部分的 API 调用都是异步方式，在调用的
时候，要指定一个callback函数，当这个API操作完成时，操作结果将通过该callback函数回调。
一些常用的调用方式，比如打开一个新窗口，可以调用 api.openWin ；打开通讯录可以
调用 api.openContacts，录音、图片缓存等也是调用相应的方法。如果想去加载文件系统
模块，可以通过 api.require(fs) 来加载 fs模块，然后调用 fs模块下面的方法。使用条码扫
描模块也是类似的。示例如下。
打开新窗口： api.openWin。
打开系统通讯录： api.openContacts。
更多免费电子书搜索「精品下载」 http:8 第1 章 APICloud App开发流程
录音： api.startRecord。
缓存网络图片：api.imageCache。
加载 fs模块： var fs = api.require('fs')。
新建一个文件：fs.createFile。
加载二维码 条形码扫描模块：var scanner = api.require('FNScanner')。
打开二维码 条形码扫描：scanner.openScanner。
APICloud 技术是基于标准的 HTML、CSS 和 JavaScript 技术，并在标准的 JavaScript 基础上
扩展了一个核心对象 -api 对象和数百个模块。这些模块可以使用 api.require 函数载入，并使用
操作标准JavaScript对象的方式调用上述模块列举出方法。
3.扩展API的作用
读者可能会问，APICloud 为什么要扩展这么多 API 呢？其实 APICloud 所扩展的 API 都是
标准的 JavaScript 所不支持的方法，或是用标准 HTML5 来实现但体验不好的功能。读者可以把
HTML5 理解成一门技术、一门语言，但是它还没有达到一个平台的水平。这就是 APICloud 为
什么要做这些扩展。APICloud所有的扩展主要是围绕以下这4个方面进行的。
兼容性：在 PC互联网时代，浏览器具有多种内核，JavaScript框架产生的最初原因就是
为了实现 JavaScript 代码在各种浏览器上的兼容和适配。在移动互联网时代，虽然在主
流的手机系统中，Android 和 iOS 的浏览器内核都是 webkit，但是出于商业原因，谷歌
从 webkit 中建立了一个新的分支，叫 blink。现在两个分支的主要贡献者分别是苹果和
谷歌，所以未来这两个内核的兼容性问题会一直存在。
实用性：
` Page 不等于 App，标准的 HTML、CSS 和 JavaScript 规范更多是用来定义网页和文
档的，例如现在的一些框架都在讲 SPA 结构，它是以单页面为主的，很多 HTML
标签是针对于文本信息展示的；而 App 则不然，App 更多是强调功能和体验，在
原生系统中有很多的组件，HTML5 标签和 Native 组件的设计规范是完全不同的。
所以，想用标准的 HTML5 技术开发一个 App 是不现实的，人们不能直接把为
WebPage所制定的规范直接搬到App上。
` BS 架构与 ClientCloud 架构：在 PC 互联网时代，终端产品的主要架构还是 BS
架构；但是在移动互联网时代，终端产品的主要类型是App，而 App 是一个完整的
ClientCloud 架构。在移动端，实现界面和功能，在云端提供数据和服务。页面布
局是存放在移动端的，功能实现也是在移动端完成，所以用户在使用时可以感受到
App的启动、页面渲染和布局展示是很快响应的。
`速度、交互和体验：这 3 个问题是用 HTML5 技术直接开发 App 的最大挑战。其
实，如果使用 HTML5 技术实现一个界面，渲染之后显示出来，用户看到这个界面1.1 APICloud平台介绍 9
时并不能立刻分辨出它是用 HTML5 实现的还是用 Native技术实现的。但是当用户
做一个交互，点击一下，体验一下响应速度或者做一个手势，触发一个动画，这时
用户就可以非常清楚地感受到，并能分辨出该界面是用 Native 技术开发的还是用
HTML5 开发的。所以速度、交互和体验也是使用 HTML5 技术开发 App 必须去解
决的问题。
持续性、静态标准与动态标准：HTML5 的定稿花了 7 年时间，并且整个标准的迭代是
缓慢的；而 Android和 iOS 每一次版本更新都会新增很多功能，这些新增的恰恰都是当
前行业里最需要的功能，但这些功能很难快速通过制定新的 HTML5 标准进行更新，并
在各个浏览器里支持起来。那会是一个非常漫长的过程。
扩展性：在开发一款 App 的时候，开发人员需要扩展很多的功能，有时候要和行业特
点结合，有时候还要跟硬件结合，这就会用到大量国内的开放服务，如推送、直播、智能识别等。所有的这些功能，标准的 HTML5 规范中都没有定义，所有的标准浏览器
引擎也没有默认支持。
总的来说，APICloud 扩展的所有功能都是标准 HTML5 所没有的，如果 HTML5 有并且在
App 中运行起来没有任何问题，APICloud 平台也没有必要去做这个扩展。APICloud 所有扩展的
功能其实就是为了去解决 HTML5 在兼容性、实用性、持续性和扩展性等方面的问题。
4.模块Store
在APICloud模块Store中可以查看APICloud平台扩展的所有功能，如图1-6 所示。
图 1-6
更多免费电子书搜索「精品下载」 http:10 第1 章 APICloud App开发流程
5. APICloud平台定位
APICloud 是一个中间层，是在应用程序和系统之间的一层，在这一层中，APICloud 聚合
了开发一款 App 所需要的所有系统调用、开放服务和扩展功能，然后以统一 API 的形式提供给
开发者调用。这就是APICloud平台的定位，如图1-7 所示。
图 1-7
1.1.3 技术、产品、生态、案例和商业模式
这部分有大量的内容需要给读者介绍，但是本书不想为此占用大量的篇幅。读者可以通过
APICloud官网公开课的视频来详细了解。在官方视频教程a中有几百集的课程，其中“APICloud
视频之初级代码篇第1～3讲b”通过几小时的视频给读者详细介绍了APICloud技术、产品、商
业模式、案例以及生态的方方面面，如果读者是第一次接触 APICloud，我们建议花一定的时间
去观看这些公开课的视频。
1.1.4 开发者服务体系
开发者在选择或者使用一个平台的时候，一定会遇到很多的问题。遇到问题时应该如何解
决？此外，开发者还会关心这个平台在提供技术的同时还能提供哪些服务？有没有一个完整的
生态？有没有一个活跃的社区提供技术支持、方便学习和交流？
针对这些问题，本节列举以下 APICloud开发者服务体系相关的产品。
1. APICloud开发平台
这里是APICloud的官方网站，也是整个APICloud应用开发和管理平台的入口。
a 在官方网站中，“开发者社区”标签下。
b 在官方的视频教程中。1.1 APICloud平台介绍 11
2.开发工具a
APICloud 是一个移动应用的开发平台，开发 APICloud 应用需要编码工具。对于开发工具
来说，APICloud 支持包括 Atom、Sublime Text、Eclipse、WebStorm、VSCode，以及基于 Node.
js 的 CLI 命令行工具。开发者在开发 APICloud 应用的时候，可以使用自己喜欢的任意一款主流
的编码工具，只需要在这些工具中安装相应的APICloud插件就可以了。
以 Sublime Text3 为例，如图 1-8 和图 1-9 所示，可以看到这里面有 Windows 版和 Mac
版的下载地址，这里所下载的是 APICloud 为 Sublime Text 提供的插件。下载完成后，打开
Sublime Text，在Sublime Text中安装完APICloud插件之后，就可以在Sublime Text 中使用“新
建 APICloud 项目”“新建 APICloud 文件”“进行 Wifi 真机同步”“日志输出”“代码管理”等开
发 APICloud 应用所需的相关功能。在其他工具中，如 Atom、WebStorm、Eclipse 和 VSCode 等
也可以分别安装 APICloud 为这些工具所提供的对应插件，所有这些 APICloud 的工具插件都是
免费开源的，可以在GitHub的APICloud开源分支b 中查看源码。
图 1-8
本书案例的开发会全程使用 APICloud Studio 2 作为开发工具，APICloud Studio 2 是
APICloud 提供给开发者的一款基于 Atom 扩展的全功能集成开发工具。在本书的附录 B 中，会
对 APICloud Studio 2开发工具的使用进行全面详细的介绍。
a 在官方网站点击“开发工具”。
b 在GitHub中搜索“APICloud-DevTools”。
更多免费电子书搜索「精品下载」 http:12 第1 章 APICloud App开发流程
图 1-9
3.开发文档a
整个 APICloud 开发文档包含了 3 部分内容，第一部分是对 APICloud 的整体介绍以及开发
工具的介绍，也就是其网页最左侧的这一列；中间部分是对APICloud API的介绍，包括端API、扩展模块、前端框架、云 API 等；最右侧是技术专题，这里会把开发过程中常见的问题以技术
专题的形式总结出来。不管是对 APICloud 的初学者，还是已经用 APICloud 开发过应用的开发
者，本书都建议在遇到问题的时候，第一个解决方式就是去查找文档。APICloud 文档遵循简洁
清晰的书写原则，用到某一个API的时候，直接到文档中查看其对应的使用说明即可。
4. 开发者社区b
APICloud 有着国内最活跃的 HTML5 混合开发者社区，在这个社区中，有很多优质和
资深的 APICloud 开发者，用户在使用中遇到的问题在社区中提问都可以第一时间获得解答。
APICloud 平台上线至今，社区中已经沉淀了很多有价值的帖子和技术专题的讨论，所以非常建
议开发者常去社区看看，那里的帖子都是各个开发者学习经验的总结。本书希望读者在开发过
程中遇到问题的时候，可以到社区中查找相关的解答或者提问，初学者最好能花一些时间把新
手入门的帖子从头到尾看一遍，这是非常有价值的。
a 在官方网站点击“文档”。
b 在官方网站点击“开发者社区”。1.1 APICloud平台介绍 13
5. VIP服务a
很多大型企业或者创业公司在选择 APICloud 的时候，由于整个项目的开发周期比较紧
张，而刚刚接触一个新的平台，使用中会遇到一些问题，这些问题在社区中是可以得到解决的，但是可能不够及时。针对这类客户，APICloud 提供了 VIP 技术支持服务，企业也可以去购买
APICloud企业版。当然这个是收费的，企业购买完之后，APICloud 将以工单的形式提供技术支
持，企业客户有任何问题，半个小时之内APICloud官方会有技术支持一对一地进行解答。
6.开源代码分享b
APICloud 提供了非常丰富的开源代码，这些源码包括 App 实例源码，很多都是 APICloud
开发者所开发的一些 App 模板源码，也包括一些模块的使用示例代码，以及 App 开发过程中
一些常用的 JavsScript 框架代码。当然，这里也有模块的源码，因为 APICloud 的很多模块都
是开源的，所以模块的源码就是 Android 和 iOS 的模块工程源码。同时，APICloud 为 Sublime
Text、Atom、WebStorm、Eclipse 等所有主流的开发工具提供的插件、命令行的 CLI 工具，以及
APICloud Studio所有的代码都是完全免费开源的。
这里也有 APICloud 前端框架和官方文档的源码，APICloud 官方文档本身就是开源的。读
者如果发现官方文档的编写存在不够准确或者不够完善的地方，可以随时在官方文档的开源分
支中提交修改，一同为 APICloud 生态发展做贡献。还有 APICloud 云 SDK，也就是 APICloud
提供的云端服务，官方提供了不同技术语言版本的 SDK，包括 Node.js、PHP、Java、.NET 等，这些不同语言版本的云API SDK 也都是开源的。
更多APICloud开源代码可以到APICloud GitHub开源分支c 查看。
7.商业案例展示d
目前，基于 APICloud 平台开发的应用已有 2 万多款在苹果 AppStore 上线。在 APICloud 商
业案例展示区，用户可以看到一些用 APICloud 开发出来的应用案例，每期会展示数百款的已
上线 App，这些案例都是用 APICloud 开发的商用 App，不是 WebApp，也不是微信公众号或
HTML5 网站。所有这些 App 旁边都有二维码，用户可以直接扫码安装体验，这些应用都是使
用 APICloud平台开发的。
如果 APICloud 的开发者开发了一款 App，并且认为其性能体验不错，可以联系 APICloud
官方的运营人员，申请在官网展示这款 App。APICloud 可以在案例区为其免费展示，案例区会
定期更新申请展示的App。初学者如果想看一下APICloud平台开发出来的App 是什么样的运行
a 在官方网站点击“VIP服务”。
b 点击官方网站中“开发者社区”标签下面的源码。
c 在GitHub中搜索“apicloudcom”。
d 在官方网站点击“开发案例”。
更多免费电子书搜索「精品下载」 http:14 第1 章 APICloud App开发流程
体验，就可以直接扫码安装运行这些案例，看一下体验和效果。
8.模块Storea (聚合API)
APICloud 模块 Store 上展示了 APICloud 平台上所有的扩展模块。APICloud 使用行业标准
的模块扩展机制，对于具有 Android 和 iOS 开发经验的开发者，可以直接按照 APICloud 模块扩
展机制为APICloud贡献模块，这些模块可以选择收费也可以免费。
目前，APICloud平台上有 600 多个模块，大部分的模块是免费的。大约有 13 是 APICloud
官方开发的，官方提供的所有模块都是免费的，基本可以覆盖 App 开发所需的全部基础功能；
还有 13 是第三方服务厂商开发的，比如高德地图、科大讯飞语音识别、融云即时通讯等；最
后的 13 是个人开发者开发的，个人开发者提供的模块大部分都是收费的。APICloud 是想建立
一个生态，对于 Android 和 iOS 的开发者，可以非常轻松地为 APICloud 模块 Store 贡献模块，同时模块开发者可以为其开发的模块标一个价格，让其他开发者购买后使用。
9.模板Storeb
APICloud还有一款产品是模板Store。开发者在开发完一个应用之后，如果不想再运营这个
应用了，或者是单纯想做一款应用的模板，如果它是一个完整的端到端的应用，整个需求和功
能都可以达到一个标准商业应用的水平，就可以将它作为一个模板提交给 APICloud。APICloud
官方可以把它模板化后成为 APICloud 模板 Store 中的一款模板。整体是有一个审核流程的。模
板审核通过之后，就可以在APICloud模板 Store 上进行销售。在模板 Store 上架后，其他开发者
只需一键购买，在线支付，就可以在几分钟之内获得这样一个模板。所购买的产品包括这个模
板的管理后台、模板的 Android 和 iOS 的安装包以及一些必要的皮肤定制等服务，同时在开发
者的 APICloud应用控制台中，也会有一个对应的“模板应用”的项目。
10. APICloud应用定制服务c
在 APICloud 平台上每天都会聚集很多客户的 App 定制需求，因为很多客户认可 APICloud
平台和App 开发模式，但是由于没有自己的开发团队，所以希望APICloud能够为他们提供App
定制服务，或者为他们推荐优质的团队来进行项目实施。APICloud 应用定制服务有一套标准化
的开发流程和项目管理流程。
1.1.5 新手入门APICloud应用开发
这里推荐一些优质的入门资料，读者可以在官方文档页面中找到这些资料。
a 点击官方网站中，“App开发平台”下面的模块Store。
b 点击官方网站，“App定制服务”下面的模板Store。
c 点击官方网站中的“App定制服务”。1.2 体验完整项目的开发流程 15
APICloud 新手开发指南，在这个指南当中，基本上涵盖了 APICloud应用开发入门所需
的各方面知识，并且 APICloud 官方也会不断更新这个教程，所以这个新手开发指南是
所有 APICloud初学者必须要认真阅读的文档。
APICloud新手教程集合贴a，这是社区里的新手教程集合贴，里面有很多优秀开发者的
开发技巧、经验和教程的总结，推荐新手一定要看。
APICloud 视频教程 b，如果初学者想找一种更简便的方式去学习，也可以去看看
APICloud的视频教程，在这个视频教程中已经有数百集的视频。
APICloud 在线培训，APICloud 定期会举办线上的视频直播培训，直播的老师既有
APICloud工程师，也有优秀的APICloud开发者或其他培训机构的老师来直播。
1.2 体验完整项目的开发流程
在对 APICloud 平台有了基础的认识后，读者将跟随本节内容从零开始，创建、修改、调
试、编译和运行一个最简单的 App。这个 App 不包含任何复杂的开发技术，旨在让读者体验一
个完整App的开发流程。在本节的最后，这个应用将可以在移动设备上运行。
1.2.1 注册APICloud账号
在创建 App 项目之前，首先要有一个 APICloud 账号，这个账号非常重要，请妥善保管。
点击 APICloud官方网站右上角的注册按钮即可开始注册。注册过程非常简单，注册完成后请登
录账户。
1.2.2 创建一个App项目
创建一个新的项目有两种方式：
在 APICloud云平台上创建；
在APICloud的官方开发工具中创建。
APICloud推荐的集成开发工具是APICloud Studio 2。同时也为其他常用的开发工具软件提
供了插件支持，如 Sublime、Eclipse、WebStorm、Atom 等，读者可以根据自己的使用习惯选择
对应的工具。
本书以 APICloud Studio 2 为例。首先需要下载这个开发工具，选择官网首页的“App 开发
平台”，然后选择“开发工具”。
a 点击官方网站中的“开发者社区”，搜索“新手教程集合贴”。
b 点击官方网站中的“视频教程”。
更多免费电子书搜索「精品下载」 http:16 第1 章 APICloud App开发流程
在新的页面中根据具体的操作系统选择对应版本的 APICloud Studio 2 进行下载。下载完成
后将压缩包解压到任意位置，在解压后的文件中找到类似“apicloud-studio-2.exe”的文件，这
是开发工具的可执行文件。建议为它创建桌面快捷方式以方便使用。
1.在APICloud云平台上创建新项目
在官方网站登录成功后，将鼠标移动到页面右上角的用户名处，在显示的菜单中点击“开
发控制台”。
打开控制台页面后，页面左侧是项目列表，现在它是空白的；在中间部分会显示 APICloud
的更新日志(APICloud 平台自上线以来一直坚持每周更新一个版本)等平台动向信息；右侧是
个人信息以及一些工具按钮，如图1-10 所示。
图 1-10
点击左上角的“创建应用”，在弹出的窗口中选中“Native App”(默认选项)，在“名称”
输入框中填入“HelloAPICloud”并在“说明”输入框中填入任意说明信息，之后点击创建。此
时一个新的项目便被创建好了并显示了刚刚创建项目的管理页面，后续会对这个页面的相关功
能进行循序渐进的学习。
在项目创建完成后还需要将这个项目检出到本地进行开发，APICloud支持通过git或svn进
行代码管理(关于代码版本管理的资料请查阅相关文档)，即便读者不了解代码版本管理的相关
知识也不妨碍本节的学习。1.2 体验完整项目的开发流程 17
打开 APICloud Studio 2，如果开发者是首次运行此开发工具则需要进行登录。请用之前创
建的账号进行登录，否则无法找到相应的项目。登录成功后会进入欢迎页面。
此时开发工具已经获得了账号权限，可以对项目进行操作了。点击菜单栏的“代码管
理”→“代码检出”→“APICloud 云端应用”，在出现的检索框中输入之前创建的项目名称
“HelloAPICloud”，回车确认(也可以从下面的模糊搜索结果中选择相应的项目，如图1-11所示)。
图 1-11
在弹出的对话框中选择这个项目在开发设备上的保存位置(例如在桌面上新建一个叫作
“HelloAPICloud”的文件夹，然后选择这个文件夹)并点击“检出”。
在新弹出的输入框中保持默认，直接按回车即可，如图1-12 所示。
图 1-12
开发工具会自动从 APICloud 云端将账号中的“HelloAPICloud”项目检出到本地计算机上，稍等便可以看到默认打开的代码编辑页面。
2.在APICloud Studio 2上创建新项目
打开 APICloud Studio 2 并登录之前创建的账号。点击菜单栏中的“文件”→“新建”→
“APICloud 移动应用”，分别输入应用名称和应用说明，应用框架选择“空白应用”，之后点击
更多免费电子书搜索「精品下载」 http:18 第1 章 APICloud App开发流程
完成。在弹出的对话框中选择新项目的创建位置，点击“创建”。
稍等便可以完成创建。此时在网站的控制台中可以看到刚刚创建的项目。
1.2.3 编辑项目
在开发工具左侧的目录树根目录中选择“html”目录下的“main.html”文件，找到
内 容 提 要
本书围绕 APICloud 平台，全面、系统、细致地讲述了 App 开发的相关内容，涉及平台工作原理、内部实现机制和应用开发技巧。本书涵盖了 APICloud 应用开发的必备知识，包括基础知识、关键技术、开发技巧和行业方案，并从实践角度出发，通过大量的实例代码、详细的操作步骤和丰富的开发截图，帮助开发者迅速掌握 APICloud 应用开发，有能力制作出好的 App。本书是 APICloud 开发者的最佳入
门指南，并配有免费的讲解视频，适合各种层次的 APICloud 学习者和开发者阅读。
著 邹 达 李德兴
责任编辑 杨大可
责任印制 马振武
人民邮电出版社出版发行 北京市丰台区成寿寺路11号
邮编 100164 电子邮件 315@ptpress.com.cn
网址 http:www.ptpress.com.cn
大厂聚鑫印刷有限责任公司印刷
开本：800?1000 116
印张：20.25
字数：431千字 2018年6月第1 版
印数：1 – 4 000册 2018年6月河北第1 次印刷
定价：69.00 元
读者服务热线：(010)81055410 印装质量热线：(010)81055316
反盗版热线：(010)81055315
广告经营许可证：京东工商广登字 20170147号
对本书赞誉
一项技术价值的高低在于其能帮助客户弥补多大的技术差距。移动 App 已逐渐成为企业业
务的基础设施，但移动开发人员的稀缺，导致大量的企业无法组建自身的研发队伍。雪上加霜
的是，移动App距离客户更近了，还需要更快速地迭代。APICloud正是为弥补这个缺口而诞生的。
尽管APICloud采用HTML5和JavaScript技术降低了开发难度，但仍需要开发者慢慢摸索。本书的
出版解决了困扰开发者的问题，进一步弥补了传统企业与优秀互联网公司之间的技术差距。
——林路，北极光创投合伙人
本书是程序员写给程序员的，其中充满了程序员的风格——平实、纯粹，还有理性的乐观。
我与本书的作者从各自创业开始，就持有一个共同的理念：App 开发平台(乃至操作系统)应
该高效、开放、跨平台、功能丰富。本书是这一理念最为具体的说明，而APICloud和中科创达
这两家公司，也是该理念的见证者。我会将本书推荐给我的同事、朋友、合作伙伴和客户阅读。
事实上，我已经在这么做了。
——邹鹏程，中科创达 CTO
和 APICloud 的小伙伴们相识好几年了，一直在用他们的平台做各种智能硬件相关的 App，也和他们一起举办过面向开发者的社区活动。APICloud CEO刘鑫在用户体验和服务上对细节的
无限追求，APICloud CTO邹达在技术上精湛的造诣，让大家用上了一款优秀的产品。早就觉得
他们应该出一本书了，所以这次收到样书一点也不意外，更是几乎一气呵成地读完，感觉这本
书应该叫“30天App开发从0到100”。本书的内容丰富翔实，包含了 App的规划、开发、调试、性能优化、上架等方方面面，还有数个不同行业的应用范例。无论是App开发的新手，还是“老
鸟”，本书都会给你带来全新的知识和视角。在智能设备端，跨平台App已经成为一个不可逆的
趋势，而APICloud则是我们的首选!
——刘琰，机智云 CTO
更多免费电子书搜索「精品下
载」https:yabook.org2 对本书赞誉
这是一本面向初学者但同时又会让有经验的开发者快速晋级的书。我在大学里接触最多的
就是新入学的“初级码农”，通过本书可以让他们迅速成长为可以交付 App 产品的开发者。这
种学习体验，对他们重新理解开发的含义以及建立对IT 学习的自信心都有极大帮助。另外，以
App实现为导向的面向 API的编程方法也是我个人非常推崇的一种开发趋势。
——梁震鲁，齐鲁工业大学网络信息中心副主任，国家高级职业指导师，APICloud社区优
秀讲师
我一向认为一本计算机类图书的作者，如果能够务实地站在App设计者的角度去思考问题，深入理解问题之间的相互关系，并且会针对程序员经常遇到的关键知识做通俗易懂的阐述和丰
富的实例验证，那么他给读者带来的不仅是知识，还有良好的程序员思维。希望本书的读者能
够从中领会作者的良苦用心。
——孙增斌，英特尔在线业务平台总监
本书是一本很好的开发入门教程，通俗易懂、由浅入深，并提供了丰富的实际案例，详细
介绍了如何使用前端开发语言和丰富的APICloud 平台扩展模块来跨平台开发移动App。相信每
位读者都能从本书中汲取相应的知识，它也将帮助我们的开发团队更好地开发移动App !
——丁美玲，泛亚汽车技术中心高级主任工程师
APICloud 平台以独有的快速 App 开发方式，将移动开发中的软件复用提升到一个新的高
度，可以帮助企业在短期内打造出满足业务需求的App，这一点我在实际使用中有切身的体会。
本书语言平实流畅、实例内容丰富，是对 APICloud 生态的又一巨大贡献，也是我们移动开发人
员的福音。读读本书，相信你一定会喜欢的!
——刘殿兴博士，中信证券信息技术中心高级副总裁
移动互联改变了人们的生活，更给企业带来经营模式的转变和新的商机。在这一过程中移
动 App 发挥了重要的作用。但是，对一般的非 IT 企业而言，高效建立 App 并不断地更新、维
持运行，会使企业担负很高的成本。直到有一天，我偶然发现 APICloud，它让我非常欣喜。
APICloud 是中国领先的“云端一体”移动应用云服务开发平台，能够满足移动创新者和传统企
业移动化这两个市场的 App 开发需求，并可以为开发者提供高效 App 开发和平台管理的一站式
服务，包括开发、API 集成、测试、渠道打包、运营管理的 App 全生命周期等。它已有数以万
计的成熟开发接口、多个行业的应用模板以及一些优秀开发者提供的快捷功能组件。APICloud
已经服务于很多行业的企业客户，并为客户带来省心、安心的 App 定制开发服务。如果你还在
为企业的App 开发而烦恼，那就试试APICloud吧，一定会让你取得事半功倍的效果。
——周伊丽，光大银行电子银行部副总经理 对本书赞誉 3
APICloud 平台是目前开发 App 最高效的平台之一，本书详尽地讲述了如何通过 APICloud
平台快速开发一款优质的 App，里面有大量的图文案例并配合实战讲解，通俗易懂，容易上手，非常适合初学者学习。
——朱亮，春秋航空运营总监
作为最早一批 APICloud 的使用者，还记得当初相识的关键字“30 天从 0 到 1”，这句话并
没有吹牛，我们用 APICloud 很快就完成了“战旗”的开发，并且经受住了百万日活用户的挑
战。我已经好久不写代码了，翻阅本书发现许多当初期望的功能都被逐一实现，只能感慨现在
的APICloud用户太幸福了。请记住，当你有想法时，一定要用APICloud启航。
——潘长煌，全民直播 CEO
更多免费电子书搜索「精品下载」 http:序
可能很多人不知道，规模大的企业和 IT 预算多的企业的移动 App 大部分都是基于混合模
式开发实现的。
很多做App开发的技术人员会存在一种偏见，觉得“采用混合模式，基于HTML5技术开发
出来的App，体验以及功能会和原生模式开发的存在差距”，所以更愿意使用原生模式开发App。
其实市场上主流的 App，绝大部分是基于混合模式开发的。最典型的就是微信，除了聊天
功能以外，包括公众号、小程序等都是由混合模式开发技术实现的。再比如电商领域的淘宝、京东等，旅游领域的携程，教育领域的 VipKid，信息分类的 58 等不同应用范围的 App，混合
模式开发技术使其商品展示及线上市场活动的运营管理都变得非常灵活。此外，在航空、保险、银行等行业中，无论是服务客户的toC 模式 App，还是对员工进行管理的toE和toB 的App，多
是使用混合模式开发的，混合模式开发技术成为了绝对主力。
人们不禁要问“为什么这些公司和企事业单位，有着足够的预算和开发资源，还要选择
混合模式 App 开发技术作为企业互联网化的支撑？”答案其实和企业的互联网化及数字化的
需求有着直接的联系。以下 4 个方面，决定了越有实力的企业越需要混合模式 App 开发技术；
同时，也是混合模式App开发技术形成不同行业解决方案的根本优势和企业选择的必要性所在。
速度的要求
“试错”这个词不但在互联网公司中广为流传，在传统公司的互联网化过程中也被广泛接受。
越来越多的CIO在谈各自企业移动战略的时候，都会提到“能否根据业务部门的一个想法，先在一周之内做个原型，快速实现，拿出去让大家看看，然后基于这个原型再修改”。这种快速发起、快速验证、快速调整的方法，已经非常流行。之所以要在短时间内先把业务从想法落到
现实，哪怕 App 粗糙些，也要先实现出来，原因在于具有鲜明企业个性的业务的创新想法可能
没有先例可循，很难考虑得特别完整。与其花费三五个月不停地思考业务需求，还不如用一两
个星期先把基础的想法落实。哪怕短时间内做出的 App 并不能真正满足业务的需要，但是可以
让业务人员的想法在这个过程中变得有据可依、有的放矢，从而为实现更完整且更切实可行的
业务方案先行探索。
“业务部门的一个想法，IT 部门一两周就做出来了!”这对于企业的信息化负责人而言，是很重要的褒奖。这种对速度的要求，恰恰是混合模式开发技术最明显的特长和优势，一套代
码可同步生成iOS与Android两个平台的App，甚至还能部分兼容微信公众号和小程序。一套代
码，并不代表偷懒或工程技术的简化，而更多的是因其不仅节省了代码编写的时间，还避免了
多个技术团队之间跨知识结构的协同问题，不再需要 iOS 与 Android 工程师们开会讨论差异性
问题，更是大幅节省了 App 与服务器端联机调试的时间成本。但如果同样的功能，同样从零开
始，使用传统的原生开发技术基本没有办法在一两个星期内完成有价值业务需求的实现，因为
这个时间可能连不同终端碎片化和差异化的问题都不足以解决。所以，CIO 为了满足业务发展
的需求和数字化速度的要求，在移动战略中往往都会规划使用跨平台的混合模式App开发技术。
业务灵活性的要求
在 PC 时代的 BS 架构中，想要实现 IT 系统的更新并不需要过多地考虑用户端的影响。因
为作为用户入口的浏览器一直处于访问网络的状态，只要网络连通，用户随时访问网站都会获
得最新的功能和业务。对用户而言，并不真正地存在版本的概念。只要访问服务器，服务器的
任何更新都可以随时展示到用户界面上，出现使用问题时，往往只需要清空一次浏览器 Cookie
基本就可以解决。
但是在移动时代，用户对版本的概念变得越发敏感。而对 App 的版本管理也成了 CIO 头
痛的问题。通常因为软件开发商能力的制约，或者一些无法避免的 bug，让一些已发布的 App
变得难用甚至会崩溃。此外，一些临时的市场活动、很少但重要的功能、一些不在规划内的
产品需求调整等情况，都会直接引出同一个问题“用户必须更新一个版本，重新下载安装，才
能满足上述需求”。这种看似日常的版本发布和用户更新，恰恰是传统企业信息化过程中面临
的全新问题。
“能否像传统浏览器那样，用户打开的永远是最新的服务和功能？”很多企业的 CIO 问出
了相同的问题，于是大量的、不合规的软件服务商和IT 程序员想出了一个“偷懒”的模式。在
App 中嵌入一些 WebView，将一些功能采用传统网页的模式，访问服务器，动态获取。虽然表
序 2
更多免费电子书搜索「精品下载」 http:3 序
面上解决了版本更新的问题，实则产生了大量体验很差的App。
企业对业务灵活性的要求，本质是希望像微信小程序一样，可以随时发布一些新的功能，随时动态增改一些功能的入口，让用户任意使用，同时让用户的体验更好。这种对业务灵活性
的需求其实需要像小程序一样有强大的混合模式App开发技术来支撑。从而达成“增量更新”“静
默更新”“打开获得新功能和新体验”，而不是嵌套WebView，用网页模拟 App 的方法，以较差
的用户体验的代价换取业务灵活的可行性。
当然，目前传统模式开发的 App，特别是用 Android 开发的 App 也开始部分支持动态更新。
这也恰恰说明，业务灵活性是企业互联网化、数字化进程的刚需。只是由于传统技术的制约以
及软件开发团队或者服务商能力的限制，真正的原生动态更新始终没有办法大规模进入企业，实现商用。这也让企业对混合模式 App开发技术的需求更为迫切，成为每个CIO 的必备选项。
集中管理的要求
业务部门的互联网化意识是因为互联网的广泛普及被带动起来的。所以，传统的由IT部门
主导企业信息化的态势发生了微妙的变化。过去，都是由 IT部门发起信息化需求，但现在的 IT
部门越来越像“服务部门”。因为业务团队在不停地发起各种各样“业务 + 互联网”的信息化
需求。这个时候，很多传统企业的 IT 部门领导，没认识到自己角色的转变，如果还存有拖延、不管不问、你们自己搞不定等类似的想法，就会导致当下很多企业的信息化面临的“各种移动
App 的彻底碎片化”“各个业务部门自己找软件开发商实现各自的需求”等问题。这不但架空了
IT 部门的信息化主导地位，更麻烦的是，让后续的集中管理变得艰难无比。几十家甚至上百家
不同标准的服务掺杂在企业的核心系统中，甚至有些业务部门为了快速满足自己的需求而脱离
了 IT部门主导的传统 PC核心系统，这些操作都是非常危险的。
IT 部门在被业务部门要求满足业务的互联网化需求时，往往发现心有余而力不足。IT部门
人手有限，实在没办法逐一满足所有业务部门的移动化需求。如果不管，就会产生前面所提到
的“技术栈、开发商”碎片化的问题。这个时候，基于混合模式App 开发技术的移动应用平台，就很好地解决了这二者之间的矛盾。
定标准，从而实现“集中管理”。如果企业能够制订一套统一的混合模式 App 开发技术和
移动平台标准，各个业务部门就可以独立寻找自己的软件开发商，用各种方法满足自己的移动
业务需求。平台的一致性可以带来标准化的统一。这其中包括技术标准化、开发流程标准化、代码管理标准化、项目管理标准化、验收标准化、管理和运营标准化等。
既要放，也要抓。这就是互联网时代企业信息化的要求，更是 IT 部门的职责。混合模式 序 4
App开发技术，有望成为实现企业移动战略的利器之一。
信息化安全的要求
企业互联网化带来的最根本转变就是，内网的信息化变成了外网的互联网化。
传统信息化一般包括内网、固定场所、固定网络环境和固定的设备等关键词。而移动战略
背景下的企业互联网化，则同时包括外网、随时、随地、员工个人设备、4G 和 Wi-Fi 等关键
词。这些不起眼的变化，给企业的业务带来的却是天翻地覆的调整。
移动设备管理软件(Mobile Devices Management，MDM)曾风靡一时，但是购买了 MDM
的企业几乎无一例外地发现其很难推进。因为 MDM 伴随着员工自带设备(Bring Your Own
Device，BYOD)。如果用企业的管理软件来管理员工个人设备，肯定会有很多人反对。所以，大部分的MDM 最终草草收场，只是管理了企业自己购买的一些移动设备。
企业移动化、互联网化的安全怎么保障？ 这要满足 3 个层面的安全，即设备安全、传统安
全和云端安全。
混合模式 App 开发技术可以实现类似于企业应用商店(如微信公众号)的动态权限绑定和
授权模式，能够支持特定设备、特定的人，也可以选择不同的子应用。此外，还可以实现随着
用户工作内容的调整，根据设备编码和用户权限来实时分配全新子应用的功能。
这种基于企业移动应用商店的“子应用”模式，也是混合模式App 开发技术成为企业移动
战略支撑的关键。因为做得好的企业应用商店，不仅能够满足传统原生模式开发的App 所不能
赋予企业的、对各种安全性的需求，还实现了对业务灵活性的管理目的。
APICloud作为中国主流的混合模式 App 开发技术服务提供商，一直在以布道者的身份推进
混合技术在国内的发展和应用。我们不仅提供技术，也提供商业服务，因此会更多地深入到大量
的商业用户中去，如海尔、春秋航空、英特尔、中信证券、上汽等。我们的团队结合不同的商业
场景和实际的商业客户需求，编写了本书，希望能够为不同规模的企业在移动信息化和互联网化
进程中提供有价值的参考，同时也能够让从事App开发的技术人员有更多可借鉴的实战经验。
刘鑫
APICloud创始人兼 CEO
2018 年3月于美国硅谷
更多免费电子书搜索「精品下载」 http:前言
时光荏苒，转眼间APICloud上线已经有3年多的时间了，在这3年多的时间里，APICloud
凭借自身的技术优势和坚持做好开发者生态的信念已经聚集了众多的 APICloud开发者。多年开
发者的经历让我们理解开发者，也深刻认识到任何一个平台或技术都不是三言两语能说清楚的，要想让开发者快速掌握APICloud 应用开发、少走弯路，我们需要编写出一套全面、系统、细致
的开发指南。这个想法一直都有，但是随着平台完善、引擎优化、API扩展和生态产品研发等工
作的开展，开发指南的编写工作迟迟未能完成。这里也向广大开发者表达歉意。
自从 2014 年 9 月 15 日 APICloud 平台上线以来，APICloud 开发团队一直坚持每周更新一
个版本，快速迭代，3 年多时间从未间断。现在 APICloud 平台稳定，功能齐全，生态繁荣，社
区活跃，开发者越来越多，要写出好 App 的需求也越来越迫切，这些让我们感到兴奋的同时，也备感压力。我们必须把自己的设计思想、意图和经验写出来，以满足开发者对技术的热情和
渴望，节省开发者宝贵的学习时间，同时也能指导开发者制作出优秀的App。
APICloud 是一个功能强大的开发平台，涉及的技术范围很广，虽然是自己亲手设计的产
品，也非常清楚开发者需要获知的核心知识，但是，想要把书写好也并非易事。作为官方出品
的第一本介绍APICloud的书，如何合理安排内容，如何能够由浅入深、循序渐进地展开，如何
才能最快地帮到开发者，这些都让我们反复思考，一遍遍地梳理各个知识点之间的关联。章节
的编排确实让我们很费脑筋，这也许就是理想与现实之间的差距吧。本书的作者都是 APICloud
一线开发工程师，均为纯粹的程序员出身，编码水平稍有自信，但是文学情调基本为零。在本
书中，我们力求用通俗的语言来讲述原理和机制，用简洁平实的语言来描述使用流程。但是，本书内容编排上可能还存在不足，用词可能还不够准确，文笔可能还不那么优雅和流畅，这些
还请广大读者谅解。
APICloud 以新的思想、新的技术、新的模式和新的工具来加速移动应用开发，并且让广大
的Web开发人员能够快速成为App开发专家。在本书中，我们会尽可能地通过详细的操作步骤、平实的语言、大量的实例代码和丰富的插图来讲清楚每一个知识点，并且给出大量的开发技巧
以适应不同的场景，迅速提高开发者水平。除了介绍应用层开发外，我们还通过增加对原理的
剖析，让开发者了解平台的内部工作机制，理解APICloud App设计的原理，从而掌握APICloud
的App开发方式和设计原则。
APICloud 团队是国内较早进行 Web 与 Native 技术融合的实践者，10 多年来见证了混合开
发技术在国内“悄悄地、慢慢地”火起来的全过程。APICloud 拥有行业领先的高性能App 混合
渲染引擎，APICloud 模块 Store 汇集了目前 App 开发需要使用的几乎所有主流 API，并一直在
持续更新。我们希望能把一切好的功能加入到 APICloud平台，目的就是能真正帮助开发者提高
效率，降低成本，解决问题。
访问APICloud平台官网，注册成为APICloud开发者，开始APICloud的开发之旅吧!
如何阅读本书
本书分3 个部分，一共包括16 章和 2个附录。
第一部分是基础教程，适合 APICloud 初学者。通过第一部分的学习初学者可以了解
APICloud 平台，熟悉 APICloud 云控制台操作和开发工具的使用，掌握开发一款 App 必须具备
的核心知识点、常用 API 和基础开发技巧，可以有能力独自完成一款简单App 的开发。读者在
学习过程中可以跟随示例代码一步步自己练习，再结合视频讲解学习 APICloud 应用的设计思
想，理解 APICloud 开发模式，从而找到理解 APICloud App 开发的正确方法和学习模式，为以
后有能力开发大型的复杂App 打下基础。
这一部分以一款实际案例的开发过程为例，所涉及的核心知识和编码技巧是开发一款优
APICloud App 的必备技能，初学者一定要深刻掌握。有一定 APICloud 开发经验的读者也可以
通过这一部分的学习，加深对 APICloud 应用设计思想和开发模式的理解，对 APICloud 知识体
系有一个更全面的认识，巩固APICloud核心知识点的使用。
这一部分共7章。第1章是一个非常全面的初学者入门教程，对APICloud平台、APICloud
App 开发流程、学习方法、学习资源做了全面的介绍。第 2 ～ 7 章详细讲解如何从零起点开发
一款App，以一个电商O2O App 为例，从创建 App 开始，一步步为其丰富功能，直到开发出一
款完整的App。在这个过程中演示了一个APICloud App开发的标准流程，贯穿讲解了 APICloud
App 开发过程中需要使用的所有核心知识点，包括界面布局、网络通信、数据存储、模块扩展
和开放服务调用等。
前言 2
更多免费电子书搜索「精品下载」 http:3 前言
虽然这一部分的内容是根据“APICloud 7 天培训课”的课程讲义和视频讲解整理而成的，但是本书对讲义和视频的内容进行了重新梳理和结构优化，确保知识体系的组织更加系统清晰、技术点的阐述更加全面细致、语言描述更加准确。
第二部分的实战技巧是 App 开发的进阶内容，适合已经具备一定 APICloud App 开发能力
的开发者。这一部分讲述的实战技巧是由诸多一线资深 APICloud 开发工程师从实战角度出发，总结多个项目经验，由浅入深精心提炼而成。这一部分的主要用意是抛砖引玉，让读者多角度、深层次地发掘 APICloud 所蕴含的技术能力和技术潜力，从而能够开发出更优质的 App 产品。
这一部分共5章。第8～11章的每一个实战技巧都可以作为一个独立的APICloud App运行，完整的示例代码和工程配置说明可以在本书的 GitHub 仓库中下载。读者既可以将其当作一个学
习参考的 Demo，也可以直接将其应用到具体 App 项目中，以实现具体的功能需求。第 12 章主
要介绍开发APICloud App的调试技巧，以及常用调试工具的使用。
第三部分是行业应用，向读者介绍 APICloud针对不同行业提供的解决方案，阐述为什么越
是有实力的企业越需要使用混合模式 App 开发技术，以及混合模式形成的不同行业解决方案的
根本优势和企业选择的必要性，并且列举了主流行业应用中被高频使用的几种模块和API。这一
部分共4 章(第13 ～ 16 章)，分别介绍IoT、教育、直播和电商这4 个领域。
附录A为APICloud App客户端开发规范(Version 1.0)，主要总结提升程序质量、App性能及
用户体验的开发规范。
附录 B 为开发工具 APICloud Studio 2 使用详解，是对这款云端一体的全功能集成开发工具
的详细使用说明。
配套视频
本书配套免费的“APICloud 7 天培训课”的完整视频教程(共约 70 讲 )。“APICloud 7 天
培训课”第 1 ～ 7 天的视频讲解与本书第一部分第 1 ～ 7 章的内容是相互关联的，读者可以通
过扫描二维码来观看这一视频教程。 前言 4
示例代码
本书的项目源码和资源都放在GitHub仓库a 里。我们后续也会通过这个开源分支来更新代
码和教程，解决读者所提出的问题，并进行后续版本的适配和代码的优化。
开发环境
APICloud 一直坚持支持多开发工具的策略，开发者可以使用任意一款自己喜欢的主流编
码工具来开发 APICloud App，只需要在这些工具中安装相应的 APICloud 插件就可以了。目前
APICloud 支持的开发工具包括 Atom、Sublime Text、Eclipse、WebStorm、VSCode 等。本书通
篇使用 APICloud Studio 2 作为开发工具，APICloud Studio 2 是一款基于 Atom 进行扩展的全功
能集成开发工具。读者可以阅读附录B 来了解这款工具的详细使用方法。
联系我们
由于编写时间仓促，书中难免会出现一些错误或者不准确的地方，恳请读者批评指正。如
果您有更多的宝贵意见，欢迎到APICloud开发者社区b 和我们进行互动和讨论。
邹达
APICloud联合创始人兼 CTO
2018 年 3 月21 日
a GitHub 搜索框内输入“apicloud 30-APP-0-1”即可。
b 在 APICloud官方网站点击“开发者社区”即可。
更多免费电子书搜索「精品下载」 http:
要获得以上配套资源，请在异步社区本书页面中点击 ，跳转到下载界面，按提
示进行操作即可(本书视频为扫码观看)。注意：为保证购书读者的权益，该操作会给出相
关提示，要求输入提取码进行验证。
提交勘误
作者和编辑尽最大努力来确保书中内容的准确性，但难免会存在疏漏。欢迎您将发现的
问题反馈给我们，帮助我们提升图书的质量。
当您发现错误时，请登录异步社区，按书名搜索，进入本书页面，点击“提交勘误” ，输入勘误信息，单击“提交”按钮即可。本书的作者和编辑会对您提交的勘误进行审核，确认并接受后，您将获赠异步社区的 100 积分。积分可用于在异步社区兑换优惠券、样书
或奖品。
z 配套视频。
z 本书源代码；
本书提供如下资源：
配套资源
本书由异步社区出品，社区(http:www.epubit.com)为您提供相关资源和后续服务。
资源与支持
扫码关注本书
扫描下方二维码，您将会在异步社区微信服务号中看到本书信息及相关的服务提示。
异步社区 微信服务号
更多免费电子书搜索「精品下载」 http:
的 LOGO。异步图书的出版领域包括软件开发、大数据、AI、测试、前端、网络技术等。
电出版社近 30 年的计算机图书出版积累和专业编辑团队，相关图书在封面上印有异步图书
“异步图书”是由异步社区编辑团队策划出版的精品 IT 专业图书的品牌，依托于人民邮
http:www.epubit.com。
IT 技术图书和电子书，以及高品质技术文章和视频课程。更多详情请访问异步社区官网
相关学习产品，为作译者提供优质出版服务。异步社区创办于 2015 年 8 月，提供大量精品
“异步社区”是人民邮电出版社旗下 IT 专业图书社区，致力于出版精品 IT 技术图书和
关于异步社区和异步图书
者权益的保护，也是我们持续为您提供有价值的内容的动力之源。
部分内容的非授权传播，请您将怀疑有侵权行为的链接发邮件给我们。您的这一举动是对作
如果您在网上发现有针对异步社区出品图书的各种形式的盗版行为，包括对图书全部或
发邮件给我们。
如果您是学校、培训机构或企业，想批量购买本书或异步社区出版的其他图书，也可以
www.epubit.comselfpublishsubmission 即可)。
发 邮 件 给 我 们 ； 有 意 出 版 图 书 的 作 者 也 可 以 到 异 步 社 区 在 线 提 交 投 稿 ( 直 接 访 问
如果您有兴趣出版图书、录制教学视频，或者参与图书翻译、技术审校等工作，可以
以便我们更高效地做出反馈。
如果您对本书有任何疑问或建议，请您发邮件给我们，并请在邮件标题中注明本书书名，我们的联系邮箱是 contact@epubit.com.cn。
与我们联系致谢
本书能够顺利完成，得到了很多同事和朋友的帮助。
感谢人民邮电出版社对APICloud平台的大力支持。
感谢人民邮电出版社信息技术分社社长、异步社区掌门人刘涛老师在2018 APICloud 开发
者大会上现场宣布本书预售。
感谢人民邮电出版社杨海玲老师对本书的支持。我们和海玲老师很早就认识，她有丰富的
图书策划和出版经验，这次能与她合作非常开心，合作过程也很愉快。感谢海玲老师在本书的
编写过程中(从内容组织到最终成稿)给予的悉心指导。
感谢我们的同事尚德聚、颉彬、王梦吉等参与了本书第二部分实战技巧的编写。
感谢广大的 APICloud 开发者，正是与你们的交流和互动造就了 APICloud 社区的繁荣，也
是你们的需求和应用推动着APICloud平台的不断完善和快速迭代。
感谢所有参与本书不同阶段书稿评审和代码验证的人。
感谢 Sean 和 May，我们相识多年，一起创业，没有你们的唠叨和压迫，我很难按时完成本
书的编写。目录
第一部分 基础教程：如何从零起步开发一款 App
第 1 章 APICloud App开发流程 3
1.1 APICloud平台介绍 4
1.1.1 查看APICloud平台能力 4
1.1.2 开发模式、技术语言和平台定位 6
1.1.3 技术、产品、生态、案例和商业模式 10
1.1.4 开发者服务体系 10
1.1.5 新手入门 APICloud应用开发 14
1.2 体验完整项目的开发流程 15
1.2.1 注册APICloud账号 15
1.2.2 创建一个App 项目 15
1.2.3 编辑项目 18
1.2.4 调试项目 18
1.2.5 编译项目 21
1.3 小结 22
第 2 章 搭建 App整体框架，完成 App静态页面开发 23
2.1 启动 25
2.1.1 APICloud App执行流程 25
更多免费电子书搜索「精品下载」 http:2 目录
2.1.2 Widget和Window 26
2.1.3 App config.xml配置文件使用 26
2.1.4 APICloud引擎的两个重要事件 27
2.2 APICloud应用设计思想 27
2.3 界面和导航 28
2.3.1 APICloud应用的 UI组成结构 28
2.3.2 APICloud界面布局 5大组件 29
2.3.3 APICloud混合渲染模式 30
2.3.4 查看 APICloud引擎 api对象功能 32
2.3.5 屏幕适配 33
2.3.6 前端框架 33
2.3.7 状态栏处理 34
2.3.8 iPhone X的状态栏处理 35
2.3.9 优化点击事件和 tapmode 37
2.3.10 静态页面中建议遵循的布局方法 37
2.4 搭建 App 整体框架，完成App静态页面开发 38
2.4.1 创建首页的标题栏和 Tab标签组 38
2.4.2 制作 Tab页面并添加点击事件和动画效果 43
2.4.3 制作悬浮购物车信息栏 48
2.4.4 跳转到登录页面 51
2.4.5 城市选择菜单和事件通信 52
2.5 小结 55
第 3 章 联调前后端数据接口，实现 App数据从服务端动态获取 56
3.1 APICloud提供的数据通信能力和相关 API 57
3.1.1 APICloud支持的通信协议 57
3.1.2 用于 HTTP通信的主要API 57
3.2 APICloud数据云 58
3.2.1 APICloud数据云的用途 58
3.2.2 APICloud数据云的特点 58
3.3 联调前后端数据接口，实现 App 数据从服务端动态获取 59 目录 3
3.3.1 实现用户注册功能 59
3.3.2 实现用户登录功能 60
3.3.3 获取商品列表数据 62
3.3.4 显示商品列表 63
3.4 小结 64
第 4 章 加载更新服务端数据，实现本地的数据存储 65
4.1 使用doT模板引擎 66
4.2 本地存储和图片缓存 67
4.2.1 uzStorage 67
4.2.2 偏好设置 67
4.2.3 文件 68
4.2.4 database 69
4.2.5 存储容量 69
4.2.6 沙箱机制 70
4.2.7 资源访问协议 70
4.2.8 图片缓存 71
4.3 下拉刷新、上拉加载的实现 71
4.3.1 下拉刷新 72
4.3.2 上拉加载 72
4.4 事件机制 72
4.4.1 统一事件管理 72
4.4.2 事件管理API 73
4.4.3 平台事件类型 74
4.5 常用对话框窗口 75
4.6 在指定的窗口中执行脚本 76
4.7 加载更新服务端数据，实现本地的数据存储 77
4.7.1 使用doT模板引擎显示商品列表 77
4.7.2 实现图片缓存 78
4.7.3 实现下拉刷新 79
4.7.4 实现上拉加载更多 81
更多免费电子书搜索「精品下载」 http:4 目录
4.7.5 实现保存登录信息 82
4.7.6 实现清除缓存 84
4.8 小结 85
第 5 章 使用扩展模块 API，完成 App所需功能实现 86
5.1 APICloud扩展模块 87
5.1.1 APICloud端引擎架构 87
5.1.2 APICloud模块调用过程 88
5.2 自定义模块 88
5.3 使用 UIScrollPicture 89
5.4 使用 UIInput 91
5.5 使用 UIActionSelector 92
5.6 多媒体相关模块使用 96
5.7 使用扩展模块 API，实现 App 所需功能 96
5.7.1 实现商品详情页轮播图 96
5.7.2 使用UIInput实现原生输入框 100
5.7.3 实现三级联动的城市选择器 101
5.7.4 实现头像上传 103
5.8 小结 105
第 6 章 使用第三方开放服务模块，完善 App功能和业务逻辑 106
6.1 集成第三方服务 107
6.2 目前 APICloud已经集成的第三方服务模块 107
6.3 自定义AppLoader 108
6.3.1 自定义 AppLoader与官方AppLoader的区别 108
6.3.2 为什么要使用自定义 AppLoader 109
6.3.3 编译生成自定义 AppLoader 109
6.4 第三方服务模块使用流程 110
6.5 百度地图模块的接入和使用 110
6.5.1 申请应用 ID 和 Key 110 目录 5
6.5.2 配置ID 和 Key 112
6.5.3 百度地图的常用API 112
6.6 微信分享与登录的接入和使用 114
6.6.1 申请ID 和 Key 114
6.6.2 配置ID 和 Key 114
6.6.3 微信分享模块的常用API 114
6.7 个推推送的接入和使用 117
6.7.1 申请ID 和 Key 117
6.7.2 配置ID 和 Key 117
6.7.3 个推模块的常用方法 117
6.8 支付宝支付模块的接入和使用 118
6.8.1 申请应用ID 和 Key 118
6.8.2 配置应用ID 和 Key 118
6.8.3 支付宝模块的常用API 119
6.9 使用第三方开放服务模块，完善App 功能和业务逻辑 119
6.9.1 获取当前城市 119
6.9.2 根据输入内容检索地址列表 121
6.9.3 使用个推进行消息推送 123
6.10 小结 124
第 7 章 使用 APICloud应用管理服务，实现 App发布和运营 125
7.1 编译生成 App 安装包 126
7.1.1 云编译 126
7.1.2 代码全包加密 127
7.1.3 扩展API调用安全配置 127
7.2 版本管理 128
7.2.1 在APICloud控制台管理版本 128
7.2.2 Config文件相关配置 129
7.2.3 mam 模块 129
7.3 云修复 130
7.3.1 Config文件相关配置和mam 模块 130
更多免费电子书搜索「精品下载」 http:6 目录
7.3.2 制作并发布云修复包 130
7.3.3 相关 API使用 131
7.4 闪屏广告 131
7.4.1 在 APICloud控制台使用闪屏广告 132
7.4.2 相关 API使用 132
7.5 优化策略 133
7.5.1 了解 HTML5 特性 133
7.5.2 窗口结构 133
7.5.3 页面加载速度 134
7.5.4 不用重型框架 134
7.5.5 屏幕适配 134
7.5.6 数据加载 134
7.5.7 图片处理 135
7.5.8 交互响应速度 135
7.5.9 尊重系统特性 135
7.6 编码规范 135
7.7 Widget管理 136
7.7.1 多 Widget架构 136
7.7.2 主 Widget 137
7.7.3 子 Widget 137
7.7.4 Widget管理相关API使用 137
7.8 SuperWebView 138
7.8.1 SuperWebView介绍 138
7.8.2 SuperWebView特点 138
7.9 使用 APICloud应用管理服务，实现 App 的发布和运营管理 138
7.9.1 编译 App 139
7.9.2 版本发布 139
7.9.3 使用云修复 139
7.9.4 闪屏广告 140
7.10 小结 140 目录 7
第二部分 实战技巧：如何开发一款优质的 App
第 8 章 如何与众不同 143
8.1 自定义样式的日期选择器 144
8.1.1 使用模块UICustomPicker 144
8.1.2 开发流程及要点概述 145
8.2 自动义样式的三级联动城市选择器 149
8.2.1 使用模块： UILinkedPicker 150
8.2.2 开发流程及要点概述 150
8.3 实现固定不动的下拉筛选菜单 152
8.4 滑动页面动态改变导航条颜色 155
8.4.1 实现思路 155
8.4.2 知识点说明 155
8.4.3 核心部分代码 155
8.5 实现高斯模糊的背景图片 156
8.6 精致0.5 px 细线的实现 158
8.7 小结 159
第 9 章 挖掘 API 潜力 160
9.1 深入挖掘Frame的各种应用场景 161
9.1.1 模拟页面按钮 161
9.1.2 模拟窗口组件 161
9.1.3 模拟侧滑窗口 163
9.2 使用 UIScrollPicture模块开发引导页 164
9.2.1 概述 165
9.2.2 实现思路 165
9.3 使用 photoBrowser模块实现自定义样式的图片浏览功能 167
9.3.1 概述 167
9.3.2 自定义样式图片浏览器功能实现步骤 168
9.4 使用 UIInput模块实现自定义搜索界面 170
更多免费电子书搜索「精品下载」 http:8 目录
9.4.1 概述 170
9.4.2 自定义搜索界面实现步骤 170
9.5 使用 UIChatBox模块实现聊天界面 172
9.5.1 概述 172
9.5.2 UIChatBox 模块实现聊天界面实现步骤 173
9.6 使用 api.ajax进行网络请求 176
9.7 小结 179
第 10 章 超级实用技巧 180
10.1 如何让页面动态适配有虚拟按键栏的 Android手机 181
10.2 获取手机验证码功能的实现 182
10.3 打开一个外部链接作为新的页面，并设置样式以及事件监听 184
10.4 实现更换皮肤功能 186
10.5 实现多语言切换功能 187
10.6 调用任意App 189
10.6.1 URL Scheme应用场景 189
10.6.2 URL Scheme在APICloud中的应用 189
10.7 数据表格的快速开发 191
10.7.1 使用 APICloud模块实现数据表格的开发 192
10.7.2 使用第三方 JavaScript框架实现数据表格的开发 193
10.8 apiready与 window.onload的平衡使用 194
10.8.1 apiready与window.onload区别 194
10.8.2 apiready与window.onload的使用时机 194
10.8.3 应用实例 195
10.9 地图模块的实用扩展：在地图上添加自定义按钮 196
10.10 地图搜索的高级应用：如何获取城市地铁线路列表 198
10.10.1 需求分解 198
10.10.2 功能实现 198
10.11 极光推送的快速实现 200
10.11.1 获取 App包名 200
10.11.2 获取极光推送AppKey 201 目录 9
更多免费电子书搜索「精品下载」 http:
12.3.4 把待调试代码同步到 AppLoader 227
12.3.3 开启 iOS 设备的 Web 检查器功能 226
12.3.2 显示桌面 Safari 浏览器的“开发”菜单 226
12.3.1 从 APICloud 官网编译安装自定义 AppLoader 226
12.3 调试技巧：使用 Safari 断点调试 iOS 应用 226
12.2.3 使用本地文件作为接口返回值 224
12.2.2 构建模拟数据 223
12.2.1 请求示例代码 222
12.2 调试技巧：使用 Charles 模拟网络请求 222
12.1.2 查看 http 请求 219
12.1.1 查看 HTTP 请求 217
12.1 调试技巧：使用 Charles 查看网络请求 217
第 12 章 调试技巧 216
11.5 小结 215
11.4.3 应用实例 214
11.4.2 异步的优势 213
11.4.1 JavaScript 的同步 异步机制 212
11.4 合理使用同步 异步接口 212
11.3.3 关键代码实现 211
11.3.2 正确的做法 211
11.3.1 程序员的思维习惯 210
11.3 流畅的用户登录体验 210
11.2 数据不要从 DOM 上获取 208
11.1 用 imageCache 缓存图片 206
第 11 章 性能优化探索 205
10.12 小结 204
10.11.5 开始推送 203
10.11.4 在代码中监听推送消息 202
10.11.3 配置极光推送模块 20210 目录
12.3.5 Safari断点调试iOS 应用 228
12.4 调试技巧：使用Chrome断点调试Android应用 229
12.4.1 从 APICloud官网安装AppLoader 230
12.4.2 在 Android手机上开启USB调试 231
12.4.3 把待调试代码同步到 AppLoader 231
12.4.4 在 Chrome中断点调试 232
12.5 小结 235
第三部分 行业应用：如何快速开发主流行业 App
第 13 章 如何快速开发一款 IoT App 239
13.1 IoT App的分类和功能 240
13.1.1 IoT App 的分类 240
13.1.2 IoT App 的主要功能 240
13.2 IoT App的技术架构 241
13.2.1 两方通信架构 241
13.2.2 三方通信架构 241
13.2.3 四方通信架构 242
13.3 IoT App中高频使用的 API 243
13.3.1 界面组件类模块 243
13.3.2 功能扩展类模块 244
13.3.3 开放服务类模块 245
13.4 如何使用 APICloud开发一款 IoT App 246
13.5 小结 246
第 14 章 如何快速开发一款教育 App 247
14.1 教育 App的分类和功能 248
14.1.1 教育 App的分类 248
14.1.2 教育 App 的主要功能 248
14.2 教育 App的产品架构 249
14.2.1 产品功能架构 249 目录 11
14.2.2 学习计划架构 250
14.3 教育 App中高频使用的API 250
14.3.1 UI 组件类模块 250
14.3.2 功能扩展类模块 251
14.3.3 开放服务类模块 252
14.4 如何使用 APICloud开发一款教育App 253
14.5 小结 253
第 15 章 如何快速开发一款直播 App 254
15.1 直播 App的分类和功能 255
15.1.1 直播 App 的分类 255
15.1.2 直播 App 的主要功能 255
15.2 直播 App技术架构 256
15.3 直播App 中高频使用的 API 256
15.3.1 UI 组件类模块 257
15.3.2 功能扩展类模块 258
15.3.3 开放服务类模块 258
15.4 如何使用 APICloud开发一款直播App 259
15.5 小结 260
第 16 章 如何快速开发一款电商 App 261
16.1 电商 App的分类和功能 262
16.1.1 电商 App 的分类 262
16.1.2 电商 App 的主要功能 263
16.2 电商 App的产品结构 263
16.2.1 前端产品结构 263
16.2.2 后台产品结构 264
16.3 电商 App中高频使用的API 265
16.3.1 UI 组件类模块 265
16.3.2 功能扩展类模块 266
更多免费电子书搜索「精品下载」 http:12 目录
16.3.3 开放服务类模块 267
16.4 如何使用 APICloud开发一款电商 App 267
16.5 小结 268
附录 A APICloud App客户端开发规范(Version 1.0) 269
附录 B 开发工具 APICloud Studio 2使用详解 282第一部分
基础教程：如何从零起步开发一款 App
更多免费电子书搜索「精品下载」 http:在这一部分中，第1章将对APICloud平台做一个整体的介绍，包括平台能力、开发模式、学
习资源和开发者社区等，之后会介绍如何使用APICloud完成一个最简单的App的完整开发流程。
第 2 ～ 7 章将带领读者从零起步去开发一款 O2O 类型的电商 App，其中会涉及 APICloud
开发的基础理论和常用技术，帮助读者快速入门。对于第一部分的整体内容，建议读者结合随
书附赠的视频教程去学习，理解课程当中讲到的每个技术细节，然后再亲手练习。学会这些内
容，就有能力去独立开发一款App了。
第一部分的项目源码和所有资源在GitHub库a 里。我们后续也会通过这个开源分支来更新
代码和教程，解决读者所提出的问题，并进行后续版本的适配和代码的优化。
a GitHub搜“apicloud30-APP-0-1”。第1章
APICloud App开发流程
主要内容
本章从总体上介绍 APICloud 平台，包括 APICloud 应用的开发模式、设计思想、控制台使
用流程等，并以一个HelloWorld App 为例让读者体验一个完整的APICloud App的开发流程。
学习目标
(1)了解 APICloud 平台，了解 APICloud 相关的学习资源、入门资料和常见的问题。让没
有接触过 APICloud 平台的读者，对平台有一个基础的了解；让学习过 APICloud 并且已掌握一
部分技能的读者，通过本章的学习，可以快速找到需要的资料和解决问题的方法。
(2)学习如何在 APICloud 平台上创建、修改、调试、编译和运行一个最简单的 APICloud
App。掌握APICloud App完整的开发流程。
要对 APICloud 平台做一个全面的介绍，需要花很长的时间和很多的篇幅来讲解每一个细
节，而本书作者希望能用更多的篇幅来讲解一个 App 的实际开发过程，讲解具体的代码实现。
所以，本章在介绍 APICloud平台的时候，是通过抛出一个个问题，然后告诉读者应该到哪儿去
找对应的学习资源，到哪儿能够找到解决问题的方案。
更多免费电子书搜索「精品下载」 http:4 第1 章 APICloud App开发流程
1.1 APICloud平台介绍
本章将从 APICloud 可以做什么，如何获取使用帮助，APICloud 的技术、产品和生态等多
个方面对APICloud平台加以介绍。
1.1.1 查看APICloud平台能力
开发者在接触一个开发平台的时候，通常第一个想法就是去查看这个平台的能力。特别是
那些想做 App 的、有着明确需求的开发者，他们会非常关心自己的需求在这个开发平台上是否
能够满足。所以，本书开篇就先来解决这个开发者普遍关心的问题，读者可以带着自己预先想
好的需求来了解APICloud平台，了解如何能够快速地在 APICloud平台上查找相关的能力。
1.通过官方文档快速搜索功能模块
查看APICloud平台提供的能力，一个最基础也是最有效的方法就是查看APICloud的API文档。
APICloud 官方网站中的文档页面如图 1-1 所示。如需要查看视频播放的功能，可以在文档
中搜索“视频播放”，搜索结果如图 1-2 所示，可以看到在 APICloud 平台上有多种提供视频播
放功能的模块，如 videoPlayer(播放本地视频)、moviePlayer(播放网络视频)、polyvPlayer(保
利威视播放器)、baiduPlayer(百度播放器)等。
图 1-11.1 APICloud平台介绍 5
图 1-2
点击其中一个搜索结果，查看模块的详细文档。比如点击“videoPlayer”之后可以看到这个
模块对于视频播放提供了很多 API，这些 API 基本覆盖了一个视频播放器所有常见的功能，如
图1-3 所示。
图 1-3
再比如要查找支付功能，可以在文档中搜索“支付”，通过搜索结果可以看到在 APICloud
更多免费电子书搜索「精品下载」 http:6 第1 章 APICloud App开发流程
平台上有很多个提供支付功能的模块，如 aliPay(支付宝)、wxPay(微信支付)、unionPay(银
联支付)、paypal(PayPal 支付)、iap(iOS 应用内支付)等；也有 ping++、beeCloud 等第三方
聚合类的支付模块。点击每个模块均可以查看具体的API详情。
读者想了解APICloud平台有哪些能力，最简单的方法就是到APICloud官方文档中去搜索相应
的功能，这样就可以一目了然地知道APICloud平台有没有相应的模块来支持自己想要的功能。
2. APICloud能力支撑体系
目前在 APICloud 平台上已经提供了 600 多个模块，上万个 API。这些 API 基本可以覆盖一
款 App所需的所有常用功能，为方便表述，它们被分为“平台使用”“基础功能”“界面布局”“设
备特性”“功能扩展”和“开放服务”六大类，其分类与具体包含内容如图1-4 所示。
图 1-4
1.1.2 开发模式、技术语言和平台定位
很多APICloud初学者会关心这些问题： APICloud App的开发模式是什么样的、使用什么技
术语言、目前自己的开发团队是否适合使用 APICloud 开发 App、整个 APICloud 的学习曲线是
什么样的、入门简不简单等。
1.开发模式和技术语言
APICloud 应用的开发模式是使用标准的 HTML、CSS 和 JavaScript+APICloud 扩展 API 来
进行 App 开发，如图 1-5 所示。APICloud的 App 开发使用的是标准的 HTML5 技术，针对标准
HTML5 所不具备的功能或是用 HTML5 实现体验不好的功能(这些功能也是开发者在 App 开
发过程中非常常用的功能)。APICloud 提供了 600 多个扩展模块和上万个 API，通过这些模块和1.1 APICloud平台介绍 7
API来扩展HTML5的功能，满足 App的开发需求。
图 1-5
2.扩展API调用方式
APICloud 扩展 API 的调用方式与调用标准的 JavaScript 方法是完全一样的。APICloud 引擎
的核心 API 是放在 window.api 这个对象下面的，这个对象是 APICloud 在 JavaScript 全局作用
域内扩展的唯一一个对象，可直接调用。如果想调用某个模块下面的方法，可以通过 require
的方式动态引入，通过在 api.require 方法的参数中指定某个模块的名称来引入相应的模块，然后调用模块下面的方法，具体演示如下。
核心API在window.api对象下，可以直接调用
api.methodName(param, callback);
扩展模块需要require引入，遵守CommonJS规范
var module = api.require('moduleName');
module.methodName(param, callback);
param: {} 参数，是一个JSON对象
callback: function(ret, err){} 回调函数，是一个Function对象，异步方法调用的结果通过此函数返回
所有 API 的调用方式都是相同的，第一个参数是一个JSON 对象，承载着要传递给模块的
信息；第二个参数是一个 callback 函数。APICloud 大部分的 API 调用都是异步方式，在调用的
时候，要指定一个callback函数，当这个API操作完成时，操作结果将通过该callback函数回调。
一些常用的调用方式，比如打开一个新窗口，可以调用 api.openWin ；打开通讯录可以
调用 api.openContacts，录音、图片缓存等也是调用相应的方法。如果想去加载文件系统
模块，可以通过 api.require(fs) 来加载 fs模块，然后调用 fs模块下面的方法。使用条码扫
描模块也是类似的。示例如下。
打开新窗口： api.openWin。
打开系统通讯录： api.openContacts。
更多免费电子书搜索「精品下载」 http:8 第1 章 APICloud App开发流程
录音： api.startRecord。
缓存网络图片：api.imageCache。
加载 fs模块： var fs = api.require('fs')。
新建一个文件：fs.createFile。
加载二维码 条形码扫描模块：var scanner = api.require('FNScanner')。
打开二维码 条形码扫描：scanner.openScanner。
APICloud 技术是基于标准的 HTML、CSS 和 JavaScript 技术，并在标准的 JavaScript 基础上
扩展了一个核心对象 -api 对象和数百个模块。这些模块可以使用 api.require 函数载入，并使用
操作标准JavaScript对象的方式调用上述模块列举出方法。
3.扩展API的作用
读者可能会问，APICloud 为什么要扩展这么多 API 呢？其实 APICloud 所扩展的 API 都是
标准的 JavaScript 所不支持的方法，或是用标准 HTML5 来实现但体验不好的功能。读者可以把
HTML5 理解成一门技术、一门语言，但是它还没有达到一个平台的水平。这就是 APICloud 为
什么要做这些扩展。APICloud所有的扩展主要是围绕以下这4个方面进行的。
兼容性：在 PC互联网时代，浏览器具有多种内核，JavaScript框架产生的最初原因就是
为了实现 JavaScript 代码在各种浏览器上的兼容和适配。在移动互联网时代，虽然在主
流的手机系统中，Android 和 iOS 的浏览器内核都是 webkit，但是出于商业原因，谷歌
从 webkit 中建立了一个新的分支，叫 blink。现在两个分支的主要贡献者分别是苹果和
谷歌，所以未来这两个内核的兼容性问题会一直存在。
实用性：
` Page 不等于 App，标准的 HTML、CSS 和 JavaScript 规范更多是用来定义网页和文
档的，例如现在的一些框架都在讲 SPA 结构，它是以单页面为主的，很多 HTML
标签是针对于文本信息展示的；而 App 则不然，App 更多是强调功能和体验，在
原生系统中有很多的组件，HTML5 标签和 Native 组件的设计规范是完全不同的。
所以，想用标准的 HTML5 技术开发一个 App 是不现实的，人们不能直接把为
WebPage所制定的规范直接搬到App上。
` BS 架构与 ClientCloud 架构：在 PC 互联网时代，终端产品的主要架构还是 BS
架构；但是在移动互联网时代，终端产品的主要类型是App，而 App 是一个完整的
ClientCloud 架构。在移动端，实现界面和功能，在云端提供数据和服务。页面布
局是存放在移动端的，功能实现也是在移动端完成，所以用户在使用时可以感受到
App的启动、页面渲染和布局展示是很快响应的。
`速度、交互和体验：这 3 个问题是用 HTML5 技术直接开发 App 的最大挑战。其
实，如果使用 HTML5 技术实现一个界面，渲染之后显示出来，用户看到这个界面1.1 APICloud平台介绍 9
时并不能立刻分辨出它是用 HTML5 实现的还是用 Native技术实现的。但是当用户
做一个交互，点击一下，体验一下响应速度或者做一个手势，触发一个动画，这时
用户就可以非常清楚地感受到，并能分辨出该界面是用 Native 技术开发的还是用
HTML5 开发的。所以速度、交互和体验也是使用 HTML5 技术开发 App 必须去解
决的问题。
持续性、静态标准与动态标准：HTML5 的定稿花了 7 年时间，并且整个标准的迭代是
缓慢的；而 Android和 iOS 每一次版本更新都会新增很多功能，这些新增的恰恰都是当
前行业里最需要的功能，但这些功能很难快速通过制定新的 HTML5 标准进行更新，并
在各个浏览器里支持起来。那会是一个非常漫长的过程。
扩展性：在开发一款 App 的时候，开发人员需要扩展很多的功能，有时候要和行业特
点结合，有时候还要跟硬件结合，这就会用到大量国内的开放服务，如推送、直播、智能识别等。所有的这些功能，标准的 HTML5 规范中都没有定义，所有的标准浏览器
引擎也没有默认支持。
总的来说，APICloud 扩展的所有功能都是标准 HTML5 所没有的，如果 HTML5 有并且在
App 中运行起来没有任何问题，APICloud 平台也没有必要去做这个扩展。APICloud 所有扩展的
功能其实就是为了去解决 HTML5 在兼容性、实用性、持续性和扩展性等方面的问题。
4.模块Store
在APICloud模块Store中可以查看APICloud平台扩展的所有功能，如图1-6 所示。
图 1-6
更多免费电子书搜索「精品下载」 http:10 第1 章 APICloud App开发流程
5. APICloud平台定位
APICloud 是一个中间层，是在应用程序和系统之间的一层，在这一层中，APICloud 聚合
了开发一款 App 所需要的所有系统调用、开放服务和扩展功能，然后以统一 API 的形式提供给
开发者调用。这就是APICloud平台的定位，如图1-7 所示。
图 1-7
1.1.3 技术、产品、生态、案例和商业模式
这部分有大量的内容需要给读者介绍，但是本书不想为此占用大量的篇幅。读者可以通过
APICloud官网公开课的视频来详细了解。在官方视频教程a中有几百集的课程，其中“APICloud
视频之初级代码篇第1～3讲b”通过几小时的视频给读者详细介绍了APICloud技术、产品、商
业模式、案例以及生态的方方面面，如果读者是第一次接触 APICloud，我们建议花一定的时间
去观看这些公开课的视频。
1.1.4 开发者服务体系
开发者在选择或者使用一个平台的时候，一定会遇到很多的问题。遇到问题时应该如何解
决？此外，开发者还会关心这个平台在提供技术的同时还能提供哪些服务？有没有一个完整的
生态？有没有一个活跃的社区提供技术支持、方便学习和交流？
针对这些问题，本节列举以下 APICloud开发者服务体系相关的产品。
1. APICloud开发平台
这里是APICloud的官方网站，也是整个APICloud应用开发和管理平台的入口。
a 在官方网站中，“开发者社区”标签下。
b 在官方的视频教程中。1.1 APICloud平台介绍 11
2.开发工具a
APICloud 是一个移动应用的开发平台，开发 APICloud 应用需要编码工具。对于开发工具
来说，APICloud 支持包括 Atom、Sublime Text、Eclipse、WebStorm、VSCode，以及基于 Node.
js 的 CLI 命令行工具。开发者在开发 APICloud 应用的时候，可以使用自己喜欢的任意一款主流
的编码工具，只需要在这些工具中安装相应的APICloud插件就可以了。
以 Sublime Text3 为例，如图 1-8 和图 1-9 所示，可以看到这里面有 Windows 版和 Mac
版的下载地址，这里所下载的是 APICloud 为 Sublime Text 提供的插件。下载完成后，打开
Sublime Text，在Sublime Text中安装完APICloud插件之后，就可以在Sublime Text 中使用“新
建 APICloud 项目”“新建 APICloud 文件”“进行 Wifi 真机同步”“日志输出”“代码管理”等开
发 APICloud 应用所需的相关功能。在其他工具中，如 Atom、WebStorm、Eclipse 和 VSCode 等
也可以分别安装 APICloud 为这些工具所提供的对应插件，所有这些 APICloud 的工具插件都是
免费开源的，可以在GitHub的APICloud开源分支b 中查看源码。
图 1-8
本书案例的开发会全程使用 APICloud Studio 2 作为开发工具，APICloud Studio 2 是
APICloud 提供给开发者的一款基于 Atom 扩展的全功能集成开发工具。在本书的附录 B 中，会
对 APICloud Studio 2开发工具的使用进行全面详细的介绍。
a 在官方网站点击“开发工具”。
b 在GitHub中搜索“APICloud-DevTools”。
更多免费电子书搜索「精品下载」 http:12 第1 章 APICloud App开发流程
图 1-9
3.开发文档a
整个 APICloud 开发文档包含了 3 部分内容，第一部分是对 APICloud 的整体介绍以及开发
工具的介绍，也就是其网页最左侧的这一列；中间部分是对APICloud API的介绍，包括端API、扩展模块、前端框架、云 API 等；最右侧是技术专题，这里会把开发过程中常见的问题以技术
专题的形式总结出来。不管是对 APICloud 的初学者，还是已经用 APICloud 开发过应用的开发
者，本书都建议在遇到问题的时候，第一个解决方式就是去查找文档。APICloud 文档遵循简洁
清晰的书写原则，用到某一个API的时候，直接到文档中查看其对应的使用说明即可。
4. 开发者社区b
APICloud 有着国内最活跃的 HTML5 混合开发者社区，在这个社区中，有很多优质和
资深的 APICloud 开发者，用户在使用中遇到的问题在社区中提问都可以第一时间获得解答。
APICloud 平台上线至今，社区中已经沉淀了很多有价值的帖子和技术专题的讨论，所以非常建
议开发者常去社区看看，那里的帖子都是各个开发者学习经验的总结。本书希望读者在开发过
程中遇到问题的时候，可以到社区中查找相关的解答或者提问，初学者最好能花一些时间把新
手入门的帖子从头到尾看一遍，这是非常有价值的。
a 在官方网站点击“文档”。
b 在官方网站点击“开发者社区”。1.1 APICloud平台介绍 13
5. VIP服务a
很多大型企业或者创业公司在选择 APICloud 的时候，由于整个项目的开发周期比较紧
张，而刚刚接触一个新的平台，使用中会遇到一些问题，这些问题在社区中是可以得到解决的，但是可能不够及时。针对这类客户，APICloud 提供了 VIP 技术支持服务，企业也可以去购买
APICloud企业版。当然这个是收费的，企业购买完之后，APICloud 将以工单的形式提供技术支
持，企业客户有任何问题，半个小时之内APICloud官方会有技术支持一对一地进行解答。
6.开源代码分享b
APICloud 提供了非常丰富的开源代码，这些源码包括 App 实例源码，很多都是 APICloud
开发者所开发的一些 App 模板源码，也包括一些模块的使用示例代码，以及 App 开发过程中
一些常用的 JavsScript 框架代码。当然，这里也有模块的源码，因为 APICloud 的很多模块都
是开源的，所以模块的源码就是 Android 和 iOS 的模块工程源码。同时，APICloud 为 Sublime
Text、Atom、WebStorm、Eclipse 等所有主流的开发工具提供的插件、命令行的 CLI 工具，以及
APICloud Studio所有的代码都是完全免费开源的。
这里也有 APICloud 前端框架和官方文档的源码，APICloud 官方文档本身就是开源的。读
者如果发现官方文档的编写存在不够准确或者不够完善的地方，可以随时在官方文档的开源分
支中提交修改，一同为 APICloud 生态发展做贡献。还有 APICloud 云 SDK，也就是 APICloud
提供的云端服务，官方提供了不同技术语言版本的 SDK，包括 Node.js、PHP、Java、.NET 等，这些不同语言版本的云API SDK 也都是开源的。
更多APICloud开源代码可以到APICloud GitHub开源分支c 查看。
7.商业案例展示d
目前，基于 APICloud 平台开发的应用已有 2 万多款在苹果 AppStore 上线。在 APICloud 商
业案例展示区，用户可以看到一些用 APICloud 开发出来的应用案例，每期会展示数百款的已
上线 App，这些案例都是用 APICloud 开发的商用 App，不是 WebApp，也不是微信公众号或
HTML5 网站。所有这些 App 旁边都有二维码，用户可以直接扫码安装体验，这些应用都是使
用 APICloud平台开发的。
如果 APICloud 的开发者开发了一款 App，并且认为其性能体验不错，可以联系 APICloud
官方的运营人员，申请在官网展示这款 App。APICloud 可以在案例区为其免费展示，案例区会
定期更新申请展示的App。初学者如果想看一下APICloud平台开发出来的App 是什么样的运行
a 在官方网站点击“VIP服务”。
b 点击官方网站中“开发者社区”标签下面的源码。
c 在GitHub中搜索“apicloudcom”。
d 在官方网站点击“开发案例”。
更多免费电子书搜索「精品下载」 http:14 第1 章 APICloud App开发流程
体验，就可以直接扫码安装运行这些案例，看一下体验和效果。
8.模块Storea (聚合API)
APICloud 模块 Store 上展示了 APICloud 平台上所有的扩展模块。APICloud 使用行业标准
的模块扩展机制，对于具有 Android 和 iOS 开发经验的开发者，可以直接按照 APICloud 模块扩
展机制为APICloud贡献模块，这些模块可以选择收费也可以免费。
目前，APICloud平台上有 600 多个模块，大部分的模块是免费的。大约有 13 是 APICloud
官方开发的，官方提供的所有模块都是免费的，基本可以覆盖 App 开发所需的全部基础功能；
还有 13 是第三方服务厂商开发的，比如高德地图、科大讯飞语音识别、融云即时通讯等；最
后的 13 是个人开发者开发的，个人开发者提供的模块大部分都是收费的。APICloud 是想建立
一个生态，对于 Android 和 iOS 的开发者，可以非常轻松地为 APICloud 模块 Store 贡献模块，同时模块开发者可以为其开发的模块标一个价格，让其他开发者购买后使用。
9.模板Storeb
APICloud还有一款产品是模板Store。开发者在开发完一个应用之后，如果不想再运营这个
应用了，或者是单纯想做一款应用的模板，如果它是一个完整的端到端的应用，整个需求和功
能都可以达到一个标准商业应用的水平，就可以将它作为一个模板提交给 APICloud。APICloud
官方可以把它模板化后成为 APICloud 模板 Store 中的一款模板。整体是有一个审核流程的。模
板审核通过之后，就可以在APICloud模板 Store 上进行销售。在模板 Store 上架后，其他开发者
只需一键购买，在线支付，就可以在几分钟之内获得这样一个模板。所购买的产品包括这个模
板的管理后台、模板的 Android 和 iOS 的安装包以及一些必要的皮肤定制等服务，同时在开发
者的 APICloud应用控制台中，也会有一个对应的“模板应用”的项目。
10. APICloud应用定制服务c
在 APICloud 平台上每天都会聚集很多客户的 App 定制需求，因为很多客户认可 APICloud
平台和App 开发模式，但是由于没有自己的开发团队，所以希望APICloud能够为他们提供App
定制服务，或者为他们推荐优质的团队来进行项目实施。APICloud 应用定制服务有一套标准化
的开发流程和项目管理流程。
1.1.5 新手入门APICloud应用开发
这里推荐一些优质的入门资料，读者可以在官方文档页面中找到这些资料。
a 点击官方网站中，“App开发平台”下面的模块Store。
b 点击官方网站，“App定制服务”下面的模板Store。
c 点击官方网站中的“App定制服务”。1.2 体验完整项目的开发流程 15
APICloud 新手开发指南，在这个指南当中，基本上涵盖了 APICloud应用开发入门所需
的各方面知识，并且 APICloud 官方也会不断更新这个教程，所以这个新手开发指南是
所有 APICloud初学者必须要认真阅读的文档。
APICloud新手教程集合贴a，这是社区里的新手教程集合贴，里面有很多优秀开发者的
开发技巧、经验和教程的总结，推荐新手一定要看。
APICloud 视频教程 b，如果初学者想找一种更简便的方式去学习，也可以去看看
APICloud的视频教程，在这个视频教程中已经有数百集的视频。
APICloud 在线培训，APICloud 定期会举办线上的视频直播培训，直播的老师既有
APICloud工程师，也有优秀的APICloud开发者或其他培训机构的老师来直播。
1.2 体验完整项目的开发流程
在对 APICloud 平台有了基础的认识后，读者将跟随本节内容从零开始，创建、修改、调
试、编译和运行一个最简单的 App。这个 App 不包含任何复杂的开发技术，旨在让读者体验一
个完整App的开发流程。在本节的最后，这个应用将可以在移动设备上运行。
1.2.1 注册APICloud账号
在创建 App 项目之前，首先要有一个 APICloud 账号，这个账号非常重要，请妥善保管。
点击 APICloud官方网站右上角的注册按钮即可开始注册。注册过程非常简单，注册完成后请登
录账户。
1.2.2 创建一个App项目
创建一个新的项目有两种方式：
在 APICloud云平台上创建；
在APICloud的官方开发工具中创建。
APICloud推荐的集成开发工具是APICloud Studio 2。同时也为其他常用的开发工具软件提
供了插件支持，如 Sublime、Eclipse、WebStorm、Atom 等，读者可以根据自己的使用习惯选择
对应的工具。
本书以 APICloud Studio 2 为例。首先需要下载这个开发工具，选择官网首页的“App 开发
平台”，然后选择“开发工具”。
a 点击官方网站中的“开发者社区”，搜索“新手教程集合贴”。
b 点击官方网站中的“视频教程”。
更多免费电子书搜索「精品下载」 http:16 第1 章 APICloud App开发流程
在新的页面中根据具体的操作系统选择对应版本的 APICloud Studio 2 进行下载。下载完成
后将压缩包解压到任意位置，在解压后的文件中找到类似“apicloud-studio-2.exe”的文件，这
是开发工具的可执行文件。建议为它创建桌面快捷方式以方便使用。
1.在APICloud云平台上创建新项目
在官方网站登录成功后，将鼠标移动到页面右上角的用户名处，在显示的菜单中点击“开
发控制台”。
打开控制台页面后，页面左侧是项目列表，现在它是空白的；在中间部分会显示 APICloud
的更新日志(APICloud 平台自上线以来一直坚持每周更新一个版本)等平台动向信息；右侧是
个人信息以及一些工具按钮，如图1-10 所示。
图 1-10
点击左上角的“创建应用”，在弹出的窗口中选中“Native App”(默认选项)，在“名称”
输入框中填入“HelloAPICloud”并在“说明”输入框中填入任意说明信息，之后点击创建。此
时一个新的项目便被创建好了并显示了刚刚创建项目的管理页面，后续会对这个页面的相关功
能进行循序渐进的学习。
在项目创建完成后还需要将这个项目检出到本地进行开发，APICloud支持通过git或svn进
行代码管理(关于代码版本管理的资料请查阅相关文档)，即便读者不了解代码版本管理的相关
知识也不妨碍本节的学习。1.2 体验完整项目的开发流程 17
打开 APICloud Studio 2，如果开发者是首次运行此开发工具则需要进行登录。请用之前创
建的账号进行登录，否则无法找到相应的项目。登录成功后会进入欢迎页面。
此时开发工具已经获得了账号权限，可以对项目进行操作了。点击菜单栏的“代码管
理”→“代码检出”→“APICloud 云端应用”，在出现的检索框中输入之前创建的项目名称
“HelloAPICloud”，回车确认(也可以从下面的模糊搜索结果中选择相应的项目，如图1-11所示)。
图 1-11
在弹出的对话框中选择这个项目在开发设备上的保存位置(例如在桌面上新建一个叫作
“HelloAPICloud”的文件夹，然后选择这个文件夹)并点击“检出”。
在新弹出的输入框中保持默认，直接按回车即可，如图1-12 所示。
图 1-12
开发工具会自动从 APICloud 云端将账号中的“HelloAPICloud”项目检出到本地计算机上，稍等便可以看到默认打开的代码编辑页面。
2.在APICloud Studio 2上创建新项目
打开 APICloud Studio 2 并登录之前创建的账号。点击菜单栏中的“文件”→“新建”→
“APICloud 移动应用”，分别输入应用名称和应用说明，应用框架选择“空白应用”，之后点击
更多免费电子书搜索「精品下载」 http:18 第1 章 APICloud App开发流程
完成。在弹出的对话框中选择新项目的创建位置，点击“创建”。
稍等便可以完成创建。此时在网站的控制台中可以看到刚刚创建的项目。
1.2.3 编辑项目
在开发工具左侧的目录树根目录中选择“html”目录下的“main.html”文件，找到