OpenHarmony是由開放原子開源基金會(huì)（OpenAtom Foundation）孵化及運(yùn)營(yíng)的開源項(xiàng)目，目標(biāo)是面向全場(chǎng)景、全連接、全智能時(shí)代，搭建一個(gè)智能終端設(shè)備操作系統(tǒng)的框架和平臺(tái)，促進(jìn)萬物互聯(lián)產(chǎn)業(yè)的繁榮發(fā)展。目前代碼倉托管在gitee上，官方地址https://gitee.com/openharmony，快去點(diǎn)擊關(guān)注吧。

下面主要來講講如何對(duì)OpenHarmony貢獻(xiàn)代碼。

1、fork OpenHarmony中的倉庫

截止目前為止，OpenHarmony共有276個(gè)倉庫，如下圖

在”倉庫“tab頁面，根據(jù)自己擅長(zhǎng)的技術(shù)方向和愛好選擇需要貢獻(xiàn)源代碼的倉庫，這里支持搜索，比如我選擇app_samples這個(gè)倉庫，如下圖

進(jìn)入到選擇的倉庫中，然后點(diǎn)擊fork，如下圖

點(diǎn)擊fork之后，會(huì)有如下提示窗口彈出，選中自己的頭像之后，即可點(diǎn)擊確認(rèn)按鈕

fork完成之后，就會(huì)自動(dòng)跳轉(zhuǎn)到自己的gitee倉庫頁面，里面會(huì)創(chuàng)建一個(gè)與你剛fork的倉庫同名的倉庫，如下圖

2、克隆fork出來的倉庫到自己的主機(jī)上

在我們fork出來的倉庫主頁復(fù)制https clone的地址，如下圖

在本地的PC上運(yùn)行如下命令將fork出來的代碼庫拷貝到本機(jī)的文件夾中

git clone 'https clone 的地址' 

復(fù)制

比如我這里使用如下命令

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

復(fù)制

執(zhí)行結(jié)果如下圖，耐心等待下載完成即可

3、配置本地倉與官方原始倉的關(guān)聯(lián)

這里先備注幾個(gè)名詞解釋：

官方原始倉：你想要貢獻(xiàn)的項(xiàng)目的官方倉庫地址
遠(yuǎn)程倉：你fork完成之后，在你的gitee 頁面上那個(gè)與官方倉同名的倉庫地址
本地倉：git clone 遠(yuǎn)程倉之后下載到你本地的代碼倉

進(jìn)入我們的項(xiàng)目文件夾

cd 

復(fù)制

添加與官方原始倉的關(guān)聯(lián)，命名為upstream

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

復(fù)制

關(guān)聯(lián)好之后，可以使用下面命令查看關(guān)聯(lián)信息

git remote -v

復(fù)制

執(zhí)行結(jié)果如下圖

待關(guān)聯(lián)好了官方原始倉之后，就可以使用下面命令拉取最新的更新了

git fetch upstream  

復(fù)制

4、新建開發(fā)分支進(jìn)行開發(fā)

執(zhí)行下面命令即可新建開發(fā)分支

# 新建分支,fixDoc為分支名稱，名稱自定義即可
git checkout -b fixDoc

復(fù)制

執(zhí)行成果之后的截圖如下

4、開發(fā)分支上修改代碼并push到遠(yuǎn)程倉

基本操作步驟命令如下

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

# add提交到暫存區(qū)
git add .

# commit提交到本地倉，-m后簡(jiǎn)要描述本次提交的內(nèi)容
git commit -m "xxxxx"

# push到遠(yuǎn)程倉
git push origin fixDoc

復(fù)制

我的操作截圖如下

5、向官方原始倉提交Pull Request

打開自己fork的倉庫主頁，選擇Pull Request標(biāo)簽，然后點(diǎn)擊新建Pull Request按鈕，如下圖

點(diǎn)擊新建之后，會(huì)跳轉(zhuǎn)到官方原始倉的Pull Request頁面下，按照下圖填寫好相關(guān)的Pull Request信息即可

6、DCO簽署與驗(yàn)證

提交的pull request首先要經(jīng)過dco檢查，因此需要簽署原子基金會(huì)的DCO協(xié)議。

打開sign (openharmony.io)進(jìn)行簽署即可。

注意：這里簽署的名字和郵箱要和git config中配置的用戶名和郵箱保持一致

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

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

復(fù)制

然后將之前的commit的命令修改為

git commit -m "xxxxxx" -s

復(fù)制

此時(shí)可以通過git log看到提交日志如下圖，帶有 Signed-off-by:信息

配置好這些之后再來提交pull request的話就可以通過dco檢查了。

剩下的就等社區(qū)審核人員審核通過即可。