記一次給OpenHarmony提交代碼的過(guò)程

作者：堅(jiān)果

公眾號(hào)："大前端之旅"

OpenHarmony布道師，InfoQ簽約作者，CSDN博客專家，華為云享專家，阿里云專家博主，51CTO博客首席體驗(yàn)官，開(kāi)源項(xiàng)目GVA成員之一，專注于大前端技術(shù)的分享，包括Flutter,鴻蒙，小程序,安卓，VUE，JavaScript。

昨晚雷聲大作，睡不著，于是就爬起來(lái)寫(xiě)作了，在寫(xiě)作的過(guò)程中，發(fā)現(xiàn)官方文檔中存在一些問(wèn)題，于是就想改進(jìn)一下，

我提交的pr地址：

接下來(lái)就說(shuō)一說(shuō)自己在提交修方改的過(guò)程中的一些步驟吧！

一、DCO簽署

1.DCO簽署網(wǎng)址

開(kāi)發(fā)者原創(chuàng)聲明Developer Certificate of Origin

開(kāi)發(fā)者原創(chuàng)聲明

2.簽署DCO

3.注意事項(xiàng)

git config --global user.name "徐建國(guó)"

git config --global user.email "[email protected]"

git config --global --list

注意

DCO簽署Name 必須要和git config --global user.name 設(shè)置保持一直 DCO簽署E-mail必須要和git config --global user.email設(shè)置保持一直

二、提交代碼

1.下載代碼

1.1找到要提交代碼的社區(qū)代碼倉(cāng)，fork一個(gè)到自己的私有倉(cāng)中；

1.2復(fù)制自己私有倉(cāng)的“克隆/下載”中的HTTPS/SSH鏈接下載代碼

本地創(chuàng)建工作區(qū)，然后

git clone https://gitee.com/jianguo888/docs.git

2.提交代碼

2.1將修改的代碼合入到提交代碼倉(cāng)中；

git add .

git commit -sm '修改信息' // 提交信息包含signoff郵箱

git push -f origin master

?

2.2如果是對(duì)同一個(gè)問(wèn)題修改

git commit --amend

通常推薦一個(gè)一個(gè)commit解決一個(gè)問(wèn)題

三、提交ISSUE

1.進(jìn)入社區(qū)主代碼建Issue（不是fork的代碼倉(cāng)），同時(shí)注意建Issue有很多選項(xiàng)類(lèi)型可選擇，根據(jù)實(shí)際情況選擇

2.創(chuàng)建成功會(huì)生成一個(gè)#XXXXX(I5E2H2)的IssueID，提交PR可以關(guān)聯(lián)，關(guān)聯(lián)PR合入，Issue就會(huì)自動(dòng)關(guān)閉。

四、提交PR

1.代碼提交到自己的私有倉(cāng)，刷新，點(diǎn)擊“+ Pull Request”建PR合入代碼到社區(qū)主代碼倉(cāng)；

2.進(jìn)入PR提交界面，可選擇代碼倉(cāng)庫(kù)分支，和關(guān)聯(lián)ISSUE ID，簡(jiǎn)單描述合入的PR修改等信息；

3.PR建立成功，首先默認(rèn)進(jìn)行DCO檢查，檢查成功，需要手動(dòng)在評(píng)論區(qū)輸入回復(fù)”start build”方可進(jìn)入代碼的CI靜態(tài)檢查和編譯等操作。

五、聯(lián)系committer

committer：https://gitee.com/openharmony/community/blob/master/zh/committer.md

1. committer文檔中找到對(duì)應(yīng)的committer負(fù)責(zé)人主頁(yè)，想辦法聯(lián)系

我是在committer發(fā)現(xiàn)負(fù)責(zé)人，然后微信搜索，群里撈到的。

我的修改的內(nèi)容，順便在這貼一下

修改內(nèi)容

創(chuàng)建visual文件支持低代碼開(kāi)發(fā)

在打開(kāi)的JS工程中，選中模塊的pages文件夾，單擊鼠標(biāo)右鍵，選擇New > JS Visual。

在彈出的對(duì)話框中，輸入JS Visual Name，點(diǎn)擊Finish。

3.創(chuàng)建JS Visual后，會(huì)在工程中自動(dòng)生成低代碼的目錄結(jié)構(gòu)，如下圖所示。

entry > src > main > js > MainAbility > pages > index > index.js ：低代碼頁(yè)面的邏輯描述文件，定義了頁(yè)面里所用到的所有的邏輯關(guān)系，比如數(shù)據(jù)、事件等。詳情請(qǐng)參考JS語(yǔ)法參考。如果創(chuàng)建了多個(gè)低代碼頁(yè)面，則pages目錄下會(huì)生成多個(gè)頁(yè)面文件夾及對(duì)應(yīng)的js文件。

說(shuō)明： 使用低代碼頁(yè)面開(kāi)發(fā)時(shí)，其關(guān)聯(lián)js文件的同級(jí)目錄中不能包含hml和css頁(yè)面，例如上圖中的 js > MainAbility > pages > index 目錄下不能包含hml與css文件，否則會(huì)出現(xiàn)編譯報(bào)錯(cuò)。

entry > src > main > supervisual > MainAbility > pages > index > index.visual ：visual文件存儲(chǔ)低代碼頁(yè)面的數(shù)據(jù)模型，雙擊該文件即可打開(kāi)低代碼頁(yè)面，進(jìn)行可視化開(kāi)發(fā)設(shè)計(jì)。如果創(chuàng)建了多個(gè)低代碼頁(yè)面，則pages目錄下會(huì)生成多個(gè)頁(yè)面文件夾及對(duì)應(yīng)的visual文件。

打開(kāi)“page.visual”文件，即可進(jìn)行頁(yè)面的可視化布局設(shè)計(jì)與開(kāi)發(fā)。

說(shuō)明：

使用低代碼開(kāi)發(fā)界面過(guò)程中，如果界面需要使用到其它暫不支持可視化布局的控件時(shí)，可以在低代碼界面開(kāi)發(fā)完成后，點(diǎn)擊

按鈕，將低代碼界面轉(zhuǎn)換為hml和css代碼。注意，代碼轉(zhuǎn)換操作會(huì)刪除visual文件及其父目錄，且為不可逆過(guò)程，代碼轉(zhuǎn)換后不能通過(guò)hml/css文件反向生成visual文件。

多設(shè)備開(kāi)發(fā)的場(chǎng)景，可以點(diǎn)擊界面畫(huà)布右上角設(shè)備/模式切換按鈕

，進(jìn)行設(shè)備切換或模式切換。

使用低代碼開(kāi)發(fā)完OpenHarmony應(yīng)用或服務(wù)后，如果需要使用模擬器或真機(jī)設(shè)備調(diào)試/運(yùn)行，需要點(diǎn)擊

按鈕，將JS Visual文件轉(zhuǎn)換為hml和css代碼后才能運(yùn)行。

以上就是我半夜做的一些事情，當(dāng)然第一次，可能不太完美，在這要感謝半夜還在群里回復(fù)我的各位老師。好的，期待PR合入成功。