OpenHarmony实践经验-如何给OpenHarmony贡献代码

# 开源扫盲--如何给OpenHarmony贡献代码

OpenHarmony是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目，目标是面向全场景、全连接、全智能时代，搭建一个智能终端设备操作系统的框架和平台，促进万物互联产业的繁荣发展。目前代码仓托管在gitee上，官方地址https://gitee.com/openharmony，快去点击关注吧。

下面主要来讲讲如何对OpenHarmony贡献代码。

## 1、fork OpenHarmony中的仓库

截止目前为止，OpenHarmony共有276个仓库，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135555_c6914349_789395.png "屏幕截图.png")

在”仓库“tab页面，根据自己擅长的技术方向和爱好选择需要贡献源代码的仓库，这里支持搜索，比如我选择app_samples这个仓库，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135614_309d952f_789395.png "屏幕截图.png")

进入到选择的仓库中，然后点击fork，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135622_f5103fec_789395.png "屏幕截图.png")

点击fork之后，会有如下提示窗口弹出，选中自己的头像之后，即可点击确认按钮

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135631_4ef85ca2_789395.png "屏幕截图.png")

fork完成之后，就会自动跳转到自己的gitee仓库页面，里面会创建一个与你刚fork的仓库同名的仓库，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135638_1e4d9dab_789395.png "屏幕截图.png")

## 2、克隆fork出来的仓库到自己的主机上

在我们fork出来的仓库主页复制https clone的地址，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135649_66c98292_789395.png "屏幕截图.png")

在本地的PC上运行如下命令将fork出来的代码库拷贝到本机的文件夹中

```
git clone 'https clone 的地址' 
```

比如我这里使用如下命令

```
git clone https://gitee.com/xdw1019/app_samples.git
```

执行结果如下图，耐心等待下载完成即可

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135657_fd71477d_789395.png "屏幕截图.png")

## 3、配置本地仓与官方原始仓的关联

这里先备注几个名词解释：

**官方原始仓**：你想要贡献的项目的官方仓库地址
**远程仓**：你fork完成之后，在你的gitee 页面上那个与官方仓同名的仓库地址
**本地仓**：git clone 远程仓之后下载到你本地的代码仓

进入我们的项目文件夹

```
cd 
```

添加与官方原始仓的关联，命名为upstream

```
git remote add upstream ’官方原始仓的clone地址‘ 
```

关联好之后，可以使用下面命令查看关联信息

```
git remote -v
```

执行结果如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135712_61b68154_789395.png "屏幕截图.png")

待关联好了官方原始仓之后，就可以使用下面命令拉取最新的更新了

```
git fetch upstream  
```

## 4、新建开发分支进行开发

执行下面命令即可新建开发分支

```
# 新建分支,fixDoc为分支名称，名称自定义即可
git checkout -b fixDoc
```

执行成果之后的截图如下

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135722_2e5b329a_789395.png "屏幕截图.png")

## 4、开发分支上修改代码并push到远程仓

基本操作步骤命令如下

```
# 查看修改了那些文件
git status

# add提交到暂存区
git add .

# commit提交到本地仓，-m后简要描述本次提交的内容
git commit -m "xxxxx"

# push到远程仓
git push origin fixDoc
```

我的操作截图如下

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135735_f23ddbeb_789395.png "屏幕截图.png")

## 5、向官方原始仓提交Pull Request

打开自己fork的仓库主页，选择Pull Request标签，然后点击新建Pull Request按钮，如下图

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135753_d98a9787_789395.png "屏幕截图.png")

点击新建之后，会跳转到官方原始仓的Pull Request页面下，按照下图填写好相关的Pull Request信息即可

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135802_c997f985_789395.png "屏幕截图.png")

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135808_8da4fe51_789395.png "屏幕截图.png")

## 6、DCO签署与验证

提交的pull request首先要经过dco检查，因此需要签署原子基金会的DCO协议。

打开[sign (openharmony.io)](https://dco.openharmony.io/sign/Z2l0ZWUlMkZvcGVuX2hhcm1vbnk=)进行签署即可。

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135815_9e36e38c_789395.png "屏幕截图.png")

**注意：这里签署的名字和邮箱要和git config中配置的用户名和邮箱保持一致**

比如我本地使用git config配置如下

```
git config --global user.name "夏德旺"
git config --global user.email "263201361@qq.com"
```

然后将之前的commit的命令修改为

```
git commit -m "xxxxxx" -s
```

此时可以通过git log看到提交日志如下图，带有 Signed-off-by:信息

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135822_008987ec_789395.png "屏幕截图.png")

配置好这些之后再来提交pull request的话就可以通过dco检查了。

![输入图片说明](https://images.gitee.com/uploads/images/2021/0926/135827_3bbf38a6_789395.png "屏幕截图.png")

剩下的就等社区审核人员审核通过即可。

Gitee Community/OpenHarmony组件开发大赛-有奖征文

内容风险标识

评论 (0)

Gitee Community/OpenHarmony组件开发大赛-有奖征文 .gitee-modal { width: 500px !important; }

内容风险标识