鸿蒙生态 ——鸿蒙智能设备创新（参与 OpenHarmony） 5-6

5．参与 OpenHarmony

接下来，我们阐述如何具体参与 OpenHarmony 。

参与鸿蒙操作系统开源共建方式主要有两种：一是成为该项

目的群成员，具体参与方式是开放原子开源基金会根据项目发展

的需求，有相应的政策与要求，适合企业参与；二是直接到社区

贡献，社区贡献首先需要到 Gitee 平台注册账户、认证、熟悉账

户使用功能等，个人和企业都可以。

开发者参与贡献，包括贡献代码与贡献文档等，在开始之前

必须签署贡献者许可协议 CLA 。

开源鸿蒙操作系统完全依赖于社区提供友好的开发和协作

环境，所以，参与社区贡献必须遵守社区的行为守则，同时社区

对违约者设置了举报投诉及处理机制。

社区还对开发者贡献的代码风格，即 OpenHarmony 编程规

范进行了规定和明确，要求开发者进行代码开发、检视、测试等，

以保持代码风格一致性。具体包括 C++ 语言编程规范、 C 语言编

程规范、 JavaScript 语言编码规范、 Python 语言编程规范等。

因第三方开源软件数量众多，社区开发者多且分布广，所以，

在项目开发过程中需要应用各种第三方软件，为确保开源鸿蒙操

作系统项目的质量。开发者若要引入新的第三方开源软件到本项

目中，则必须遵循社区的《第三方开源软件引入指导》。

6．OpenHarmony 贡献流程

接下来，我们分析具体开发相关的一些事项。

代码贡献流程包括环境准备，代码下载、开发、提交、创建

PR 及把修改开发过的代码提交给原仓库审核或者通过 repo 脚本

管理工具自动创建 PR 的方式实现、门禁构建与创建 Issue 任务、

代码审查这几个环节。

环境准备包括 Git 开源的分布式版本控制系统的安装、环境

配置及使用方法的熟悉，注册 SSH 安全协议公钥，在开展 Gitee

的工作之前开发者需要先在开源鸿蒙操作系统的代码托管平台

上找到自己需要的 Repository 代码仓库。

代码下载主要是指从云上复制代码分支。找到并打开对应

Repository 代码仓库的首页，点击 Fork 复制按钮，按照指引建

立一个属于开发者的云上 Fork 复制分支，把 Fork 复制仓下载到

本地。开发者需要创建本地工作目录，以便本地代码的查找和

管理。

在开发者对下载的代码进行自主的各项修改后，接着就是创

建 PR ，也可以通过 repo 脚本管理工具自动创建 PR 来实现。开

发者通过访问自己在码云上的 Fork 仓页面，点击创建 Pull

Request 按钮，选择 myfeature 分支生成 PR 。

门禁构建与创建 Issue 任务，找到并打开对应 Repository 代

码仓库的首页，选择 Issues 页签，点击新建 Issue 按钮，按照指

引建立一个专属的任务，用于相关联的代码互动执行 CI 门禁。

当创建 PR 或编译已有的 PR 时，可将 Issue 与 PR 关联，当然，

Issue 与 PR 关联是有多项约束条件的。触发代码门禁，在 PR 中

评论“ start build ”启动生产便可触发 CI 门禁。当多个 PR 关联

同一 Issue 时，在任一 PR 中评论“ start build ”，都可触发 CI 门

禁。门禁执行完成，会在该 Issue 关联的全部 PR 中自动评论门

禁执行情况；如通过，则该 Issue 关联的全部 PR 均会自动标记

“测试通过”。

最后一个环节就是按照规范进行代码审查，通过者本次贡献

完成才获得成功。

社区同时鼓励开发者以各种方式参与相关文档的反馈和贡

献。开发者可以对现有社区文档进行评论、简单修改调整、反馈

问题、原创等。优秀的贡献者将会获得开发者社区文档贡献专栏

的表彰公示。

贡献文档需要对内容、版权特别注意，不得侵犯他人的知识

产权。对应采纳的内容，社区有权根据相关规范修改。开发者

要注意查看社区公布的贡献文档需要遵循的许可协议。社区对

文档贡献是有写作规范要求的，具体包括命名、内容、标题、

操作类与介绍性文档正文要求、图片、字体、色调、表格、代

码等。开发者在正式创作前，需要详细了解社区的对本部分内

容的说明。