項目地址:https://gitee.com/alios-things-admin/AliOS-Things
AliOS Things為開發者在Gitee平臺上提供了貢獻代碼的入口,開發者可以在AliOS Things項目下找到想到修改的倉庫進行代碼提交,具體步驟如下。
查找目標倉庫
AliOS Things 3.3版本在Gitee平臺上,每個功能模塊分配一個獨立的倉庫。 若開發者想對某個組件或案例倉庫貢獻代碼,可以在AliOS Things概覽頁面點擊選項欄中的“倉庫”切換到“倉庫”頁,在搜索欄中輸入目標組件或案例的名稱,確認后即可顯示搜索結果。以目標倉庫為netmgr為例,搜索方式如下圖:
切換分支
打開目標組件或案例的倉庫,切換代碼分支為rel_3.3.0,即可查看到該組件或案例3.3版本對應的源代碼。以目標倉庫為netmgr為例,切換分支方法如下圖。
創建 Fork下載代碼
1、在Gitee 上的目標倉庫里單擊 “fork” 按鈕,將目標倉庫fork一份到開發者自己的名下。以目標倉庫為amp為例,Fork代碼的方法如下圖:
2、進入開發者fork出來的目標倉庫,注意,該倉庫地址已經從AliOS Things/ 變成<YOUR_NAME>/,如下圖所示。然后根據圖中提示的步驟復制倉庫地址。
3、下載代碼 注意:gitee提供多種下載方式,本文使用https,下載代碼時會要求輸入密碼,密碼是開發者的gitee登錄密碼。
# 注意YOUR_NAME替換成開發者Gitee賬號的名稱;TARGET替換為Gitee倉庫名稱
$ git clone https://gitee.com/<YOUR_NAME>/<TARGET>.git
本地開發并提交
本文以提交amp倉庫下的代碼為例子,提供完整開發命令供參考:
# 1、Checkout and switch to your new branch
# 注意TARGET替換為Gitee倉庫名稱
$ cd <TARGET>
$ git checkout rel_3.3.0
# Commit and push your code
git add -A #-A表示將本地所有修改文件提交,若只需要提交若干文件,請將-A替換成文件名
git commit -s #填寫log日志,說明變更的內容,影響功能點等
git push #將本地代碼push到github
在gitee網頁按下圖操作,如果出現你的提交記錄,說明push成功
創建pull request
當功能開發完成后,可以發起 Pull Request,申請合入代碼到AliOS Things/。
在開發者gitee的AliOS-Things倉庫頁面上,然后單擊“ Pull requests ”按鈕發起“+新建 pull request”. 如下圖網頁操作,創建一個pull request
在AliOS Things/ 頁面,看到自己的pull request請求,即說明創建成功,等待審核
同步代碼
在發起 Pull Request 之前,有可能原來的倉庫AliOS Things/有代碼更新,那么請按照以下步驟,拉取AliOS Things/最新的代碼至本地。
# 注意TARGET替換為Gitee倉庫名稱
$ git remote add upstream https://gitee.com/alios-things/<TARGET>.git
$ git remote -v #此時本地有兩個遠程地址,origin和upstream,origin對應fork倉庫,upstream對應<TARGET>倉庫
$ git fetch upstream #將alibaba倉庫代碼更新到本地
$ git checkout rel_3.3.0 #切換到master分支
$ git merge upstream/rel_3.3.0 #合并AliOS Things/<TARGET>的更新至本地
如果merge過程中,代碼有沖突,需要解決所有代碼沖突以后,才能提交。
關注我們
如果你想實時了解Alios-Things的動態,請記得點擊watch持續關注。
點贊我們
如果你喜歡這個項目,就請給我們一個小星星吧