記一次給OpenHarmony提交代碼的過程

作者：堅果

公眾號："大前端之旅"

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

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

我提交的pr地址：

接下來就說一說自己在提交修方改的過程中的一些步驟吧！

一、DCO簽署

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

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

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

2.簽署DCO

3.注意事項

git config --global user.name "徐建國"

git config --global user.email "852851198@qq.com"

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ū)代碼倉，fork一個到自己的私有倉中；

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

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

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

2.提交代碼

2.1將修改的代碼合入到提交代碼倉中；

git add .

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

git push -f origin master

?

2.2如果是對同一個問題修改

git commit --amend

通常推薦一個一個commit解決一個問題

三、提交ISSUE

1.進入社區(qū)主代碼建Issue（不是fork的代碼倉），同時注意建Issue有很多選項類型可選擇，根據(jù)實際情況選擇

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

四、提交PR

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

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

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

五、聯(lián)系committer

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

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

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

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

修改內(nèi)容

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

在打開的JS工程中，選中模塊的pages文件夾，單擊鼠標右鍵，選擇New > JS Visual。

在彈出的對話框中，輸入JS Visual Name，點擊Finish。

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

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

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

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

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

說明：

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

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

多設(shè)備開發(fā)的場景，可以點擊界面畫布右上角設(shè)備/模式切換按鈕

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

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

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

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