開(kāi)源掃盲--如何給OpenHarmony貢獻(xiàn)代碼

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

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

1、fork OpenHarmony中的倉(cāng)庫(kù)

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

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

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

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

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

2、克隆fork出來(lái)的倉(cāng)庫(kù)到自己的主機(jī)上

在我們fork出來(lái)的倉(cāng)庫(kù)主頁(yè)復(fù)制https clone的地址，如下圖

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

git clone 'https clone 的地址' 

復(fù)制

比如我這里使用如下命令

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

復(fù)制

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

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

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

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

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

cd 

復(fù)制

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

git remote add upstream ’官方原始倉(cāng)的clone地址‘ 

復(fù)制

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

git remote -v

復(fù)制

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

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

git fetch upstream  

復(fù)制

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

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

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

復(fù)制

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

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

基本操作步驟命令如下

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

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

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

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

復(fù)制

我的操作截圖如下

5、向官方原始倉(cāng)提交Pull Request

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

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

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

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

打開(kāi)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í)可以通過(guò)git log看到提交日志如下圖，帶有 Signed-off-by:信息

配置好這些之后再來(lái)提交pull request的話就可以通過(guò)dco檢查了。

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