OpenHarmony文档与贡献流程调研
OpenHarmony项目文档 docs: OpenHarmony documentation | OpenHarmony开发者文档
项目简介
OpenHarmony是由开放原子开源基金会(Open Atom Foundation)孵化及运营的开源项目,目标是面向全场景、全连接、全智能时代,基于开源的方式,搭建一个智能终端设备操作系统的框架和平台,促进万物互联产业的繁荣发展。
OpenHarmony开源操作系统,包括内核层,系统服务层,框架层和应用层。
内核层包括内核抽象层和驱动子系统。其中,内核层采用Linux多内核设计,支持针对不同类型设备选用适合的OS内核。而驱动框架则提供统一外设访问能力和驱动开发、管理框架。
系统服务层是OpenHarmony项目的核心能力集合,通过框架层向应用层提供服务。
应用层则包括系统应用和第三方非系统应用,由一个或者多个FA(Feature Ability)或PA(Particle Ability)组成。其中,FA有UI界面,提供与用户交互的能力;而PA无UI界面,提供后台运行任务的能力以及统一的数据访问抽象。基于FA/PA开发的应用,能够实现特定的业务功能,支持跨设备调度与分发,为用户提供一致、高效的应用体验。
通过参与OpenHarmony开源项目的贡献,初学者可以很好地了解这一操作系统框架,并且对Linux,Lite OS等内核系统有充分的认识。
贡献指南
贡献指南部分参考:
https://gitee.com/openharmony/docs/blob/master/zh-cn/contribute
名词解析:
DCO,开发者原创声明。开发者想要贡献代码或者文档,需要进行身份认证并签署该协议。
SIG,特殊兴趣小组,代表某个特定的技术研发方向。开发者可以在其中进行研讨和协作。
PMC,项目管理委员会,负责OpenHarmony社区管理。具体有这些职责:
负责社区管理工作,包括开源社区版本规划、架构看护、特性代码开发维护、版本及补丁规划等;
发布和处理社区需求,为开源社区提供技术架构指导和技术决策;
处理社区Bug、issue、邮件列表等渠道开发者反馈问题;
负责PMC、Committer成员的选举和退出,制定PMC、Committer协作机制;
OpenHarmony社区开发讨论邮件列表,任何社区开发相关话题都可以在邮件列表讨论。任何开发者可订阅。
贡献代码
在开始贡献代码之前,开发者需要做一些准备工作,包括了解项目、签署声明、选择兴趣小组,了解贡献代码的规范等等。我整理了一些步骤:
-
了解项目,与相关负责人取得联系。开发者可以通过订阅邮件列表、参与PMC会议等方式来了解开源项目,讨论社区开发的相关话题。订阅邮件列表的方式在此列表中给出:
地址 简介 用途说明 dev@openharmony.io 开发邮件列表 OpenHarmony社区开发讨论邮件列表,任何社区开发相关话题都可以在邮件列表讨论。任何开发者可订阅。 cicd@openharmony.io CI邮件列表 OpenHarmony CICD构建邮件列表,任何开发者可订阅。 pmc@openharmony.io PMC邮件列表 PMC讨论邮件列表,PMC成员可订阅。 -
*订阅开发邮件列表,订阅与社区开发相关的话题:
-
签署“开发者原创声明”:通过验证身份并签署DCO(Developer Certificate of Origin,开发者原创声明)成为项目开发者。
-
阅读OpenHarmony社区的行为守则,了解在社区的交流发言、参与代码或文档贡献所需要的守则。
-
找到并加入自己感兴趣的SIG(Special Interest Group,特别兴趣小组),可以参考SIG治理章程。开发者在这里协作解决各种领域的问题。
-
遵守相关规范,开始参与开源社区贡献。
在贡献代码时,开发者需要注意设计规范: