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

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

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ù)，

克隆 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 的地址’

比如我這里使用如下命令：

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

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

配置本地倉(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

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

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

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

git remote -v

執(zhí)行結(jié)果

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

git fetch upstream

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

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

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

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

開(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

我的操作截圖如下：

向官方原始倉(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 信息即可。

DCO 簽署與驗(yàn)證

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

打開(kāi) sign（openharmony.io）進(jìn)行簽署即可：

https://dco.openharmony.io/sign/Z2l0ZWUlMkZvcGVuX2hhcm1vbnk=

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

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

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

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

git commit -m “xxxxxx” -s

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

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

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

責(zé)任編輯：haq