如何對OpenHarmony貢獻代碼

OpenHarmony 是由開放原子開源基金會（OpenAtom Foundation）孵化及運營的開源項目，目標是面向全場景、全連接、全智能時代，搭建一個智能終端設(shè)備操作系統(tǒng)的框架和平臺，促進萬物互聯(lián)產(chǎn)業(yè)的繁榮發(fā)展。

目前代碼倉托管在 gitee 上，官方地址：

https://gitee.com/openharmony

下面主要來講講如何對 OpenHarmony 貢獻代碼。

fork OpenHarmony 中的倉庫

截止目前為止，OpenHarmony 共有 276 個倉庫，

在“倉庫”tab 頁面，根據(jù)自己擅長的技術(shù)方向和愛好選擇需要貢獻源代碼的倉庫，這里支持搜索。

比如我選擇 app_samples 這個倉庫，

進入到選擇的倉庫中，然后點擊 fork，

點擊 fork 之后，會有如下提示窗口彈出，選中自己的頭像之后，即可點擊確認按鈕。

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

克隆 fork 出來的倉庫到自己的主機上

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

在本地的 PC 上運行如下命令將 fork 出來的代碼庫拷貝到本機的文件夾中：

git clone ‘https clone 的地址’

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

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

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

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

這里先備注幾個名詞解釋：

官方原始倉：你想要貢獻的項目的官方倉庫地址

遠程倉：你 fork 完成之后，在你的 gitee 頁面上那個與官方倉同名的倉庫地址

本地倉：git clone 遠程倉之后下載到你本地的代碼倉

進入我們的項目文件夾：

cd

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

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

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

git remote -v

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

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

git fetch upstream

新建開發(fā)分支進行開發(fā)

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

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

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

開發(fā)分支上修改代碼并push到遠程倉

基本操作步驟命令如下：

# 查看修改了那些文件 git status # add提交到暫存區(qū) git add 。 # commit提交到本地倉，-m后簡要描述本次提交的內(nèi)容 git commit -m “xxxxx” # push到遠程倉 git push origin fixDoc

我的操作截圖如下：

向官方原始倉提交 Pull Request

打開自己 fork 的倉庫主頁，選擇 Pull Request 標簽，然后點擊新建 Pull Request 按鈕，

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

DCO 簽署與驗證

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

打開 sign（openharmony.io）進行簽署即可：

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

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

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

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

責任編輯：haq