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

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

https://gitee.com/openharmony

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

fork OpenHarmony 中的倉庫

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

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

比如我選擇 app_samples 這個倉庫，

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

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

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

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

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

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

git clone ‘https clone 的地址’

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

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

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

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

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

官方原始倉：你想要貢獻(xiàn)的項(xiàng)目的官方倉庫地址

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

本地倉：git clone 遠(yuǎn)程倉之后下載到你本地的代碼倉

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

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ā)分支進(jìn)行開發(fā)

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

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

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

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

基本操作步驟命令如下：

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

我的操作截圖如下：

向官方原始倉提交 Pull Request

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

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

DCO 簽署與驗(yàn)證

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

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

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

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

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

責(zé)任編輯：haq