还在为找不到想看的文档内容发愁?一文带你熟知应用开发文档 精华
HarmonyOS作为新一代的智能终端操作系统,为不同设备的智能化、互联与协同提供了统一的语言。带来简洁,流畅,连续,安全可靠的全场景交互体验。随着HarmonyOS SDK 2.1 Release发布,HarmonyOS应用开发文档也上新各种技术内容。
版本定义及更新说明
版本类型定义及版本更新一向是开发者们最关注的内容之一,我们也归档了历次版本更新内容,开发者们可在“文档”区的“版本说明”目录下找到版本配套信息、版本更新内容及对应的开发者文档(如图1所示)。
::: hljs-center
图1 版本说明图
:::
● 版本说明
示例代码专区
示例代码是广大开发者最需要的学习资源,也是开发者千呼万唤的干货内容。当前文档上架了示例代码展示区(如图2所示),**方便开发者一站式获取所有示例代码内容,**了解如何实现特定功能,并支持从Gitee社区获取源码学习和参考。
::: hljs-center
图2 示例代码展示区
:::
● 示例代码
https://developer.harmonyos.com/cn/documentation/Samples/
同时,我们还在指南专题对应内容中,增加了相关实例的快速链接,方便开发者在学习相关主题内容后可快速获取实例代码,上手实践(如图3所示)。
::: hljs-center
图3 相关示例展示图
:::
开发者教程
开发者教程通过生动有趣的场景案例、简单易上手的代码,Step by Step指导开发者针对重点功能或场景进行开发。大家可在“开发”专区的“Codelabs”目录下获取到当前所有的开发者教程资源。
● Codelabs链接
https://developer.harmonyos.com/cn/develop/codelabs/
特色主题文档
1.了解原子化服务
在万物互联时代,人均持有设备量不断攀升,设备和场景的多样性,使应用开发变得更加复杂、应用入口更加丰富。在此背景下,应用提供方和用户迫切需要一种新的服务提供方式,使应用开发更简单、服务(如听音乐、打车等)的获取和使用更便捷。为此,HarmonyOS除支持传统方式的需要安装的应用外,还支持提供特定功能的免安装的应用(即原子化服务)。
原子化服务是HarmonyOS提供的一种面向未来的服务提供方式,是有独立入口的(用户可通过点击方式直接触发,如图4所示)、免安装的(无需显式安装,由系统程序框架后台安装后即可使用)、可为用户提供一个或多个便捷服务的用户应用程序形态。例如:某传统方式的需要安装的购物应用A,在按照原子化服务理念调整设计后,成为由“商品浏览”、“购物车”、“支付”等多个便捷服务组成的、可以免安装的购物原子化服务A*。
::: hljs-center
图4 服务中心示意图
:::
更多关于原子化服务的具体详情,可参见官网【原子化服务】资料。
● 【原子化服务】
2.服务卡片开发指南
服务卡片(以下简称“卡片”)是FA的一种界面展示形式,将FA的重要信息或操作前置到卡片,以达到服务直达,减少体验层级目的。
卡片常用于嵌入到其他应用(当前只支持系统应用)中作为其界面的一部分显示,并支持拉起页面,发送消息等基础的交互功能。卡片使用方负责显示卡片。
卡片使用方是显示卡片内容的宿主应用,控制卡片在宿主中展示的位置。卡片管理服务是用于管理系统中所添加卡片的常驻代理服务,包括卡片对象的管理与使用,以及卡片周期性刷新等。
卡片提供方提供卡片显示内容的HarmonyOS应用或原子化服务,控制卡片的显示内容、控件布局以及控件点击事件。
::: hljs-center
图5 服务卡片展示图
:::
更多关于服务卡片开发的具体详情,可参见官网【服务卡片】资料。
● 【服务卡片】
3.流转开发指南
流转在HarmonyOS中泛指多设备分布式操作(如图6所示)。流转能力打破设备界限,多设备联动,使用户应用程序可分可合、可流转,实现如邮件跨设备编辑、多设备协同健身、多屏游戏等分布式业务。流转为开发者提供更广的使用场景和更新的产品视角,强化产品优势,实现体验升级。流转按照体验可分为跨端迁移和多端协同。
跨端迁移是一种实现用户应用程序流转的技术方案,当前仅传统方式的需要安装的应用支持,原子化服务暂不支持。指在A端运行的FA迁移到B端上,完成迁移后, B端FA继续任务,而A端应用退出。在用户使用设备的过程中,当使用情境发生变化时(例如:从室内走到户外或者周围有更合适的设备等),之前使用的设备可能已经不适合继续当前的任务,此时,用户可以选择新的设备来继续当前的任务。
::: hljs-center
图6 流转示意图
:::
更多关于流转开发的具体详情,可参见官网【流转】资料。
● 【流转】
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/hop-overview-0000001092995092
4.Java UI
Java UI框架已为大家提供了20多种常用定义组件和布局、自定义组件和布局的开发指导(如图7所示),Java与XML方式随需使用,更多关于Java UI开发详情,可参见官网【Java UI】。
::: hljs-center
图7 Java UI框架资料展示图
:::
● 【Java UI】
真机调试指导
HarmonyOS应用调试支持使用真机设备调试,开发者使用真机设备进行调试前,需要先对HAP进行签名后再进行调试(如图8所示)。在DevEco Studio 2.1 Release版本中,我们提供了自动签名的功能,开发者无需再手动去制作证书请求文件、申请调测证书等复杂操作。此外,DevEco Studio支持Java、JS、C/C++单语言调试和JS+Java、Java+C/C++跨语言调试能力,同时还支持分布式应用的跨设备调试,提升了应用调测的效率。
::: hljs-center
图8 真机设备调试流程图
:::
更多关于使用真机设备调试的详情,可参见官网【使用真机设备调试】。
● 【使用真机设备调试】
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404
常见问题
大家在开发、调试总会遇到一些阻碍,建议大家先查找文档,尤其是相关主题的开发指南、API参考,鼓励大家查阅《常见问题》中的相关问题(如图9所示)。这些常见问题主要来自开发者在论坛、社区等渠道的高频求助问题,文档团队例行收集高频问题,不断丰富常见问题内容。
● 《常见问题》-Java开发
::: hljs-center
图9 常见问题展示图
:::
如果你在查阅文档后仍有不能解决的问题,也欢迎通过以下方式高效解决:
https://developer.harmonyos.com/cn/support
开发者声音回音壁
我们不断收到广大开发者的文档需求和建议,每天都会投入一定的时间来分析大家的反馈。虽然我们无法直接回答大家的每一条的意见,但大家的需求和建议每天都会影响HarmonyOS开发者文档的体验提升。
我们希望本期的文档上新内容,能够给各位开发者的工作带来一定帮助。同时,我们十分重视开发者的意见,欢迎各位开发者的积极反馈,正是因为你们的建议,让我们坚持持续提升文档体验,感谢各位的支持及信赖,让我们一起携手,创造无限可能。
了解了这么多,何不从工具下载开始上手体验呢?
HUAWEI DevEco Studio下载链接