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

語言: CN / TW / HK

持續創作,加速成長!這是我參與「掘金日新計劃 · 6 月更文挑戰」的第33天,點選檢視活動詳情

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

作者:堅果

公眾號:"大前端之旅"

OpenHarmony佈道師,InfoQ簽約作者,CSDN部落格專家,華為雲享專家,阿里雲專家博主,51CTO部落格首席體驗官,開源專案GVA成員之一,專注於大前端技術的分享,包括Flutter,鴻蒙,小程式,安卓,VUE,JavaScript。

昨晚雷聲大作,睡不著,於是就爬起來寫作了,在寫作的過程中,發現官方文件中存在一些問題,於是就想改進一下,

image.png 我提交的pr地址:

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

一、DCO簽署

1.DCO簽署網址

開發者原創宣告Developer Certificate of Origin

開發者原創宣告

2.簽署DCO

向OpenHarmony社群提交程式碼

3.注意事項

git config --global user.name "徐建國" git config --global user.email "[email protected]" git config --global --list

注意

DCO簽署Name 必須要和git config --global user.name 設定保持一直 DCO簽署E-mail必須要和git config --global user.email設定保持一直

二、提交程式碼

1.下載程式碼

1.1找到要提交程式碼的社群程式碼倉,fork一個到自己的私有倉中;

image.png image-20220625103805814

1.2複製自己私有倉的“克隆/下載”中的HTTPS/SSH連結下載程式碼

本地建立工作區,然後

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

image-20220625105125849

2.提交程式碼

2.1將修改的程式碼合入到提交程式碼倉中;

git add . git commit -sm '修改資訊' // 提交資訊包含signoff郵箱 git push -f origin master ​

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

git commit --amend

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

三、提交ISSUE

1.進入社群主程式碼建Issue(不是fork的程式碼倉),同時注意建Issue有很多選項型別可選擇,根據實際情況選擇

image-20220625105723070

向OpenHarmony社群提交程式碼-開源基礎軟體社群

2.建立成功會生成一個#XXXXX(I5E2H2)的IssueID,提交PR可以關聯,關聯PR合入,Issue就會自動關閉。

image-20220625105939890

四、提交PR

1.程式碼提交到自己的私有倉,重新整理,點選“+ Pull Request”建PR合入程式碼到社群主程式碼倉;

image-20220625110150526

2.進入PR提交介面,可選擇程式碼倉庫分支,和關聯ISSUE ID,簡單描述合入的PR修改等資訊;

image-20220625110210970

3.PR建立成功,首先預設進行DCO檢查,檢查成功,需要手動在評論區輸入回覆”start build”方可進入程式碼的CI靜態檢查和編譯等操作。

image-20220625110230911

五、聯絡committer

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

1. committer文件中找到對應的committer負責人主頁,想辦法聯絡

我是在committer發現負責人,然後微信搜尋,群裡撈到的。

向OpenHarmony社群提交程式碼

image-20220625110507371

我的修改的內容,順便在這貼一下

修改內容

建立visual檔案支援低程式碼開發

  1. 在開啟的JS工程中,選中模組的pages資料夾,單擊滑鼠右鍵,選擇New > JS Visual

img

  1. 在彈出的對話方塊中,輸入JS Visual Name,點選Finish

image-20220625032256509

3.建立JS Visual後,會在工程中自動生成低程式碼的目錄結構,如下圖所示。

zh-cn_image_0000001223558810

  • entry > src > main > js > MainAbility > pages > index > index.js :低程式碼頁面的邏輯描述檔案,定義了頁面裡所用到的所有的邏輯關係,比如資料、事件等。詳情請參考JS語法參考。如果建立了多個低程式碼頁面,則pages目錄下會生成多個頁面資料夾及對應的js檔案。

    icon-note.gif 說明: 使用低程式碼頁面開發時,其關聯js檔案的同級目錄中不能包含hml和css頁面,例如上圖中的 js > MainAbility > pages > index 目錄下不能包含hml與css檔案,否則會出現編譯報錯。

  • entry > src > main > supervisual > MainAbility > pages > index > index.visual :visual檔案儲存低程式碼頁面的資料模型,雙擊該檔案即可開啟低程式碼頁面,進行視覺化開發設計。如果建立了多個低程式碼頁面,則pages目錄下會生成多個頁面資料夾及對應的visual檔案。

  • 開啟“page.visual”檔案,即可進行頁面的視覺化佈局設計與開發。

說明:

  • 使用低程式碼開發介面過程中,如果介面需要使用到其它暫不支援視覺化佈局的控制元件時,可以在低程式碼介面開發完成後,點選img按鈕,將低程式碼介面轉換為hml和css程式碼。注意,程式碼轉換操作會刪除visual檔案及其父目錄,且為不可逆過程,程式碼轉換後不能通過hml/css檔案反向生成visual檔案。
  • 多裝置開發的場景,可以點選介面畫布右上角裝置/模式切換按鈕img,進行裝置切換或模式切換。

image-20220625033408831

使用低程式碼開發完OpenHarmony應用或服務後,如果需要使用模擬器或真機裝置除錯/執行,需要點選img按鈕,將JS Visual檔案轉換為hml和css程式碼後才能執行。

image-20220625111118900

image-20220625111156332

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